前言¶

在 DeepSeek Harness（DSH）里跑 Web 会话时，余额、今日消耗和峰谷单价往往要切到平台或凭据页才能核对；对话每轮的真实 token 费用也不总在视线里。DSH 社区里已有各类 bundle 插件扩展界面能力。下面介绍的是挂在 Web 界面右下角的小鲸鱼挂件：把 DeepSeek 余额、今日已用、峰谷状态和部分提醒收进一个常驻控件，并通过可配置的点击气泡序列把展示方式交给使用者自己排版。

这是什么¶

DSH 小鲸鱼记账挂件（npm 包名 dsh-whale-widget）由维护者 ggxx001 发布，在 SkillHub 插件目录 中归类为「趣味换装」。源码与说明见 GitHub：ggxx001/dsh-whale-widget。

它是标准 DSH bundle 插件，随 DSH Web 界面打开自动出现在右下角：小鲸鱼角色图 + 气泡内容。核心用途包括：展示 DeepSeek API 余额与今日已用、按北京时间区分峰谷定价、监听本机会话每轮 usage 并提示消耗金额，以及通过模块化编辑器自定义「点鲸鱼出泡」的序列、样式、音效与角色资源。README 中说明：同一 npm 包也可用于官方桌面客户端，但 Web 端与 Codex 桌面应用是不同产品线；Codex 版已迁至独立仓库，与本插件互不兼容。

核心功能¶

记账与显示¶

挂件每 60 秒自动刷新余额，点击鲸鱼可手动刷新；余额变化时有数字滚动动画，短时网络抖动会沿用最近一次成功读数。取数优先级为：DSH 凭据中的 DEEPSEEK_API_KEY；若未配置 key 但已在「设置 → 账号与余额」登录 DeepSeek 账号，则使用登录态（无需单独去 platform 建 key）。

「今日已用」通过观测余额下降累计，充值或赠金导致的上升单独记录，不会冲掉已有消费；检测到余额增加时会提示「待核对余额调整」，可在「小鲸鱼记账 → DeepSeek（内置）→ 设置 → 余额校正」中按实际到账与非调用扣减校正。逐轮明细与归档策略见 README（例如逐轮明细保留 90 天或最多 2 万条等）。

每轮对话消耗监听 DSH 本机会话事件，按模型真实 usage（input / cache / output / reasoning tokens）换算金额，轮次结束可弹出消耗泡泡；开关、自动关闭秒数与泡泡文案在「菜单 → 音效与提示 → 全局设置 → 每轮消耗提示」中配置，金额占位符为 {cost}。

峰谷定价按北京时间：工作日 9:00–12:00、14:00–18:00 为高峰，其余为空闲；自 2026-08-23 起周末全天按谷价。峰谷模块支持多种展示样式（如状态文字、倒计时等）。

另提供用量记录窗口：今日模型消费、近 7 天、全部记录、模型占比与按日期展开的明细，支持按日期或模型名搜索。

泡泡系统与交互¶

点击序列分「首次点击泡」与「再次点击」队列，队列项可增删排序；两项可并列为 A/B 加权，每轮按权重抽取其一。可选「点按角色推进队列」：开启后点角色依次推进队列项，走完最后一项再点则收起，下次从第一项重新开始。

单个泡泡由多行模块组成，每行最多 6 个模块，泡泡最多 6 行。模块类型包括：文本、超链接、随机语句（带权重且不连续重复）、图片/动图、随机图片、总余额（充值+赠金）、赠金、充值余额、今日已用、峰谷时段、对话名等；图片类模块独占一行且每泡仅一个。支持逐模块字体、字号、加粗/斜体/下划线、纯色或跑马灯渐变、底色；文本与随机语句支持悬浮快捷编辑；常用模块可存入模块库复用。

交互上支持拖拽与四边吸附（顶部吸附默认 0 表示关闭，需在「菜单 → 吸附与翻转 → 自定义」中设正值）；贴左吸附时整体水平镜像翻转。主菜单含角色与大小、音效与提示、气泡开关、吸附、资源管理等；可隐藏菜单按钮，隐藏后桌面端右键鲸鱼、移动端长按约 1.5 秒唤出菜单。

提醒、音效与资源¶

余额低于阈值、今日已用达到预算、每轮消耗、以及 DSH 需要你回答提问或批准授权时，均可配置气泡或卡片提醒（部分默认关闭）。按压与松开音效、任务结束音、提问音/授权音可独立开关与音量；可导入音频片段组成自定义音效组。角色与泡泡图库支持上传 png/gif，内置示例图见 README。

多厂商余额与额度（可选）¶

除内置 DeepSeek 外，可在「小鲸鱼记账 → 模型」添加其他厂商：README 列出 34 个厂商模板（含可直接查余额/额度与「无余额接口、探活 + 会话估算」等类型）。密钥写入 DSH 官方凭据服务，配置中只存凭据名；各模型可配余额预警、今日预算与额度模块，泡泡中可使用 {balance}、{today}、{quota} 等占位符。并非所有厂商都提供公开余额 API，具体以模板说明为准。

安装与启用¶

Web 界面右下角使用 main 分支对应的 npm 已发布版，推荐命令如下：

dsh plugin --profile web add dsh-whale-widget

README 也提到可从 GitHub 安装当前 main 状态（不跟随 npm 已发布版本）：

dsh plugin --profile web add github:MeteorNOX/DeepSeek-Balance-Whale-Widget

两种方式对应同一包名，不要混装；若已用 github: 安装要改用 npm 名，需先执行：

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

官方 Electron 桌面客户端不能使用 --profile web 从 CLI 安装，需在桌面端会话中让 DSH 自行安装插件，详见仓库 README「官方桌面端」一节。

插件以当前 DSH 进程的权限运行，会读取凭据与账号登录态并发起余额相关请求。安装前建议阅读源码、MIT 许可证（package.json 标注）及 README 中的分支与 Codex 迁移说明。

典型用法¶

1、安装并打开 DSH Web 界面，确认右下角出现小鲸鱼；若已配置 DEEPSEEK_API_KEY 或完成账号登录，气泡中的余额模块应能刷新。

2、打开鲸鱼菜单，进入「自定义泡泡」或气泡相关入口，配置首次点击与再次点击序列：例如一行放「总余额」模块，一行放「今日已用」，再添加峰谷模块；保存后点鲸鱼验证序列。

3、需要每轮费用反馈时：「音效与提示 → 全局设置 → 每轮消耗提示」中打开冒泡，设置自动关闭秒数，在「编辑提示内容」里用 {cost} 引用本轮金额。

4、若使用多模型：在「小鲸鱼记账 → 模型」选择厂商模板、绑定凭据名并「测试连通性」，再把「余额·模型名」等模块拖入泡泡。

5、吸附与翻转：「菜单 → 吸附与翻转 → 自定义」调整四边吸附区；贴左时观察镜像翻转是否符合阅读习惯。

适用场景与注意¶

适合长期在 DSH Web 里调试智能体、希望余额、今日消耗、峰谷与每轮费用留在同一视线内的开发者。若主要使用 Codex 桌面应用，应使用 README 指向的 Codex-Whale-Public 产品线，不能用 dsh plugin … add 把本仓库插件装进 Codex。

自定义单价、厂商模板与硅基流动等平台 API 变更等细节以 README 当前说明为准；涉及密钥与日志时，README 要求反馈问题时注明版本与系统、勿上传未脱敏配置。

结尾¶

DSH 小鲸鱼记账挂件把 DeepSeek 余额观测、今日记账、峰谷展示和可编排气泡收进 Web 右下角，并扩展到多厂商模板与提醒音效。若要查看分类与简介，可打开 SkillHub 目录页；安装命令、模块字段与桌面端说明以 GitHub 仓库 README 为准。