前言¶
在 DeepSeek Harness（DSH）里切模型、走订阅额度时，账户页和厂商控制台往往要单独打开。社区里的小鲸鱼类记账挂件已经能把余额、今日消费和每轮消耗贴在界面角落，但不少版本默认盯着 DeepSeek 账户口径。如果你本会话实际在用的是 Kimi Coding、OpenRouter 或其它已登记模型，角标仍显示 DeepSeek，就容易误判还剩多少钱、订阅窗还剩多少。
下面介绍维护者 Xun209 发布的 DSH 大肥魚記賬掛件 · 勛（仓库 Xun209/dsh-fatfish-usage-xun209）。它在记账挂件形态上做了本机向改造：单次点击即可查看当前会话正在使用的模型对应的余额，或会员订阅周期的剩余用量，而不是固定展示 DeepSeek。分类上属于 DSH 客户端挂件（SkillHub 目录当前版本 v0.4.2）。
这是什么¶
这是标准 DSH bundle 客户端插件（包名仍为 dsh-whale-widget，与上游记账挂件共用结构），在 DSH Web 或官方桌面客户端右下角常驻显示「大肥魚」角色气泡。代码侧继承上游小鲸鱼记账挂件的能力栈；本仓库的差异化主要在交互与取数口径：package.json 描述为「蓝毛小女仆 · 记账挂件：右下角常驻，跟随当前会话正在使用的模型，显示其余额或会员订阅周期用量」。
角色形象来自社群二创，美術采用 CC BY-NC-SA 4.0（禁止商用）。插件代码在 README 中注明为 MIT；安装前宜自行阅读仓库源码与 PROVENANCE.md（若存在）中的素材说明。插件在 当前 DSH 进程权限下运行，会读取凭据服务中的 API key 名、访问余额接口并写账本到 $DSH_HOME（默认 ~/.dsh），使用前请确认你信任维护者与许可证条款。
与本仓库相关的核心能力¶
跟会话模型走的余额与订阅窗¶
与「角标永远绑在 DeepSeek」相比，本改造强调跟车当前会话：
- 挂件随 DSH 界面打开自启（
dsh.client.platform: web，immediately: true）。 - 点按角色触发气泡：展示当前会话模型的账户余额，或该模型配置的订阅 / 额度窗口剩余用量（具体能读到哪一类，取决于你在「小鲸鱼记账 → 模型」里登记的厂商模板与凭据）。
- 上游仍支持 60 秒自动刷新余额、点击手动刷新、余额变化滚动动画；DeepSeek 内置路径仍可通过 DSH 凭据中的
DEEPSEEK_API_KEY，或未配置 key 时在「设置 → 账号与余额」登录 DeepSeek 账号后走登录态取数（README 原文说明）。
继承的记账与多厂商扩展（摘要）¶
README 沿用上野猪挂件文档，下列能力在 Xun209/dsh-fatfish-usage-xun209 的 main 分支同样适用，篇幅原因只列与日常开发相关的几条：
- 今日已用 / 每轮消耗：监听本机会话事件，按模型真实 usage 换算金额；可在菜单 →「音效与提示」→「全局设置」里配置每轮消耗泡泡与
{cost}模板。 - 多厂商模板：在记账里添加 OpenRouter、Kimi、智谱 Coding Plan、OpenCode Go 等；密钥只存 DSH 凭据名，配置里不写明文 key。
- 可定制泡泡：点击序列、模块化排版、随机语句 / 图片、拖拽吸附与音效等，与上游说明一致。
若你只需要「换皮肤 + 跟会话看余额」，不必先配齐全部泡泡编辑器；先完成安装与模型登记即可。
安装与启用¶
SkillHub 目录页给出的安装方式，是在 DSH 会话里让宿主代为安装本仓库（勿与上游 npm 包混为同一来源）：
请安装 DSH 插件 Xun209/dsh-fatfish-usage-xun209。先读取..
（完整提示以 SkillHub 插件页 为准。）
官方桌面客户端（推荐路径）¶
本插件在目录中归类为客户端。README 写明桌面端使用 desktop profile，命令行 dsh plugin --profile desktop 会被拒绝；应在桌面客户端会话中让 DSH 使用内置 plugin_manager 安装。README 提供的示例话术为：
请使用当前桌面端内置的 plugin_manager 安装 dsh-whale-widget。先核对当前 profile 和是否已有同名插件；已有安装时先报告来源与版本。按该工具支持的操作完成后，告诉我安装结果及是否需要重启。
安装规格需指向 Xun209/dsh-fatfish-usage-xun209 这一来源，而不是默认的 MeteorNOX/DeepSeek-Balance-Whale-Widget。装完后若右下角无挂件，按 README 建议完全退出客户端（含托盘）后重开，并核对 desktop profile 下的 bundle 登记。
DSH Web（dsh web）¶
若你使用浏览器版 DSH，README「安装」章节中的 Web 方式仍然有效，但请勿执行文中示例里指向上游仓库的命令（例如 dsh plugin --profile web add github:MeteorNOX/DeepSeek-Balance-Whale-Widget 或 dsh plugin --profile web add dsh-whale-widget），以免装成上游包而非本 fork。
在已取得本仓库完整目录（含 package.json、cordis.patch.yml、lib/、assets/）时，可按 README 方式 A 或 方式 C 操作：
- 若曾安装过同名包，先卸载避免冲突：
dsh plugin --profile web remove dsh-whale-widget
- 在仓库根目录（
package.json所在目录）链接安装：
dsh plugin --profile web add link:.
或使用绝对路径（README 方式 A）：
dsh plugin --profile web add link:D:\Plugins\dsh-fatfish-usage-xun209
- 重启
dsh web，浏览器再 F5 刷新。
经过上面的步骤，挂件应出现在 Web 界面右下角；菜单底部会显示当前插件版本（开发版可能带 -beta 后缀）。
典型用法¶
- 只看当前模型还剩多少：打开 DSH，确认会话使用的模型；单击右下角大肥魚，阅读气泡中的余额或订阅周期剩余用量。需要刷新余额时可再次点击（上游支持手动刷新与 60 秒轮询）。
- 登记非 DeepSeek 模型：主菜单 → 资源管理 / 小鲸鱼记账 →「模型」→ 选择厂商模板 → 在 DSH 凭据里填对应 key →「测试连通性」。之后在泡泡模块里可使用
{balance}、{quota}、{quota_left}等占位符（README「自定义 API」一节）。 - 校正 DeepSeek 充值导致的账本偏差：若观测到余额上升，按 README 在「小鲸鱼记账 → DeepSeek（内置）→ 设置 → 余额校正」中核对累计到账，避免「今日已用」被充值冲掉。
适用场景与注意¶
适合谁：经常在 DSH 里切换多厂商模型、又想在不离开会话的情况下看一眼当前模型余额或 Coding Plan / 订阅窗余量的开发者；接受右下角常驻 UI 与轻微音效提示的用户。
注意：
- 与上游 npm 包
dsh-whale-widget同名，README 要求 npm 名与github:来源不要混装；换来源前应先remove dsh-whale-widget。 - 并非所有厂商都提供「用 API key 查余额」接口；无余额接口的模板会显示「—」，今日已用可能退化为会话估算（README 厂商表有标注）。
- 插件会写
.dshw-usage.json等运行时文件到$DSH_HOME；卸载不会自动删除你的泡泡与账本配置，需自行备份。 - 角色美術 CC BY-NC-SA 4.0，勿用于商用再分发；代码 MIT 与素材许可分离，以仓库声明为准。
- DeepSeek Harness 社区目录（SkillHub）与 DeepSeek / 幻方无官方从属关系；安装第三方插件前请自行审阅源码与许可证。
结尾¶
DSH 大肥魚記賬掛件 · 勛 把记账挂件从「默认 DeepSeek 角标」推进到「跟当前会话模型看余额与订阅用量」，并替换为社群二创角色形象。需要查阅元数据或复制安装提示时，可打开 SkillHub 目录页；阅读实现细节、安装分支说明与多厂商模板表，请以 GitHub 仓库 README 为准。
