在使用 DeepSeek Harness (DSH) 进行开发时，经常需要确认当前模型的余额或配额。手动切换到服务商官网查看既繁琐又打断思路。dsh-model-balance 插件旨在解决这一问题，它能在 DSH 的 composer 输入行直接展示余额或配额，无需离开当前页面。
这是一个由 jacujay 维护的插件，通过自动识别当前模型供应商，并在输入行左侧显示余额/配额按钮。支持多种主流服务商，并提供设置页面支持自定义端点。
核心功能¶
- 自动供应商检测：读取 DSH 配置中的 provider id 或 baseURL hostname 识别供应商，即使使用自定义 provider id 也能匹配。
- 多供应商支持：内置 DeepSeek、Moonshot/Kimi、MiniMax、StepFun、Zhipu（仅配额）、SiliconFlow、OpenRouter。
- 输入行交互：在模型名称前显示图标，悬停查看详情，点击刷新。
- 主机端 Key 安全：API Key 由本地 DSH 主机处理，不进入浏览器，确保隐私安全。
- 自定义端点：支持为不支持公开余额接口的供应商配置自定义查询地址。
安装与启用¶
- 确保已安装 DSH Web。
- 执行以下命令安装插件：
dsh plugin --profile web add github:jacujay/dsh-model-balance
- 安装完成后，刷新浏览器页面即可生效。
典型用法¶
基础使用¶
在 DSH 的 composer 输入行模型名左侧会出现 ◈ 图标。鼠标悬停可查看当前的余额或配额，点击图标可刷新数据。
配置 New API 兼容代理¶
如果使用 New API 中转服务，可在插件设置中添加自定义端点以识别其返回的 token_usage。
进入 Settings → Balance lookup，为对应的 DSH provider（通常是 openai）配置以下参数：
- URL:
https://your-relay.example.com/api/usage/token - Response path:
data.total_available - Authentication:
Bearer Token - Display name: 可选
插件会自动识别 New API 的 token_usage 响应格式。如果响应中包含 unlimited_quota: true，将显示无限配额，否则显示剩余额度、总授予额度和已使用量。
适用场景与注意¶
- 适用场景：适合使用 DSH Web 进行日常开发、调试，需要频繁查看资源使用情况的用户。
- 安全机制：所有余额查询请求均由本地 DSH 主机发起，使用的是 DSH 中的凭证，API Key 不会发送到浏览器或第三方服务器。
- 隐私注意：插件设置文件仅存储端点元数据（
~/.dsh/dsh-model-balance.json），不包含任何密钥。自定义端点 URL 由用户提供，请确保指向可信地址。 - 许可证：插件基于 MIT 许可证开源，安装前建议检查源码。
总结¶
通过此插件，可以将余额查询集成到开发工作流中，减少上下文切换。项目位于 GitHub。
