Skip to content
  • Home
  • Plugin manual
  • dsh-ui-whale

lhh010/dsh-ui-whale

300Last commit Aug 13, 2026

dsh-ui-whale DSH plugin

DSH UI Whale adds a small pixel whale to the right side of the DSH Web UI conversation title bar. The whale idles with blinking, tail wagging, and fin movements; falls asleep after 10 seconds of inactivity; wags tail and fins during thinking/running; celebrates with a water spout on completion; and shows a heart when clicked. It uses pure CSS box-shadow pixel art and a tick-based state machine, with no model or tool schema changes.

ui-productivity

How to install the dsh-ui-whale DSH plugin

dsh plugin --profile web add link:/path/to/dsh-ui-whale

Copying does not run this command. Review the repository and version before installing the dsh-ui-whale DSH plugin.

dsh-ui-whale DSH plugin data source

dsh-ui-whale DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-ui-whale DSH plugin can do

  • Idle animations: blinking, tail wagging, fin movements at fixed intervals
  • Sleep animation: enters sleep after 10 seconds of continuous idle, with floating Z letters
  • Thinking/running animation: continuous tail and fin movements, more frequent blinking
  • Celebration: water spout animation on session completion
  • Click interaction: heart animation from small to large and disappear
  • Pure CSS box-shadow rendering, no canvas or image assets in runtime

Where the dsh-ui-whale DSH plugin fits

  • Add a cute visual companion to DSH Web UI while waiting for model responses
  • Provide visual feedback for session state (idle, thinking, running, completed)
  • Enhance user engagement with a non-intrusive pixel art character
  • Serve as a demo or example of DSH client plugin development with inject slots

Who the dsh-ui-whale DSH plugin is for

  • DSH Web UI users who want a playful companion
  • Plugin developers looking for a reference implementation of DSH client UI plugins

dsh-ui-whale DSH plugin limitations

  • Only works in DSH Web UI (not terminal or other frontends)
  • Requires DSH snapshot 0806 or later (specific versions listed in README)
  • No effect on model behavior, prompt, or tool schemas (purely cosmetic)
  • Animation is CSS-only, may not be accessible to screen readers

dsh-ui-whale DSH plugin: from the repository README

Quoted from the lhh010/dsh-ui-whale README, the upstream source of the dsh-ui-whale DSH plugin. Copyright remains with the original authors.

**简体中文** | [English](./README.en.md) DSH Web UI 的常驻像素鲸鱼伙伴插件：会话标题栏（标题行右侧）常驻一只小鲸鱼，随会话快照实时反应——**零核心改动**。 ## 版本对应 / Version compatibility 构建产物随 DSH 快照版本更新，安装时按快照选择对应版本： | 插件版本 | DSH 快照 | 说明 | | --- | --- | --- | | `v0.1.0` | `snapshots/20260805T134133Z`（snapshot0805） | 旧构建，按旧安装方式（`~/.dsh/config.yaml` + `pnpm add -w link:`） | | `v0.2.0` | `snapshots/20260806T160212Z`（snapshot0806） | 0806 新构建，按新安装方式 | | `v0.3.0` | `snapshots/20260806T160212Z`（snapshot0806） | 0806 构建 + 睡觉动画（连续空闲 10 s 入睡） | | `v0.3.1` | `snapshots/20260806T160212Z`（snapshot0806） | 睡觉 Z 改 5 帧循环 `0-1-2-3-4-5-1-…`；尾巴加一帧改 `0-1-2-3-4-3-2-1-0` | | `v0.3.2` | `snapshots/20260806T160212Z`（snapshot0806） | 修正睡觉 Z 浮动轨迹（重新定位 睡觉2~5 的 Z 位置） | | `v0.3.3`（默认） | `snapshots/20260810T155924Z`（snapshot0810） | 兼容性构建：客户端插件元数据从顶层 `dshClient` 迁移为嵌套 `dsh.client`（0810 的 ClientModuleHostService 只读该字段；顶层 `dshClient` 被静默忽略），inject/platform 原样保留 | > **兼容性说明**：上表构建均基于 snapshot0806 开发，同时兼容 snapshot0807（`snapshots/20260807T130646Z`）、snapshot0808（`snapshots/20260808T121140Z`）、snapshot0809（`snapshots/20260809T140917Z`）、snapshot0810（`snapshots/20260810T155924Z`）、snapshot0811（`snapshots/20260811T152241Z`）与最终快照 snapshot0812（`snapshots/20260812T172954Z-fin

Read the full READMERepository license: BSD-3-Clause

dsh-ui-whale DSH plugin questions

How do I install the DSH UI Whale plugin?

You can install it via the official profile channel: clone the repo, run `pnpm install`, then `dsh plugin --profile web add link:/path/to/dsh-ui-whale`. Alternatively, if you have plugin-registry enabled, use `dsh registry install /path/to/dsh-ui-whale` and `dsh registry enable @dsh-external/dsh-ui-whale`. See INSTALL.md for details.

What DSH versions does this plugin support?

The plugin supports DSH snapshots from 0806 to 0812 (final snapshot) and npm releases `@deepseek-ai/dsh@0.0.1-rc.2` and `@deepseek-ai/dsh@0.0.1-rc.5`. Always use the latest plugin version (v0.3.3) for snapshot 0807 and later. For older snapshots, refer to the version compatibility table in README.

Does the whale plugin affect model performance or token usage?

No. It is purely a client-side UI plugin that runs in the browser. It does not modify model requests, prompt content, or tool schemas. It has zero impact on model behavior or token consumption.

Can I use this plugin in terminal mode?

No. The plugin is designed for DSH Web UI only. It uses the `conversation.session.header.actions` slot in the web frontend and does not work in terminal or other frontends.

How do I build the plugin after modifying the source?

Run `pnpm build` to compile with tsdown. You must rebuild after changing source code or upgrading DSH snapshot, otherwise the browser may load an old `lib/client.js` and the plugin may fail to load.