DSH plugin 余额鲸鱼挂件怎么装？DeepSeek Harness 余额与用量实时显示配置

DSH plugin 余额鲸鱼挂件（中文也常写作 DSH插件、DeepSeek插件），指的就是社区插件 DeepSeek Balance Whale Widget：它挂在 DeepSeek Harness Web 界面右下角，实时显示 DeepSeek 账户余额、今日已用与每轮对话消耗（来源）。 它是标准 DSH plugin bundle 插件，用 dsh plugin 即可安装，不需要额外会话令牌。下面从五个方向讲全：① 面板到底显示什么；② 怎么装、选哪个 profile、注意哪些坑；③ 余额数据从哪来；④ 装完不显示余额怎么自查；⑤ 它和成本用量类插件怎么分工。想找余额 / 用量同类插件，可以在 DSH Plugin Hub 的市场里筛选。

DSH plugin 余额鲸鱼挂件是干什么的

余额鲸鱼挂件是一个常驻在界面右下角的小鲸鱼面板，把「账户余额、今日已用、每轮消耗」三件事摆在你随时能看到的位置（来源）。 它具体做三件事：

1. 显示余额：每 60 秒自动刷新，点鲸鱼可手动刷新；余额变化时数字带滚动动画。
2. 记账今日已用：按余额观测累计当日消费，不需要额外令牌；充值或赠金导致的余额上升会单独记录。
3. 提示每轮消耗：监听本机会话事件，按模型真实 usage 换算金额，每轮结束弹出消耗提示（可关闭、可自定义内容）。

它随 Web 界面每次打开自动出现，属于「看钱」的展示面板，不是需要你主动打开的工具。

面板上的三块信息分别是什么

把挂件显示的内容拆开看，每一块的来源和用途都不一样：

关键区别在于「账户余额」是从接口取的实时数据，而「今日已用」和「每轮消耗」是本地记账推出来的——这也是为什么余额准确、而消费统计可能因为充值、赠金或多设备使用而出现对不上。理解这点，后面「数字对不上」的问题就不会让你误判成故障。

DSH plugin 怎么装：安装命令、profile 与避坑点

安装余额鲸鱼挂件用 dsh plugin --profile web add dsh-whale-widget，profile 选 web（来源）。 按顺序做三步：

1. 选来源，二选一别混用。推荐装 npm 已发布版：dsh plugin --profile web add dsh-whale-widget；也可以从仓库直装：dsh plugin --profile web add github:MeteorNOX/DeepSeek-Balance-Whale-Widget，但那样装的是仓库当前状态、不跟随已发布版本。预期：执行 dsh plugin --profile web list，输出里能看到 dsh-whale-widget。
2. 避免并存冲突。npm 名与 github: 指向同一个包，先后安装会并存冲突；若已用 github: 装过，要换 npm 名请先 dsh plugin --profile web remove dsh-whale-widget。预期：list 里该插件只出现一次，没有 npm 名与 github: 两条并存。
3. 确认 profile 正确。它挂在 Web 界面，所以用 --profile web；官方桌面端读的是 desktop profile，且 CLI 拒绝 --profile desktop，桌面端请改用别的方式安装。预期：--profile web 下已装可见，而 --profile desktop 会被 CLI 直接拒绝。

装完的校验可以合成两行：

dsh plugin --profile web list
# 应看到 dsh-whale-widget 出现在已安装列表里，且只出现一次

grep -A5 bundles "$DSH_HOME/profiles/web/package.json"
# 应看到该插件出现在 dsh.profile.bundles 里，说明不只是装进了 node_modules，而是真的会加载

预期：两条都命中，说明安装与加载都到位；只命中第一条，说明装上了但没进加载列表。

余额数据从哪来：两种取数方式

余额数据从哪来：优先用 DeepSeek Harness 凭据里的 DEEPSEEK_API_KEY；如果登录了 DeepSeek 账号又没配 key，则自动使用 DeepSeek Harness 账号登录态，通常不需要你额外配置。装完后不必再建 key，挂件会自己取数。

两种方式你都不需要手动切换：有 key 用 key，没 key 用登录态。 需要留意的只有一点——如果你既没配 key 也没登录账号，挂件自然就没有可用的取数身份，这时它显示不出余额是正常结果，而不是 bug。

DSH plugin 装完不显示余额怎么自查

装完不显示余额，按「凭证 → 网络 → 刷新」三步自查即可（来源）。 自查步骤：

1. 查凭证：确认 DeepSeek Harness 凭据里的 DEEPSEEK_API_KEY 可用，或已登录 DeepSeek 账号且余额条目能看到数据。预期：余额条目能看到数字，而不是「未登录 / 无权限」。
2. 查网络：确认当前环境能访问 DeepSeek 接口；瞬时网络抖动时挂件会沿用最近一次余额而不报错，所以「短暂没更新」通常正常。预期：接口可达；不通时控制台会留下网络错误。
3. 手动刷新：点一下鲸鱼触发手动刷新，观察数字是否更新；仍无数据再回到前两步。预期：数字随刷新更新，说明取数链路通。

第三步之后如果仍然没有数字，回到安装环节重新核对 profile——「装到了别的 profile」是这一步最常见的漏网原因。

它和成本用量类 DSH plugin 有什么区别

和成本用量类插件的区别：余额鲸鱼挂件偏「看钱」的展示，重点是账户余额与今日已用；成本用量类插件偏「算钱」的统计，重点是按会话或模型给出 token 成本明细。 想同时盯余额与成本，可以两类各装一个。

一句话分工：想知道「钱还剩多少」装挂件，想知道「钱花在哪」再加成本计量插件。

关于 DSH plugin 余额鲸鱼挂件的常见误解

下面是搜索与讨论里最常出现的误解，逐条对照一遍：

1. 「装完不显示余额是插件坏了」——多数不是。 先按凭证、网络、刷新三步查，再查 profile。
2. 「必须自己配 API key」——不必。 没配 key 时会退回 DeepSeek Harness 账号登录态。
3. 「余额和今日已用一定对得上」——可能对不上。 余额取接口、消费靠本地记账，充值或多设备会带来差异。
4. 「npm 名和 github: 可以都装」——不要。 同一个包装两次会并存冲突，只留一个。
5. 「桌面端照 Web 命令装就行」——不行。 CLI 拒绝 --profile desktop，桌面端要另走一路。

关于 DSH plugin 余额鲸鱼挂件的注意事项

把它当「只看余额」的常驻面板，用对 profile 与来源，基本不会有坑。

1. 用 web profile：它挂 Web 界面，安装走 --profile web。
2. 来源二选一：npm 名与 github: 是同一个包，别先后混装。
3. 不用额外令牌：余额取数靠 DeepSeek Harness 凭据或账号登录态。
4. 不更新未必是故障：网络抖动时它会沿用最近余额而不报错。
5. 装完看两处：list 里有名字、bundles 里有条目，才算真的会加载。
6. 桌面端另走一路：CLI 拒绝 --profile desktop，桌面端别照搬 Web 命令。
7. 区分口径：它显示余额，成本明细要靠成本用量类插件。
8. 找同类插件见 DSH Plugin Hub，容易混的鲸鱼宠物挂件见《鲸鱼宠物挂件怎么装》。

来源：社区插件仓库 - DeepSeek Balance Whale Widget、DeepSeek Harness CLI 官方 README。