前言¶
使用 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
