前言¶

在 DeepSeek Harness（DSH）里切换模型供应商时，余额往往分散在各家中转接口或账号钱包里，输入框附近也没有统一入口。手动打开供应商控制台查余额，和当前会话里选的模型容易对不上号。下面介绍社区插件 @breey05/dsh-balance-widget：在 Composer 输入框下方显示与当前所选供应商对应的余额，并在切换供应商时立即换源读取。

这是什么¶

@breey05/dsh-balance-widget 由维护者 BREEY05 发布，仓库地址为 https://github.com/BREEY05/dsh-balance-widget。插件在 DSH 输入框下挂载余额入口，订阅会话的模型选择；空白会话则使用 Host 模型目录提供的默认供应商。余额数据来自各供应商结算快照，会话消耗按观察到的余额下降估算，账单仍以供应商为准。

支持的供应商¶

供应商 ID 必须与下表一致；其他供应商显示「余额不可用」，不会展示别家余额。DeepSeek API Key 路由当前尚未接入余额接口。同一供应商下的不同模型共用同一钱包。

核心功能¶

插件通过会话的 modelSelection projection 跟随模型选择；每个供应商、每个会话分别保存消费记录，切换后不会把不同钱包的差额记作消费，切换期间迟到的请求也不会污染新供应商数据。

点击余额入口可查看余额、观察到的会话消耗、今日消耗，并使用刷新按钮主动拉取。Host 经受保护路由请求 aigocode 与 taffy 两家中转服务，API Key 留在 Host 进程内；无遥测、无外部脚本、无运行时依赖。每五分钟轮询，聊天节点变化后延迟读取，普通读取最少间隔 45 秒；失败后退避 2–15 分钟。切换供应商会立即启动新读取。

消耗计数保存在浏览器 localStorage / sessionStorage，不包含密钥。多个标签页同时观察同一钱包可能重复计数，这些记录仅作估算。

安装与启用¶

DSH 版本需满足 >=0.2.1-rc.2 且 <0.3.0。在 DSH 的插件安装框输入：

@breey05/dsh-balance-widget@1.2.0

也可使用 GitHub 仓库地址 git+https://github.com/BREEY05/dsh-balance-widget.git，或安装本地目录。安装后刷新当前页面。

在本机 DSH 凭据管理中配置 AIGOCODE_API_KEY、TAFY_API_KEY；切勿将密钥粘贴到聊天或提交到仓库。账号路由（deepseek-account）无需额外 API Key，使用设置中的 DeepSeek 登录即可。

典型用法¶

1. 安装插件并刷新页面后，在 Composer 输入框下方会出现余额入口（当前版本会显示供应商名称）。
2. 在会话中选择或切换模型供应商；入口会立即切换并重新读取对应接口或账号钱包。
3. 点击入口查看详情与消耗估算；需要时可点刷新主动读取。
4. 卸载插件后，若需清除本地消耗记录，可清除该站点的浏览器数据。

适用场景与注意¶

适合经常在 DSH 中切换 aigocode、taffy 或 DeepSeek 账号路由、并希望在一处观察余额与会话消耗的用户。余额并非逐 token 实时计费；同账号其他设备的使用也可能计入，切换后首次读取仅建立基线。

本插件在 DSH Host 进程内运行，只安装你信任的插件。安装前可在 GitHub 查看源码与 MIT 许可证。社区目录页：https://www.skillhub.cn/plugins/BREEY05/dsh-balance-widget（独立社区站点，与 DeepSeek / 幻方无官方从属关系）。

结尾¶

经过上面的步骤，你可以在 Composer 旁随模型供应商查看余额与估算消耗，减少在控制台与 Harness 之间来回切换。仓库与问题反馈：https://github.com/BREEY05/dsh-balance-widget。