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

它是做什么的？

小鲸鱼记账挂件是 DeepSeek Harness（DSH）的 Web 界面挂件插件，在页面右下角常驻一只小鲸鱼，实时显示 DeepSeek API 余额、今日已用和每轮对话消耗。它解决的是「用 DeepSeek 时看不到钱花在哪」的问题：余额下降按观测累计为消费，充值或赠金单独记录，不需要任何会话令牌。核心能力包括余额自动刷新与滚动动画、峰谷定价提示、可完全自定义的点击泡泡序列，以及音效、吸附、翻转等交互细节。

核心功能

• 余额与记账：每 60 秒自动刷新余额，点击鲸鱼可手动刷新，余额变化带滚动动画；今日已用按余额观测累计，充值或赠金单独记录并提示待核对调整，逐轮明细保留 90 天、逐日归档保留 365 天。
• 每轮对话消耗：监听 DSH 本机会话事件，按模型真实 usage（输入、缓存、输出、推理 token）换算金额，每轮结束弹出消耗泡泡，可开关并设置自动关闭秒数。
• 峰谷定价：按北京时间标注工作日高峰 9:00–12:00、14:00–18:00，其余时段为空闲价，峰谷模块支持状态文字、倒计时和多种样式。
• 自定义泡泡系统：泡泡由文本、超链接、随机语句、图片或动图、随机图片、总余额、赠金、充值余额、今日已用、峰谷时段、对话名等模块按行组成，支持并列加权出泡、逐模块字体与配色、跑马灯渐变和拖拽排版。
• 交互与外观：四边吸附区可按比例或像素自定义，贴左吸附时整体水平镜像翻转，按压有 Q 弹效果，菜单按钮可隐藏，移动端支持触摸拖动与长按拖拽排序。
• 音效与提示：按压音效、每轮消耗提示、提问提示、授权提示各有独立开关与音量，面板改动只落内存，点保存才生效。

怎么使用这个插件？

在 DSH Web 界面启用后，小鲸鱼会随页面打开自动出现在右下角，点击鲸鱼即可刷新余额并依次弹出你配置的泡泡。要改泡泡内容，打开主菜单进入「自定义泡泡」窗口，增删排序点击序列、把两泡并列为 A/B 加权选择、逐模块调整字体与配色，最后点保存生效。每轮消耗提示的文案在「音效与提示 → 全局设置 → 每轮消耗提示 → 编辑提示内容」里编辑，金额用占位符引用。吸附与翻转在「菜单 → 吸附与翻转 → 自定义」里调整，顶部吸附默认值为 0 即关闭，需要时把上侧数值调为正值再确认。

报错怎么排查？

余额数字不更新时，先确认 DSH 凭据里配置了 DeepSeek API key，或已在「设置 → 账号与余额」登录账号；瞬时网络抖动会沿用最近余额而不报错。检测到余额增加会提示「待核对余额调整」，可在「小鲸鱼记账 → DeepSeek（内置）→ 设置 → 余额校正」按实际到账金额校正。顶部吸附不生效通常是上侧数值仍为 0，按官方说明把该值调为正值即可；大尺寸挂件需要相应扩大上侧吸附区。