deepseek-balance-whale-widget：DeepSeek Harness 的余额小鲸鱼挂件

它是做什么的？

DSH 小鲸鱼余额挂件是 DeepSeek Harness（DSH）的界面插件，在 DSH Web 界面右下角常驻一只小鲸鱼气泡图，实时显示 DeepSeek API 余额、今日已用和每轮对话消耗。它解决用户需要频繁手动查询余额、估算用量的麻烦，让你在 DSH 里直接看到账户消耗，无需离开界面。核心能力包括余额自动刷新、今日用量记账、对话消耗统计、拖拽吸附和个性化音效台词。

核心功能

• 余额自动刷新：每 60 秒自动刷新余额，点击鲸鱼可手动刷新，余额变化时数字滚动动画，网络抖动时沿用最近余额不报错。
• 今日已用双模式：默认小鲸鱼记账模式免令牌，用余额差值本地记账并跨天归档；实时令牌模式调用平台用量接口，按峰谷定价换算。
• 每轮对话消耗统计：监听本机会话事件，每轮对话结束后弹出精确消耗金额，可开关并自定义自动关闭时间。
• 拖拽吸附与镜像翻转：支持四边四分之一吸附，左吸附时整体水平镜像翻转，按压有 Q 弹玩偶效果。
• 汉堡菜单个性化：可调大小（0.6–2.5 倍）、切换音效、调节音量、选择用量模式、开关气泡和每轮消耗提示。
• 随机台词与音效：点击气泡切换加权随机台词（含峰谷提示、今日已用、gif 动图、卖萌吐槽），按压/松手有可选音效。

怎么使用这个插件？

在 DSH 中启用后，每次打开 Web 界面小鲸鱼自动出现，无需手动操作。默认只需配置 DEEPSEEK_API_KEY 即可拉取余额，今日已用自动使用记账模式；若需更精确的实时用量，可额外配置平台会话令牌并切换模式。通过悬停鲸鱼右上角的汉堡菜单可调整大小、音效、用量模式等；点击气泡可切换随机台词，再点一次关闭。若移动了源码目录，需重新执行安装命令并重启 dsh web 后刷新浏览器。