在使用 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。
