dsh-whale-widget：DeepSeek Harness 右下角的余额记账小鲸鱼

它是做什么的？

小鲸鱼记账挂件是 DeepSeek Harness（DSH）的桌面挂件插件，在 DSH Web 界面右下角常驻一只小鲸鱼，实时显示 DeepSeek API 余额、今日已用与每轮对话消耗。它解决的是「余额和花费要另开页面查」的麻烦，把记账、峰谷定价、用量明细和可自定义的泡泡提示都收进一个随手可点的挂件里。本仓库是上游小鲸鱼挂件的增强 fork，基线为上游 v0.4.2，由 TuWeiZhi 维护，采用 MIT 协议，只额外增加了空闲自动说话与随机语句洗牌袋两项能力。

核心功能

• 余额与消费记账：余额 60 秒自动刷新、点击鲸鱼手动刷新，余额下降累计为消费、充值或赠金单独记录，金额按 8 位小数记账。
• 每轮对话消耗提示：监听 DSH 本机会话事件，按模型真实 usage 换算金额，每轮结束弹出消耗泡泡，可开关并设置自动关闭秒数。
• 峰谷定价提示：按北京时间工作日高峰与空闲时段区分价格，2026-08-23 起周末全天谷价，支持倒计时与多种样式。
• 泡泡系统：点击序列、模块化排版、并列加权出泡，泡泡内容可完全自定义，金额用占位符引用。
• 空闲自动说话与洗牌袋：这是本 fork 相对上游新增的两项能力，空闲时自动冒泡，随机语句在一轮内按权重不重复。
• 用量记录窗口：查看今日、近 7 天与全部记录，模型占比条、按日期展开明细，支持按日期或模型名搜索。

怎么使用这个插件？

在 DSH 中启用后，小鲸鱼会随 Web 界面每次打开自动出现在右下角，点一下鲸鱼即可手动刷新余额。想改泡泡内容，从菜单进入「音效与提示」→「全局设置」→ 展开「每轮消耗提示」→「编辑提示内容」；吸附、大小、音效等都在主菜单里调，面板内改动点「保存」才生效。注意本 fork 与上游原版是两个包，二者并存会冲突，已装过上游的需先移除再装本仓库版本；桌面客户端与网页端读取的配置档不同，桌面端请让 DSH 自行安装。

报错怎么排查？

余额数字不更新时，先确认 DSH 凭据里配了 API key，或已在「设置 → 账号与余额」登录 DeepSeek 账号；瞬时网络抖动会自动沿用最近余额而不报错。检测到余额增加会提示「待核对余额调整」，可在「小鲸鱼记账 → DeepSeek（内置）→ 设置 → 余额校正」按实际到账金额校正。顶部吸附默认关闭，需要开启请到「菜单 → 吸附与翻转 → 自定义」把上侧数值调为正值后确认。