一个原生 dsh bundle 插件，在 dsh Web 界面以可拖拽小鲸鱼挂件显示实时 DeepSeek API 余额、今日已用与每轮消耗。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-08-22
许可证
MIT
01它能帮你完成什么？
在 dsh Web 界面里随时关注你的 DeepSeek API 余额与消耗
dsh Web 界面右下角的常驻小鲸鱼挂件，显示实时 DeepSeek API 余额（每 60 秒自动刷新 + 点击鲸鱼手动刷新，带数字滚动动画）、今日已用与每轮对话后的消耗，并支持拖拽 / 四边吸附与趣味动画
希望在 dsh Web 界面工作时始终看到余额 / 消耗读数的 DeepSeek API 用户
无需额外令牌也能跟踪今日消耗
默认的「小鲸鱼记账」模式完全用本地余额差值记账今日消耗（无需平台令牌）；可选的「实时·令牌」模式用平台会话令牌按每小时峰谷定价换算实时用量
希望用最小配置获得每轮与每日 DeepSeek 消耗可见性的成本敏感用户
02如何接入 DeepSeek Harness？
前置条件
- 已启用 Web 界面（`dsh web`）及 Web 配置的 DeepSeek Harness
- 在 dsh 凭据中配置 `DEEPSEEK_API_KEY`（拉取余额必需）
安装步骤
- 01
从 npm 安装：`dsh plugin --profile web add dsh-whale-widget`（本地克隆则在该仓库根目录执行 `dsh plugin --profile web add link:.`，不要用 `link:.<子目录>`）
$ dsh plugin --profile web add dsh-whale-widget
- 02
重启 `dsh web`，然后在浏览器中按 F5
$ dsh web
- 03
（可选）若尚未配置，请在 dsh 凭据中设置 `DEEPSEEK_API_KEY`；挂件会自动出现在右下角
验证接入成功
- 运行 `dsh --profile web --dump-config`，确认 `dsh-whale-widget` 列在 bundles 下
- curl `http://127.0.0.1:3080/dsh-whale/balance.json` 应返回 200 且含 `totalBalance`；F5 后右下角应出现鲸鱼挂件
回滚
- 卸载：`dsh plugin --profile web remove dsh-whale-widget`
03DSH 适配与能力边界
原生 DeepSeek Harness（dsh）bundle 插件 `dsh-whale-widget`。它在 dsh Web 界面右下角挂载一个常驻的小鲸鱼挂件，显示 DeepSeek API 余额、今日已用与每轮对话消耗，每次打开界面自动启用。通过 `dsh plugin` 安装 / 卸载。
实时余额挂件
dsh Web 界面（右下角）→显示 DeepSeek API 余额，每 60 秒自动刷新 + 点击手动刷新，余额变化有数字滚动动画，瞬时网络抖动自动沿用最近余额不报错
今日已用（两种模式）
观测到的余额下降，或（可选）DeepSeek 平台用量接口→今日消耗：默认「小鲸鱼记账」（本地余额差值记账，无需令牌），或可选「实时·令牌」模式（平台用量接口 + 内置峰谷每小时定价）
每轮对话消耗
本机 dsh 会话事件（turn 结束）→每轮对话结束后弹出该轮精确 usage 金额（真实模型 usage，非估算）——无需平台令牌
挂件交互与趣味效果
对挂件的鼠标 / 菜单交互→拖拽 + 四边四分之一吸附（左吸附整体水平镜像翻转）、按压 Q 弹玩偶效果、汉堡菜单（大小 0.6–2.5 倍、音效切换、用量模式、气泡开关、自动关闭秒数）、可选音效（缺失 mp3 时静默降级）与随机台词
04适合谁？何时不该用？
适合
- 希望在 dsh Web 界面工作时始终看到余额 / 消耗读数的 DeepSeek API 用户
- 希望用最小配置获得每轮与每日 DeepSeek 消耗可见性的成本敏感用户
不适合
- `DEEPSEEK_API_KEY` 必需（用于从 api.deepseek.com/user/balance 拉取余额）。`DEEPSEEK_PLATFORM_TOKEN` 可选——它是 DeepSeek 平台网页会话令牌（不是 `sk-` 开头的 API key），仅在登录平台网页时有效，且只用于实时·令牌用量模式；重新登录后可能需要重新获取。
05兼容性、维护与安全提示
- 原生 dsh bundle 插件：需要 DeepSeek Harness 的 Web 界面（`dsh web`）及 Web 配置。用 `dsh plugin --profile web add dsh-whale-widget`（或仓库根目录 `link:.`）安装，然后重启 `dsh web` 并刷新浏览器。仅在 dsh Web 界面内渲染。
- `DEEPSEEK_API_KEY` 必需（用于从 api.deepseek.com/user/balance 拉取余额）。`DEEPSEEK_PLATFORM_TOKEN` 可选——它是 DeepSeek 平台网页会话令牌（不是 `sk-` 开头的 API key），仅在登录平台网页时有效，且只用于实时·令牌用量模式；重新登录后可能需要重新获取。
- 默认的「小鲸鱼记账」模式把每日记账保存在本机 `$DSH_HOME/.dshw-usage.json`（保留 30 天），无需平台令牌。实时·令牌模式会用可选的会话令牌向 DeepSeek 平台用量接口发起请求。
MIT · 活跃维护中（最新版本 v0.2.7，2026-08-22）
06常见问题
怎么安装小鲸鱼挂件？
在 Web 配置中运行 `dsh plugin --profile web add dsh-whale-widget`（npm），然后重启 `dsh web` 并按 F5。若你克隆了仓库，请在仓库根目录用 `dsh plugin --profile web add link:.`（不要用 `link:.<子目录>` 路径）。挂件随后会自动出现在右下角。
它需要什么凭据？
只需 `DEEPSEEK_API_KEY`——用于拉取余额。`DEEPSEEK_PLATFORM_TOKEN` 可选，仅实时·令牌用量模式需要；默认的「小鲸鱼记账」模式有 API key 即可工作。
今日已用是怎么算出来的？
默认「小鲸鱼记账」模式下，鲸鱼用观测到的余额下降在本地累计今日消耗（无需令牌）。可选的「实时·令牌」模式调用 DeepSeek 平台用量接口，并按内置峰谷每小时定价表换算成金额。
会显示每轮消耗吗？
会。它监听本机 dsh 会话事件，每轮对话结束后弹出该轮精确 usage 金额——使用真实模型 usage 而非估算，且不需要任何平台令牌。
怎么验证它是否生效，又怎么卸载？
验证：`dsh --profile web --dump-config` 应在 bundles 下列出 `dsh-whale-widget`；`curl http://127.0.0.1:3080/dsh-whale/balance.json` 返回 200 且含 `totalBalance`；F5 后右下角出现鲸鱼。卸载：`dsh plugin --profile web remove dsh-whale-widget`。
07相关的 DSH 工作流
dsh-web
作者 zhu1090093659
DeepSeek Harness（dsh）插件聚合生态，万物皆插件，通过创意工坊分发。
petdex
作者 crafter-station
面向 Codex、Claude Code、DeepSeek Harness 等智能体的动效宠物公共图库。
j-space-cognition-suite-v3.7
作者 tiger3807861189
J-Space Cognition Suite V3.7 - AI cognitive-enhancement Skills based on Anthropic's J-space global workspace research. | 哔哩哔哩：Tiger380 (UID 3494375382321675) — https://space.bilibili.com/3494375382321675
dsh-deep-whale
作者 small-tailqwq
Whale Girl skin series for DeepSeek Harness. 适用于 DeepSeek Harness 的，鲸鱼娘系列皮肤。
08数据与来源
DeepSeek Harness（DSH）Web 界面右下角的常驻余额挂件：小鲸鱼气泡图 + DeepSeek API 余额 + 今日已用 + 每轮对话消耗统计，每次打开界面自动启用。
本项目是标准 DSH 插件包，可通过 `dsh plugin` 安装/卸载。
dsh plugin --profile web add dsh-whale-widget
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-08-22。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。