前言¶
DSH 的插件生态里，Web 端的状态提示可以做得更具体。dsh-whale-animation 针对 DeepSeek Harness Web 的 turn status，加入六组原创鲸鱼循环动画，并用一个轻量 animation director 在定时播放和关键词覆盖之间切换。下面介绍它的已核实能力、安装方式和使用注意。
这是什么¶
LeemanCheung/dsh-whale-animation 由 LeemanCheung 维护，采用 MIT 许可证。
它做的事情是为 DSH Web 的 turn status 增加视觉状态：六只原创鲸鱼循环动画，以及一个轻量动画 director。已核实事实中说明其范围是 strictly visual：no accounts, model tools, storage, workspace reads, networking, or user-content processing。
核心能力¶
下面几项是插件已核实提供的能力：
- 六个动画状态：Deep Dive、Sonar、Tool Run、Stream、Calm、Retry。
- 定时播放：每 9 秒轮换一次 playlist。
- 关键词覆盖：当出现可识别的 search、tool、writing、waiting 或 error 文本时，关键词检测会覆盖定时 playlist；包含英文和中文关键词。
- Reduced motion 回退：按状态使用 matching PNG frames；系统启用 reduced motion 时停止 playlist 轮换，并使用 matching PNG frame。
- 主题和视口支持：支持 dark-theme，并在 84 / 72 / 60 px 三档显示尺寸下适配。
- 自包含资源：内置 WebP 和 PNG assets；zero runtime external requests；activation makes no external request。
- 严格视觉范围：不包含账号、模型工具、存储、workspace reads、networking 或用户内容处理。
安装与启用¶
下面命令将固定版本 v0.4.0 安装到 DSH Web profile：
dsh plugin --profile web add github:LeemanCheung/dsh-whale-animation#v0.4.0
如果希望跟随 main branch，可以使用：
dsh plugin --profile web add github:LeemanCheung/dsh-whale-animation
安装后，需要对 DSH Web 执行 hard-refresh。如果当前 profile 已经缓存了 client bundle，重启 DSH。
升级与卸载¶
升级时先移除，再重新安装：
dsh plugin --profile web remove dsh-whale-animation
dsh plugin --profile web add github:LeemanCheung/dsh-whale-animation#v0.4.0
卸载命令为：
dsh plugin --profile web remove dsh-whale-animation
开发与验证依赖¶
开发和验证要求 Node.js 20+。
重新生成动画和文档资产还需要 Python 3 和 Pillow。
package.json 中声明的 peerDependencies 为：
{
"@deepseek-ai/cordis": "^4.0.1",
"@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6"
}
适用场景与注意¶
适合的场景：
- 你希望给 DSH Web 的 turn status 增加更直观的视觉反馈。
- 你希望插件在 reduced motion、dark theme 和不同视口下保持可读。
- 你希望动画资源自包含，运行时不发起外部资源请求。
- 你只需要视觉状态，不引入账号、模型工具、存储、workspace reads、networking 或用户内容处理。
需要注意：
- 插件以当前 dsh 进程权限运行；安装前应检查源码和 MIT 许可证。
- 本文使用的安装命令固定到
v0.4.0；如需跟随 main branch，使用不带#v0.4.0的安装命令。 - Reduced motion 下，插件会停止 playlist 轮换，并使用 matching PNG frame。
- 运行时资产请求为零，activation 不发起外部请求。
链接与目录¶
GitHub 仓库：
https://github.com/LeemanCheung/dsh-whale-animation
社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，不应理解为官方应用商店。目录页入口可以从仓库 README 中的社区目录徽章进入；本文不在此列出未经验证的目录页 URL。
