DSH 小鲸鱼挂件：实时查看 DeepSeek 余额

DeepSeek-Balance-Whale-Widget 是做什么的？

DeepSeek-Balance-Whale-Widget 在 DeepSeek Harness 网页界面的右下角放一只小鲸鱼，用来显示 DeepSeek API 余额、今天花了多少钱，以及每一轮对话的消耗。

余额每 60 秒自动刷新一次，点一下鲸鱼也能手动刷新。花费是在本机算出来的：余额下降记为消费，充值和赠金单独记录，不会把之前的消费冲掉。每轮对话的金额取自 DSH 会话事件里的 token 用量（输入、缓存、输出、推理），并按 DeepSeek 的峰谷价格换算。

记账之外，这个项目的大部分篇幅都花在自定义上。泡泡由若干模块拼成，排版自己定；角色图片、音效、吸附方式也都能在挂件菜单里更换。

核心功能

• 余额显示：通过 DEEPSEEK_API_KEY 凭据或 DSH 账号登录态读取余额。
• 用量记录：记录窗口可查看今日、近 7 天和全部消费，带模型占比条，支持按日期或模型名搜索。
• 模块化泡泡：一个泡泡最多 6 行，可放文本、链接、随机语句、图片，以及余额、峰谷时段等内置数值。
• 提醒与音效：可选的余额预警和今日预算提醒；一轮回复结束、DSH 等你回答或授权时可以播放提示音。
• 其他厂商：34 个模板覆盖 OpenRouter、Moonshot 等厂商的余额或额度查询，没有余额接口的厂商则给出估算消费。
• 拖拽吸附：鲸鱼可以拖动，吸附区域可调，贴到左侧时会水平翻转。

怎么使用 DeepSeek-Balance-Whale-Widget

1. 用本页的安装命令把 npm 包装进 web profile。README 提醒不要混用 npm 和 github: 两种安装来源；之前从 GitHub 装过的话，先把旧的卸掉：

dsh plugin --profile web remove dsh-whale-widget

2. 重启 dsh web 并刷新浏览器，此后每次打开网页界面鲸鱼都会自动出现。
3. 让它能读到余额：在 DSH 凭据服务里配置 DEEPSEEK_API_KEY，或者在设置的“账号与余额”里登录 DeepSeek 账号。
4. 点击鲸鱼刷新余额、切换泡泡。大小、吸附、音效、提醒和记账窗口都在菜单里。

如果用的是官方桌面客户端，不要执行 --profile web 命令，改为让 DSH 用内置的 plugin_manager 安装这个包。