跳到正文
  • 首页
  • 插件说明
  • dsh-ui-whale

lhh010/dsh-ui-whale

300最近提交 2026年8月13日

dsh-ui-whale DSH 插件

DSH UI Whale 在 DSH Web UI 的会话标题栏右侧添加一只像素鲸鱼伙伴。鲸鱼空闲时会眨眼、摆尾、动鳍；连续空闲10秒后入睡；思考/运行时尾巴和鳍持续摆动，眨眼更频繁；回合完成时喷水庆祝；点击鲸鱼会冒爱心。动画基于纯 CSS box-shadow 像素画和 tick 状态机，不修改模型或工具 schema。

ui-productivity

如何安装 dsh-ui-whale DSH 插件

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

复制不会执行命令。安装 dsh-ui-whale DSH 插件前请核对仓库和版本。

dsh-ui-whale DSH 插件数据来源

dsh-ui-whale DSH 插件快照日期：2026年8月16日

discovered

dsh-ui-whale DSH 插件能做什么

  • 空闲动画：眨眼、摆尾、动鳍，按固定间隔触发
  • 睡觉动画：连续空闲10秒后入睡，头顶灰色Z循环浮动
  • 思考/运行动画：尾巴和鳍持续摆动，眨眼更频繁
  • 庆祝动画：回合完成时头顶喷水花，单向散开
  • 点击互动：点击鲸鱼冒爱心，从小变大再消失
  • 纯 CSS box-shadow 渲染，无需 canvas 或运行时图片资源

dsh-ui-whale DSH 插件适合哪些场景

  • 在等待模型响应时为 DSH Web UI 增加可爱的视觉伙伴
  • 通过鲸鱼动画直观反映会话状态（空闲、思考、运行、完成）
  • 以非侵入的像素画角色提升用户参与感
  • 作为 DSH 客户端插件开发参考示例，演示 inject 槽位使用

dsh-ui-whale DSH 插件适合谁

  • 希望为 DSH Web UI 增加趣味性的用户
  • 想了解 DSH 客户端 UI 插件开发的开发者

dsh-ui-whale DSH 插件的限制

  • 仅适用于 DSH Web UI，不支持终端或其他前端
  • 需要 DSH 快照 0806 或更高版本（具体版本见 README）
  • 纯装饰，不影响模型行为、提示词或工具 schema
  • 动画基于 CSS，可能对屏幕阅读器不友好

dsh-ui-whale DSH 插件的仓库 README 摘录

以下文字摘自 dsh-ui-whale DSH 插件的上游仓库 lhh010/dsh-ui-whale 的 README，版权归原作者，仅作引用。

**简体中文** | [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

阅读完整 README仓库许可: BSD-3-Clause

dsh-ui-whale DSH 插件常见问题

如何安装 DSH UI Whale 插件？

克隆仓库后运行 `pnpm install`，然后使用 `dsh plugin --profile web add link:/path/to/dsh-ui-whale` 添加。如果开启了 plugin-registry，也可以用 `dsh registry install /path/to/dsh-ui-whale` 和 `dsh registry enable @dsh-external/dsh-ui-whale`。详细步骤见 INSTALL.md。

这个插件支持哪些 DSH 版本？

支持 DSH 快照 0806 到 0812（最终快照）以及 npm 发布版 `@deepseek-ai/dsh@0.0.1-rc.2` 和 `@deepseek-ai/dsh@0.0.1-rc.5`。对于 0807 及之后的快照，请使用插件最新版本 v0.3.3。旧版本请参考 README 中的版本兼容表。

鲸鱼插件会影响模型性能或 token 消耗吗？

不会。它完全是一个浏览器端 UI 插件，不修改模型请求、提示词内容或工具 schema。对模型行为和 token 消耗零影响。

我可以在终端模式下使用这个插件吗？

不可以。该插件仅适用于 DSH Web UI，它使用 `conversation.session.header.actions` 槽位，在终端或其他前端中无法工作。

修改源码后如何构建？

运行 `pnpm build` 使用 tsdown 编译。修改源码或升级 DSH 快照后必须重新构建，否则浏览器可能加载旧的 `lib/client.js` 导致插件加载失败。