@breey05/dsh-balance-widget
与所选 Harness 模型对应的、按提供商区分的 API 余额和已观测支出。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @breey05/dsh-balance-widget@1.4.1Balance Widget 以 @breey05/dsh-balance-widget 发布，当前版本为 1.4.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
在 DeepSeek Harness 输入框下显示当前模型供应商的余额。切换模型供应商时，余额入口立即切换并重新读取对应接口。
| 模型供应商 ID | 余额来源 | 凭据 |
|---|---|---|
aigocode | https://api.aigocode.dev/v1/usage 的 balance，USD | 本地 AIGOCODE_API_KEY |
taffy | https://taffy.work/v1/usage 的 remaining / quota.remaining / balance，USD | 本地 TAFFY_API_KEY |
tafy | 同上（旧 ID，保留兼容） | 本地 TAFFY_API_KEY |
ds | 同上，但使用该路由自己的密钥 | 本地 DS_API_KEY |
deepseek-official | https://api.deepseek.com/user/balance 的 balance_infos[].total_balance，CNY | 本地 DEEPSEEK_API_KEY |
deepseek-account | DSH 账号 Remote 的充值与赠金钱包 | 设置中的 DeepSeek 登录 |
上表是内置的常见供应商 ID。多个 ID 可能指向同一钱包但配置不同密钥（例如 taffy、tafy、ds 都走 taffy.work），插件按 ID 各自读取，因此改 ID 后余额不会静默变空。不同模型如果属于同一供应商，使用同一钱包。
不在表中的供应商会自动发现。 插件从 ~/.dsh/profiles/*/cordis.patch.yml（及 cordis.yml）读取该 ID 的 baseURL、apiKeyEnv，再用这把 Key 依次探测公开的余额接口：/user/balance、/v1/usage、/v1/credits、/v1/dashboard/billing/subscription、/api/user/self、/v1/balance、/api/usage、/usage。命中后就地解析余额（支持 balance、remaining、total_balance、credits、One-API 的 quota/500000 等常见字段与 CNY/USD）。同一个域名只探测一次并缓存结果，轮询时不再重复试探。
注意两点：需要余额接口使用同一把 API Key 做 Bearer 认证（大多数中转/官方实现如此）；若该供应商只提供网页登录态才能看的额度，或未声明 baseURL/apiKeyEnv，后端会返回“没有可用余额接口 / 缺少凭据”，此时在 index.js 的 SOURCES 中显式加一行 usageUrl 即可。client.js 的 PROVIDERS 只影响显示名称，未列出的 ID 直接用 ID 本身作标签。
不要靠猜，也不要向用户索要接口细节。在仓库里跑一次探测脚本，它会自己问出协议、模型清单和余额地址：
node scripts/probe-provider.mjs --id <provider-id> --base https://<base-url> --key-env <ENV_NAME>
脚本按环境变量、再按 ~/.dsh/.credentials.yaml 的顺序取 Key，依次试 /v1/models、/v1/chat/completions、/v1/responses、/v1/messages 判断是 OpenAI 兼容还是 Anthropic 兼容，再走一遍上面的余额探测，最后直接打印可粘贴进 cordis.patch.yml 的 llm-pi-ai.config.providers 片段。确认片段后再写入 profile，余额侧无需改代码。
在 DSH 的插件安装框输入：
@breey05/dsh-balance-widget@1.4.1
也可使用 GitHub 仓库地址 git+https://github.com/BREEY05/dsh-balance-widget.git，或安装本地目录。需要 DSH >=0.2.1-rc.2 <0.3.0。安装后刷新当前页面。
在本机 DSH 凭据管理中配置 API Key，切勿将密钥粘贴到聊天或提交到仓库。无需为账号路由配置 API Key。
modelSelection projection 订阅模型选择；空白会话使用 Host 模型目录提供的默认供应商。baseURL 下的若干常见余额路径，这会出现在供应商的访问日志里。无遥测，无外部脚本，无运行时依赖。原账号版截图（当前版本额外显示供应商名称）：
Composer balance Balance details
npm test 检查路由选择、账户钱包合计、未知/重命名供应商、自动发现与缓存、profile YAML 解析、消费隔离和迟到请求。测试使用模拟响应，不代表真实供应商连通性。
client.js 注册 conversation.composer.dock；index.js 按 SOURCES 为每个供应商注册一条受保护路由（/api/aigocode-usage、/api/taffy-usage、/api/tafy-usage、/api/ds-usage、/api/deepseek-usage），并额外注册一条通用路由 /api/provider-balance?provider=<id> 负责自动发现。保留原始图标及中英文本地化。
社区市场收录通过向 awesome-dsh-plugin 提交目录 PR；npm 发布本身不会自动完成首次收录。后续版本由市场定期探测。
MIT License. 仓库：https://github.com/BREEY05/dsh-balance-widget