模型余额面板 qianhuang0721/dsh-model-balance-panel

模型余额面板 · dsh-model-balance-panel

给 DeepSeek Harness（DSH）的 Web 界面加一个左侧栏入口，点开就能看到 DSH 里已配置的那些模型服务商各自还剩多少钱、还剩多少额度。
余额来自各服务商自己的账户接口，每次进入面板都会刷新。

非官方插件，与 DeepSeek 官方无关。余额数字来自第三方接口，仅供参考，以服务商账单为准。

它显示什么

- 左栏图标：钱包字形，排在「插件」「定时」之后；点开即切到余额面板。
- 每个服务商一张卡片，卡片上是它的模型清单（当前在用的模型高亮），下面是该服务商的余额：
- 订阅 / 额度制（如 OpenCode Go）：5 小时额度、周额度、月额度 三条进度条，显示已用百分比、按满额度折算的剩余金额、重置时间；≥70% 变黄、≥90% 变红。
- 金额制（DeepSeek API Key / DSH 登录账号）：可用余额，以及赠送、充值两个分项。
- 状态如实：已同步 / 未配置凭证 / 不支持查询 / 查询失败（附原因）。
取不到就是取不到，不会显示一个假的 0。
- 进入即刷新：面板挂载时自动拉一次；右上角另有「刷新」按钮。宿主侧 5 秒内复用快照并合并并发请求，连点刷新不会打爆上游接口。

支持的服务商

| provider id | 余额来源 | 展示 |
| opencode-go | GET https://opencode.ai/zen/go/v1/usage | 5 小时 / 周 / 月 三窗口 |
| commandcode | GET https://api.commandcode.ai/alpha/（whoami / credits / subscriptions / usage） | 月额度（含剩余金额），有 windowLimits 时补 5 小时 / 周窗口 |
| deepseek-official、deepseek | GET https://api.deepseek.com/user/balance | 账户金额 |
| deepseek-account | ctx.deepseekAccount.getBalance()（无 API Key，走登录态） | 账户金额 |

没有余额接口的服务商不会从面板上消失：卡片会写明「不支持查询」。
加一个服务商只需要在 index.js 的 PROVIDERS 里加一条定义（id + 凭证引用 + 取数函数），浏览器半侧不用动。

deepseek-official 与 deepseek-account 是两条独立路由，按各自账户算钱，金额通常不相同：前者扣 API Key 所属的开放平台账户，后者扣你在 DSH 里登录的账号。

安装

应用内（推荐）：设置 → 插件 → 从 Git / 本地目录安装，填入本仓库地址或本地路径。

命令行：

dsh plugin --profile <你的 profile> add "git+https://github.com/qianhuang0721/dsh-model-balance-panel.git#v0.1.0"

桌面端请用应用自己的插件管理器安装，profile 名一般是 desktop；dsh web 通常是 web。
安装后刷新页面即可看到左栏图标，无需构建步骤——本包没有依赖，也没有安装脚本。

使用

1. 点左侧栏的钱包图标 → 面板自动刷新一次。
2. 卡片按 DSH 里实际注册的服务商生成：DSH 的模型选择器里有什么，这里就有什么。
3. 看到「未配置凭证」：到 设置 → 模型 里给该服务商填 API Key（凭证名见下表）；填完回面板点「刷新」。

| 服务商 | 需要的凭证（环境变量名 / DSH 凭证引用） |
| opencode-go | OPENCODE_GO_API_KEY |
| commandcode | COMMANDCODE_API_KEY |
| deepseek-official | DEEPSEEK_API_KEY |
| deepseek-account | 无，登录 DSH 账号即可 |

工作原理

浏览器（client.js） 宿主（index.js） sidebar.panellist 图标 ──点击──▶ main 面板 │ │ └── GET /dsh-model-balance-panel/snapshot ──▶ 组装快照 ├─ ctx.llm.listProviders() / listModels() ├─ agentDefaultModel.currentSelection() ├─ ctx.credentials.resolve(凭证引用) └─ 各服务商账户接口（Bearer，20s 超时 + 重试）
- 服务商与模型清单取自 DSH 自己（ctx.llm.、agentDefaultModel），所以面板不会凭空出现 DSH 里没有的模型。
- 凭证只用于一次上游请求：经 ctx.credentials.resolve() 解析，解析不到才回落到进程环境变量； API Key 不进响应、不进页面、不落盘。
- 快照路由只返回数字，与页面同源，未额外加鉴权；GET-only，no-store。

目录结构

index.js 宿主半侧：GET /dsh-model-balance-panel/snapshot（5 秒复用，?force=1 强刷） client.js 浏览器半侧：sidebar.panellist 图标 + main 面板（进入即刷新） cordis.patch.yml bundle patch：插入本插件行（行 id 与包名一致） locale/zh.json 插件页显示的中文标题与描述 locale/en.json 英文标题与描述 icon.svg 插件图标

兼容性

- DSH >= 0.2.1-rc.3（写在 package.json 的 engines.dsh；在 0.2.1-rc.3 上实测）。
- Node.js >= 22.12.0（用到全局 fetch 与 AbortSignal.timeout）。
- 只依赖 DSH 的公开扩展点：ctx.webServer、ctx.llm、ctx.credentials、agentDefaultModel，以及浏览器侧的 ctx.slots / ctx.locale。不 import 任何 @deepseek-ai/* 运行时包，所以 DSH 升级不会因为 peer 依赖对不上而整行消失。

开发

node --check index.js && node --check client.js

宿主半侧改动需要把插件行关闭再开启（或重启 DSH）；浏览器半侧改动刷新页面即可。
新增服务商：在 index.js 的 PROVIDERS 里加一条，并在上面的表格里补一行。

隐私

本插件只读取余额与额度数字，不读取对话、不采集遥测、不发送任何统计数据。
上游请求只包含鉴权头与必要的查询参数。

致谢

余额窗口的接口口径与解析思路参考了 dsh-pet（MIT）。

License

MIT © 2026 qianhuang0721