DeepSeek Harness (DSH) 采用插件化架构，扩展能力主要集中在 Web 界面。dsh-whale-widget-plus 是一款位于 DSH Web 界面右下角的挂件插件，由用户 louke6572 维护。它通过四套表情素材和情绪动画，将 DeepSeek 余额与火山引擎 Coding Plan 用量监控融入日常交互中。
核心功能¶
这款插件主要包含以下能力：
- 四表情版本切换：支持 v1-v4 四套素材，每套包含 18-33 张图片。支持 localStorage 记忆，刷新页面后保持选择。
- 双数据模式：支持火山引擎 Coding Plan 用量查询和 DeepSeek 官方余额查询。支持多账号轮询。
- 情绪动画：连点触发生气，悬停触发害羞，长时间无交互触发失落，配额≥90% 触发疲惫。
- 台词系统：内置 6 组随机台词，支持自定义增删改，支持手动固定选择。表情与台词分离。
- 可调参数：大小、气泡颜色、眨眼频率、音效、手动锁定。
- 桌面版支持：支持 dsh >= 0.1.7-rc.2 的桌面版，通过
dsh.client模块挂载。
安装与启用¶
安装过程分为本体挂件和火山数据源两部分。
- 安装本体
dsh plugin --profile web add link:C:\path\to\dsh-whale-widget-plus
- 安装火山数据源（可选，火山模式必需）
dsh plugin --profile web add link:C:\path\to\dsh-whale-widget-plus\plugins\volc-usage
-
配置凭证
在DSH_HOME（默认~/.dsh）目录下的.credentials.yaml中配置火山凭证。 -
刷新页面
重启 dsh web，浏览器 Ctrl+F5 强刷即可看到小鲸鱼。
实现与安全¶
- 安全机制：凭证永不进前端，所有 API Key / AccessKey 只在 Node 端使用，前端仅拿到归一化后的百分比或金额。
- Web 模式挂载：通过
webServer.tapIndex注入。 - 桌面版挂载：桌面版界面不走 HTTP 页面注入，插件通过 package.json 的
dsh.client客户端模块声明，在客户端启动时自动挂载。
这款插件通过本地存储和同源数据获取，在不暴露 API Key 的情况下实现了数据的可视化。适合希望在开发或使用 DSH Web 界面时，直观监控 DeepSeek 余额与用量的用户。
