前言¶
在使用 DeepSeek Harness (DSH) Web 進行多模型管理時，手動檢查不同 Provider 的餘額和健康狀態會消耗大量時間。dsh-balance-quota 插件將餘額查詢、配額監控以及外部模型健康監測集成到 DSH Web 的界面中，直接在聊天界面的下方展示狀態信息。
是什麼¶
這是一個由 kongshan-zhuyu 維護的模型推理插件，旨在爲 DSH Web 提供可視化的 Provider 餘額和健康監控能力。
- 核心功能：支持官方預設、自定義 HTTP 接口、JSON 數據提取與轉換、以及模型健康狀態監測。
- 開源協議：MIT
- 適用場景：需要統一管理多個 API Provider、需要監控模型可用性及響應時間（TTFT/延遲）的開發者。
核心功能¶
插件通過界面下方的狀態欄和獨立配置頁，實現以下能力：
餘額與配額管理¶
- 官方預設：內置 DeepSeek 餘額和 OpenCode Go 的滾動/每週/每月配額查詢。
- 自定義接口：支持 Public HTTPS、無 Body 的 POST 請求，可配置自定義 Headers、超時時間和刷新間隔。
- JSON 提取：支持屬性路徑、數組索引、可選鏈，並提供最多 5 個
??後備值。 - 金額處理：支持靜態/動態貨幣、金額除數配置，並提供“未保存草稿測試”功能。
界面與交互¶
- 狀態欄：在聊天編輯器下方顯示餘額、更新時間、強制刷新按鈕及健康監測圖標。
- Provider 選擇：支持默認 Provider 設置、行內切換 Provider，並記憶每個對話的上下文選擇。
- 模型設置：管理模型 ID/顯示名、上下文窗口、文本/圖片輸入能力及推理等級。
- 可視化綁定：選擇預覽槽位後，直接從 JSON 樹中選擇字段，預覽實時更新。
- 全模型預覽：無需額外請求即可預覽多達 50 個模型的當前映射關係。
健康監測¶
- 外部監控：通過外部 JSON API 監控狀態、可用性、TTFT（首字生成時間）、響應時間及歷史記錄。
- 轉換與格式化：支持文本、數字、百分比、狀態值的轉換。支持自定義狀態值映射、數值精度（0-2位小數）及單位顯示。
- 自定義指標：可監控錯誤率、空響應、常見錯誤或任意模型指標。
安全與性能¶
- 緩存機制：共享 Host 餘額緩存、健康預覽緩存，在插件隱藏時自動暫停刷新。
- 憑證安全：複用 DSH 憑證引用，API 密鑰不會直接進入瀏覽器配置。
- 網絡防護：支持 Public HTTPS、DNS 綁定、重綁定保護，以及阻止私有 IP 和重定向訪問。
安裝與啓用¶
環境要求¶
- Node.js 22+
- DSH CLI
安裝步驟¶
- 使用 DSH CLI 安裝插件：
dsh plugin --profile web add dsh-balance-quota
- 安裝或升級後，需重啓
dsh web進程：
dsh web
- 驗證安裝是否成功：
dsh plugin --profile web list
配置與使用¶
- 打開 Settings → Plugins → Plugin configuration → 供應商狀態。
- 在此處配置餘額查詢、Provider 編輯、高級設置、默認 Provider 以及聊天狀態欄。
- 點擊 編輯 配置自定義餘額 API，或使用官方預設。
- 高級設置 包含 模型設置 和 健康監測。
- 在健康監測中，啓用監控後測試外部 JSON 接口，並使用 預覽全部模型 驗證所有映射關係。
注意事項與適用場景¶
- 版本兼容性：
- 插件開發版本爲 0.3.5，NPM 發佈版本爲 0.3.3。
- 若使用 DSH 0.3.4，需搭配 DSH 0.1.5-rc.1 或更新版本（
@deepseek-ai/dsh-settings≥0.1.5-rc.2）。 - 若使用 DSH 0.1.4 及更早版本，請使用插件版本 0.3.3。
- 源碼審查：插件以 DSH 進程權限運行，請在使用前檢查源碼與許可證（MIT）。
- 生態說明：本插件屬於社區目錄中的獨立項目，與 DeepSeek / 幻方無官方從屬關係。
總結¶
dsh-balance-quota 解決了在 DSH Web 中分散管理餘額和模型健康狀態的問題。通過可視化的綁定、轉換和緩存機制，它爲開發者提供了一個安全、高效的後臺監控解決方案。
- 插件目錄: https://www.skillhub.cn/plugins/kongshan-zhuyu/dsh-balance-quota
- 源碼倉庫: https://github.com/kongshan-zhuyu/dsh-balance-quota
