dsh-whale-pet：住在 DeepSeek Harness Web UI 里的蓝鲸宠物

它是做什么的？

Whale pet 是 DeepSeek Harness（DSH）的桌面宠物插件，在 Web UI 右下角养一只会动的 DeepSeek 蓝鲸。它解决的是「Agent 在后台跑、用户不知道进度」的问题：鲸鱼用动效和音效实时反映 Harness 是否在工作、正在处理哪个会话，点开还能看到本会话的 token 与花费。插件由 yzmin 维护，纯 JavaScript 实现，无运行时依赖、无构建步骤。

核心功能

• 状态动效：空闲时轻轻浮动，工作时游动加快、气泡上升、光环脉动、外圈转动，一眼看出 DSH 是否在忙。
• 完成音效：任务完成播放音频文件，失败播放该音色的下行合成版本，开始工作时轻响一声；资源缺失或无法解码时自动回退到合成音效。
• 用量与花费面板：点击鲸鱼展开，显示本会话 token 分解（缓存命中、未命中、缓存写入、输出）、按官方费率折算的金额、会话时长与账户余额。
• 交互明细：每条记录含提示词、回复摘要、工具、轮次、步骤计数、耗时与费用。
• 音色可选：面板下拉框提供明亮铃音、柔和木琴、木质马林巴、轻点提示、长尾钟声五种音色，完成音可走音频文件或实时合成。
• 主题自适应：面板样式只使用主题 token，自动适配明暗主题。

怎么使用这个插件？

在 DSH 的 Web 组合中启用后，鲸鱼会出现在界面右下角，无需额外操作即可看到工作状态。点击鲸鱼展开面板，查看本会话的 token 分解、费用、时长与逐条交互记录；想换完成音，直接替换插件资源目录里的音频文件并重启 DSH，或在面板下拉框里切换音色。修改界面脚本后刷新页面即可生效，修改主机端脚本则需要重启 DSH。

报错怎么排查？

鲸鱼不显示或面板没有数据时，先确认当前 profile 提供了 webServer，否则面板拿不到数据；再确认 bundle 已启用、槽位占用者处于激活状态。账户余额一行为空通常是环境里没有可选的账户能力，其余功能不受影响。替换音效后没有变化，多半是资源格式或扩展名与代码里的常量不一致，按官方说明修复并重启 DSH。