前言¶
在使用 DeepSeek Harness (DSH) 时，开发者需要持续关注 Token 消耗、任务状态和余额变动。若工具仅提供后台数据而缺乏直观反馈，容易造成信息遗漏。dsh-whale-pet 插件将浏览器悬浮球与 Windows 置顶桌面宠结合，提供双形态的陪伴体验，将余额、任务和消耗数据集中展示，并具备互动与通知功能。
插件简介¶
插件名称为 dsh-whale-pet，由用户 dleaf6211-hash 维护。它为 DSH 提供一个陪伴型桌宠，包含浏览器右下角的悬浮鲸鱼娘和 Windows 置顶桌面宠两种形态，两者共享同一份数据。所有数据仅存本机，语音与立绘随包内置，无任何遥测上报。
安装与启用¶
使用 npm 预构建包安装，命令如下：
dsh plugin --profile web add dsh-whale-pet-plugin
安装后需重启 Harness 或对应 profile，浏览器右下角会出现鲸鱼娘。桌面宠默认不自动拉起，需在浏览器木牌点击「拉起桌宠」按钮，或在设置中开启「自动拉起桌面宠」选项。
核心功能¶
- 余额与用量木牌：显示 DeepSeek 实时余额、会话消耗、本月消耗及消耗差值，支持一键刷新。木牌可切换查看 Token 用量视图（调用/输入/输出/缓存）。
- 任务通知：会话、子任务、工作流或后台任务完成、失败、等待审批或需协助时，木牌弹通知并触发语音播报。完成通知包含本次任务的真实成本。
- 摸头互动：鼠标悬停在鲸鱼娘头部约 0.7 秒，会触发害羞贴纸、爱心和摸头台词。
- 台词与语音：内置 19 句带情感台词，预合成语音随包分发，离线可用，无需调用 TTS 服务。
- Windows 桌面宠：置顶 WPF 小窗，与浏览器宠同步台词与通知。点击桌面宠右上角眼睛图标可进入透明模式（鼠标穿透），悬停眼睛再点可退出。
- 免打扰与低余额：可设置静音时段，仅静音不消失，但审批与「需要协助」提醒不受影响。余额低于 5 元时会弹提醒。
- 设置面板：提供随机台词开关、语音开关、宠物大小、自动拉起、低余额提醒、免打扰时段等配置项。
典型用法¶
- 切换视图：点击木牌上的「看用量」或「看余额」切换显示内容。
- 刷新数据：点击木牌「刷新」立即拉取最新余额。
- 输入框互动：在 DSH 的任意输入框中输入内容，鲸鱼娘会自动冒出台词。
- 透明模式：在桌面宠右上角点击眼睛图标进入透明模式（鼠标穿透），悬停眼睛再点击即可退出。
注意事项¶
- 系统要求：浏览器宠支持任意系统；Windows 桌面宠基于 PowerShell + WPF 开发，仅支持 Windows。
- 升级报错：升级插件时若桌宠进程锁着插件目录，会报
EPERM rename错误。需先完全退出桌面宠和 DSH，再执行升级命令。 - 隐私：所有数据仅存本机，无任何遥测上报。
参考资源¶
- GitHub 仓库：https://github.com/dleaf6211-hash/dsh-whale-pet
- 插件目录：https://www.skillhub.cn/plugins/dleaf6211-hash/dsh-whale-pet
