dsh-model-balance
在 DeepSeek Harness Web 界面中实时显示 DeepSeek 账户模型余额的插件。
插件在会话页头部（标题下方）显示一个余额胶囊：当前总余额、更新时间点、 状态圆点（绿 = 正常 / 黄 = 获取中 / 红 = 失败），并带一个手动刷新按钮。 把鼠标悬停在胶囊上可以看到充值 / 赠送余额的明细。
工作原理
- 宿主端（
lib/index.js）：每intervalMs（默认 60 秒）用配置的凭证
调用 GET {baseURL}/user/balance，缓存快照，并通过 webServer 注册一个 exact 路由 /api/model-balance 提供给浏览器。该接口永远不会暴露 API Key。
- 浏览器端（
lib/client.js）：每 30 秒轮询该路由（页面重新可见时立即
刷新），把快照渲染到 conversation.session.header.utilities 插槽。
凭证解析与官方 DeepSeek LLM 适配器一致：先走 credentials 服务（Web 的 「模型」设置页写入的 Key，即 $DSH_HOME/.credentials.yaml），再回退到启动 环境变量 DEEPSEEK_API_KEY。DEEPSEEK_BASE_URL 可覆盖 API 地址。
安装
# 在 dsh-model-balance 目录外执行；pnpm 由 dsh plugin 转发
dsh plugin --profile web add <dsh-model-balance 的绝对路径>安装后重启 Web 服务（dsh web）并刷新页面即可生效：
# 先停掉正在运行的 dsh web，然后
dsh web配置
编辑 $DSH_HOME/profiles/web/cordis.patch.yml 覆盖行配置：
- id: model-balance
config:
intervalMs: 30000 # 宿主刷新间隔（毫秒），最小 5000
apiKeyEnv: DEEPSEEK_API_KEY
baseURL: https://api.deepseek.com验证
- 接口：
curl http://127.0.0.1:3080/api/model-balance应返回
{"state":"ok","data":{...},"fetchedAt":...}。
- 组成检查：
dsh --profile web --dump-config中应包含model-balance行。
说明
- 默认绑定为
127.0.0.1，余额接口只返回余额数据；如需更严格的访问控制，
可自行在宿主端加鉴权。
- 移除插件：
dsh plugin --profile web remove dsh-model-balance，然后重启。