前言¶
DSH（DeepSeek Harness）在 Web GUI 的「思考中」状态行左侧展示了一只小鲸鱼尾巴，用来表示模型正在生成内容。官方实现是一条简洁的线条，功能正确但视觉变化较少。对于需要更明显状态反馈的开发者来说，可以在不改动 DSH 核心逻辑的前提下，通过插件替换这只尾巴的动画。
dsh-whale-tail 是一个覆盖式插件，通过 CSS 选中官方的 span.runningIcon，将其隐藏并重绘，把原本的单帧图标替换为四段循环动画。
这是什么¶
dsh-whale-tail 是一个面向 DSH Desktop 的插件，由维护者 null-dat 开发，归类为「趣味换装」。它不改变 DSH 的核心行为，只是替换 Web GUI 中「思考中」状态行的鲸鱼尾巴动画，提供四种不同的视觉状态，每段动画帧数和循环时长各不相同。
插件的核心价值在于：在不侵入 DSH 源码的前提下，为思考状态行提供更丰富的视觉反馈，适合需要在界面中强调「正在生成」这一过程的场景。
核心功能¶
- 四段动画状态：提供
init、v1、v2、v4四种动画，每种的帧数与循环时长不同（见下表）。 - 颜色与尺寸：显示尺寸 18px，颜色使用
currentColor，默认为品牌蓝#4D6BFE，深色主题下自动跟随。 - 无外部请求：动画帧以 base64 内联在
lib/client.js，不会发起网络请求。 - 覆盖式实现：使用 CSS 选中官方
span.runningIcon，将其透明度设为 0，再通过::after画出自己的遮罩动画。 - 静默降级：如果 DSH 更新导致官方 DOM 结构改变，插件会静默失效，表现是尾巴变回官方线条，不会崩溃或白屏。
| 状态 | 帧数 | 循环时长 | 说明 |
|---|---|---|---|
init |
26 | 1092ms | 旋转 + 残影（14 帧前摆 → 12 帧回摆） |
v1 |
23 | 958ms | 形变 + 拖尾最重 |
v2 |
29 | 1208ms | 摆幅最大 |
v4 |
32 | 1333ms | 闭环最干净 |
安装与启用¶
安装命令（从官方仓库）：
dsh plugin add dsh-whale-tail
或直接从 GitHub 安装：
dsh plugin add github:null-dat/dsh-whale-tail
安装后刷新页面即可生效。DSH Desktop 的插件随页面加载，无需重启客户端。
典型用法¶
默认情况下，每个思考状态行会依次切换到四种动画状态。如需固定某一态，可在 <html> 标签上添加 data-dsh-tail-pick 属性：
<html data-dsh-tail-pick="v4">
<!-- DSH 界面内容 -->
</html>
可选值包括 init、v1、v2、v4。
适用场景与注意¶
- 适合需要更明显「思考中」视觉反馈的场景，如长时间生成、需要强调模型正在工作的界面。
- 插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证（代码为 MIT，素材未单独授权）。
- 这是一个覆盖式插件，若 DSH 更新导致官方 DOM 结构改变，动画会静默失效，表现为恢复官方线条，不会出现崩溃或白屏。
小结¶
dsh-whale-tail 通过覆盖官方鲸鱼尾巴的动画，为 DSH 的思考状态行增加了四种不同风格的视觉效果，且不依赖外部资源。对于希望在不改动 DSH 核心逻辑的前提下丰富界面反馈的开发者，这是一个可用的轻量级方案。
- 目录页：https://www.skillhub.cn/plugins/null-dat/dsh-whale-tail
- GitHub：https://github.com/null-dat/dsh-whale-tail
