前言¶
DeepSeek Harness (DSH) 采用插件化架构。在管理多个 API Key 或编程套餐时，快速查看各渠道的剩余额度是常见需求。dsh-balance-inquiry 插件在 DSH 左侧边栏底部提供余额看板，支持原生接口、编程套餐（Token Plan）及自定义脚本适配。
安装与启用¶
安装插件后需重启 DSH 桌面端或 dsh web 才能加载配置。
dsh plugin --profile desktop add dsh-balance-inquiry
重启后，侧边栏底部会出现余额行。
核心功能¶
原生余额接口¶
支持直接查询多家厂商的余额数据。
* 按量计费：New API / One API、DeepSeek、StepFun、SiliconFlow（国内 / 国际）、OpenRouter、Novita AI。
* 编程套餐（Token Plan / Coding Plan）：支持 8 家厂商，查询每个时间窗口（5小时 / 周 / 月）的已用与剩余百分比。
自定义脚本¶
对于不直接支持原生接口的站点，可通过自定义脚本适配。
脚本允许使用 {{baseUrl}}、{{apiKey}}、{{accessToken}}、{{userId}} 等占位符。extractor 函数需返回对象或数组，包含 planName、remaining、used、total、unit、isValid 等字段。脚本仅允许 HTTPS（localhost 除外）。
侧边栏看板¶
侧边栏默认显示所有套餐中最紧急（额度最少或当前供应商匹配）的那一项。
* 查看详情：左键点击余额行，打开看板详情页，显示所有套餐的卡片（名称、余额、时间）。
* 跳转官网：左键点击看板中的卡片，打开该套餐绑定的官网地址。
容错与联动¶
- 请求方式：默认由 DSH 宿主进程发出，不受浏览器跨域限制。若宿主通道不可用，自动回落浏览器直连。
- 瞬时失败：网络错误或超时时，保留上次成功的值 10 分钟，避免余额显示闪烁。
- 供应商联动：绑定供应商 ID 后，在 DSH 中切换模型时，侧边栏自动显示对应供应商的套餐余额。
配置与使用¶
添加套餐¶
进入 设置 → 余额查询。插件不预设任何站点，需手动添加。
1. 点击「添加套餐」。
2. 选择「按量计费（API Key）」或「Token Plan / Coding Plan」。
3. 选择厂商（如 New API、DeepSeek 等）。
4. 填写必要的参数（接口地址、令牌、用户 ID 等）。
5. 可选配置：官网地址、供应商 ID（用于模型切换联动）、额度换算比例（仅 New API）。
New API 配置要点¶
- 令牌：需使用控制台「系统访问令牌」，而非 API Key。
- 换算比例：默认为 500000（即 1￥ = 500000 quota）。按积分/credits计的套餐不显示该字段。
- 接口地址：默认
GET {baseUrl}/api/user/self。
编程套餐配置要点¶
- 端点：各家厂商有特定端点（如 Kimi, 智谱 GLM, MiniMax 等）。
- 超时：编程套餐请求超时统一为 15 秒。
- 显示：仅显示百分比，剩余不足 10% 时变黄。
- 火山方舟：先查 Agent Plan，无活跃订阅则回落查 Coding Plan。
注意事项¶
- 脚本安全：自定义脚本仅允许 HTTPS（
localhost除外）。 - 颜色反馈：余额仅在为 0 时变红；编程套餐仅显示百分比，不做剩余不足 10% 的黄色预警。
- 依赖重启：安装或修改配置后，必须重启 DSH 才能生效。
总结¶
该插件通过侧边栏快速展示多渠道余额，支持原生接口与自定义脚本，配合宿主进程请求解决了跨域问题，适合需要管理多个 API Key 或编程套餐的开发者。
- GitHub: https://github.com/Deanyu148/dsh-balance-inquiry
- SkillHub 目录: https://www.skillhub.cn/plugins/Deanyu148/dsh-balance-inquiry
