前言¶
使用 DSH 做智能体开发时，模型选择器里可能同时出现 DeepSeek、StepFun、Kimi Coding、OpenRouter、MiniMax、xAI / Grok 等多个供应商的模型。模型可以调用，不代表当前账户还有足够余额或配额；如果每次都去对应控制台查看，会打断开发流程。
dsh-model-balance 是一个 DSH Web GUI 插件，由 nabin-qq273274877 维护，采用 MIT 许可。它在 composer 的模型选择器前显示余额胶囊，把当前供应商的真实账户余额或配额直接展示在模型切换的位置。
插件定位¶
dsh-model-balance 解决的问题很具体：为 DeepSeek Harness Web GUI 在模型选择器前显示多供应商真实账户余额与配额。
它不做模型代理，也不改变模型调用链路，只在 DSH Web GUI 的模型选择区域增加一个余额展示入口。对于有 API 余额或配额接口的供应商，插件直接查询并展示结果；对于没有 API 余额接口的供应商，插件提供控制台入口。
支持范围¶
下面按查询方式分类。
可通过 API 查询的供应商¶
这些供应商支持通过官方余额或配额接口查询：
- DeepSeek
- StepFun
- Kimi Coding
- OpenRouter
- MiniMax
- xAI / Grok
其中，Kimi Coding 会展示配额信息，而不是单纯的金额余额。
需要登录查看的供应商¶
以下供应商没有 API 余额接口，需要登录后查看：
- 通义 Token Plan
- 小米 MiMo
在插件界面中点击对应胶囊后，会在新页面打开对应控制台。
暂不支持¶
以下供应商暂不支持：
- Mistral
- Groq
- Cohere 等
余额刷新¶
插件会在以下时机刷新余额：
- 切换模型后，立即显示该供应商的余额。
- 对话结束后，绕过缓存强制刷新。
- 每 2 分钟进行一次定时轮询。
- 点击胶囊时，绕过缓存强制刷新。
宿主路由会缓存查询结果：
- 成功结果缓存 60 秒。
- 失败结果缓存 15 秒。
对话结束和点击胶囊这两个动作会绕过缓存，用于确认最新状态。
安装与启用¶
通过 GitHub 安装插件：
npx @deepseek-ai/dsh plugin --profile web add github:nabin-qq273274877/dsh-model-balance
也可以使用 npm 包名安装：
npx @deepseek-ai/dsh plugin --profile web add dsh-model-balance
如果是本地开发，也可以使用 link 方式：
npx @deepseek-ai/dsh plugin --profile web add link:/path/to/dsh-model-balance
安装完成后，重启 dsh web 并刷新页面。
如果需要卸载：
npx @deepseek-ai/dsh plugin --profile web remove dsh-model-balance
自定义供应商¶
如果内置列表中没有你的供应商，可以通过配置文件添加。
支持两个位置：
- 编辑插件目录中的
providers.json。 - 创建
~/.dsh/model-balance-providers.json。
操作步骤：
- 编辑插件目录中的
providers.json，或创建~/.dsh/model-balance-providers.json。 - 在配置中添加供应商。
- 修改供应商配置后，重启
dsh web并刷新页面。
注意事项¶
- 插件会注册到 dsh web 宿主，并以当前 dsh 进程权限运行；安装前建议检查源码与许可证。
- 宿主路由负责解析凭据并查询计费 API，API Key 不会到达浏览器。
- 通义 Token Plan 和小米 MiMo 需要登录查看，无 API 余额接口。
- Mistral、Groq、Cohere 等暂不支持。
结尾¶
dsh-model-balance 适合在 DSH Web GUI 中同时使用多个模型供应商、并且希望在不离开工作区的情况下查看余额或配额的开发者。
插件入口：
- 目录页：https://www.skillhub.cn/plugins/nabin-qq273274877/dsh-model-balance
- GitHub：https://github.com/nabin-qq273274877/dsh-model-balance
