模型余额面板 · 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。
安装后刷新页面即可看到左栏图标，无需构建步骤——本包没有依赖，也没有安装脚本。
使用
- 点左侧栏的钱包图标 → 面板自动刷新一次。
- 卡片按 DSH 里实际注册的服务商生成：DSH 的模型选择器里有什么，这里就有什么。
- 看到「未配置凭证」：到 设置 → 模型 里给该服务商填 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
