DeepSeek开发者专属“余额管家”：一只会弹跳、能记账、懂峰谷的小鲸鱼挂件

还在为DeepSeek API余额偷偷缩水却浑然不觉而焦虑？每次对话后都得手动翻API文档查用量？担心工作日高峰时段调用成本飙升却无提醒？MeteorNOX开发的「DeepSeek Balance Whale Widget」——一只住在DeepSeek Harness（DSH）界面右下角的Q弹小鲸鱼娘，正是为此而生。它不是简单的数字显示器，而是一个融合实时监控、智能记账、峰谷感知与交互乐趣的轻量级开发者工具，让API余额管理从“被动查账”变成“主动陪伴”。

核心功能

余额秒级可视，变化即感知：60秒自动刷新API账户总余额，余额变动时触发平滑数字滚动动画；点击鲸鱼即可手动刷新，网络抖动时自动沿用最近有效值，绝不因临时失败中断监控——解决开发者最怕的“余额突降却不知何时发生”的盲区问题。
双模“今日已用”统计，兼顾便捷与精准：默认启用“小鲸鱼记账”模式——无需额外令牌，仅凭余额差值自动累计当日消耗，并跨天归零归档（保留30天历史），开箱即用；进阶用户可切换“实时·令牌”模式，填入平台会话Token后直连DeepSeek用量接口，按工作日9–12点/14–18点高峰定价、其余时段及周末谷价实时换算，精准还原每一分钱花在哪。
每轮对话“消费单”即时弹出：监听本地DSH会话生命周期，在每轮AI对话结束后自动弹出气泡，显示本次请求的精确usage换算金额（非估算），支持自定义弹出时长（0秒=常驻），且弹出期间余额变动不再干扰——解决“到底这句问话花了多少钱”的终极困惑。
物理级交互体验：拖拽吸附+镜像翻转+Q弹按压：支持自由拖拽，并智能吸附至浏览器窗口四边及四角（如左下角、右上角等）；吸附到左侧时自动水平镜像翻转，文字同步反向，动画流畅自然；按压鲸鱼底部固定、顶部Q弹形变，配合可选小黄鸭音效，让工具使用充满治愈感——把枯燥的运维监控变成指尖可玩的轻交互。
汉堡菜单全维调控，细节控狂喜：悬停鲸鱼右上角呼出菜单，可实时调节大小（0.6–2.5倍）、开关气泡/每轮消耗提示、设置自动关闭秒数、切换峰谷提示文案（含梁文峰谷、!?强强?!等彩蛋风格）、开启/关闭音效并独立调节音量——所有个性化设置均在UI内完成，无需改配置文件。
随机台词+动态气泡，信息不枯燥：点击鲸鱼气泡可循环切换加权随机台词，涵盖峰谷时段提醒、今日已用总结、GIF动图（如rua.gif）、卖萌吐槽等类型，5秒后自动收起——在关键信息之上叠加人性化表达，缓解开发者长期盯屏疲劳。
响应式自适应，多屏无缝跟随：随浏览器窗口缩放自动调整尺寸，文字位置、字号与鲸鱼图像严格联动，确保在4K大屏、笔记本或平板浏览器中始终清晰可读、布局协调——告别手动适配的麻烦。

技术亮点

标准DSH Bundle插件架构：严格遵循DeepSeek Harness官方插件规范，通过cordis.patch.yml声明挂载点，以package.json定义元数据，支持dsh plugin add link:.一键集成，安装后自动注入dsh.profile.bundles，重启即生效——非hack式注入，稳定可靠，升级友好。
前端状态韧性设计：余额刷新采用“乐观更新+降级兜底”策略——网络失败时沿用缓存值并静默重试，避免白屏报错；记账模式基于本地JSON（.dshw-usage.json）持久化，跨天自动归档，不依赖后端服务，离线可用。
纯客户端峰谷逻辑实现：峰谷时段判断（工作日9–12/14–18为高峰）完全在浏览器端计算，无需调用外部时间服务；峰谷文案支持热切换（默认/梁文峰谷/!?强强?!），通过前端配置驱动，无需发版即可扩展语义表达。
资源按需加载与静默降级：音效（Ya1.mp3/Ya2.mp3等）和GIF动图均为可选资源，缺失时自动静默降级（无音效、无动图），不影响核心功能；图片采用cut-out透明PNG（DSniang1.png）+代码绘制气泡，兼顾画质与体积。

适合哪些人用

这款插件专为深度使用DeepSeek API的中文开发者、算法工程师、Prompt工程师及AI应用构建者打造。尤其适合两类典型场景：

高频调用API的SaaS产品团队：某AI客服后台每日调用超5万次，运维同学曾因未关注峰谷价导致月度账单激增37%。接入小鲸鱼后，团队将“左下角鲸鱼是否变红（高峰提示）+ 今日已用是否逼近阈值”设为晨会必看项，结合自动弹出的每轮消耗，快速定位高成本对话模板并优化，3周内API成本下降22%。
个人开发者与学生党：一位正在用DeepSeek做毕业设计的研究生，每月API额度有限。她开启“小鲸鱼记账”模式后，发现深夜调试时（谷价时段）单次推理成本仅为白天的1/3，遂将批量测试任务调度至凌晨执行，成功将原计划超支的额度压缩回预算内。

快速上手

安装极简，三步到位：

确保已安装最新版DSH及pnpm（npm install -g pnpm）；
克隆仓库至本地，进入项目根目录（含package.json）：
dsh plugin --profile web add link:.
重启dsh web，浏览器F5刷新——右下角即见Q弹小鲸鱼！

首次使用前，请务必在DSH凭据管理中配置DEEPSEEK_API_KEY（必需），若需精准峰谷用量则额外配置DEEPSEEK_PLATFORM_TOKEN（获取方式见README“用量模式使用教程”）。

同类对比 / 注意事项

vs 纯API余额查询脚本：脚本只能定时拉取快照，无法感知每轮消耗、无峰谷计算、无UI反馈；小鲸鱼则是嵌入式实时仪表盘，把离散数据转化为连续体验。
vs 浏览器插件类监控工具：同类插件需额外安装、权限申请、跨域调试；本插件是DSH原生Bundle，零权限、零跨域、与DSH同进程，安全性与性能更优。
重要提醒：安装路径必须是仓库根目录（link:.），切勿写成link:.\dsh-whale-widget（该子目录不存在）；若移动过源码目录，需重新执行add link:命令；旧版手动安装用户请先按README清理残留文件再重装。