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