DeepSeek Harness (DSH) 採用插件化架構，允許用戶在 Web UI 中擴展功能。在使用 CLIProxyAPI (CPA) 等代理進行開發或調試時，直觀地查看當前模型或賬戶的剩餘配額並不直觀。dsh-client-ui-cpa-quota 插件通過在模型選擇器旁提供可視化環，解決了這一痛點。
插件介紹¶
- 名稱：dsh-client-ui-cpa-quota
- 所有者：wkscc310
- 類別：聯網工具
- 許可：MIT
核心功能¶
該插件在瀏覽器端運行，利用 DSH 提供商的配置自動發現模型和接口地址，無需維護額外的模型列表。
- 自動發現與識別：讀取 DSH providers 中的 models 和 baseURL 值。插件會對每個 baseURL 進行指紋識別，確認爲 CLIProxyAPI，避免在普通 OpenAI 兼容端點上顯示空環。
- 多實例與賬戶支持：支持多個 CLIProxyAPI 實例和賬戶。懸停工具提示會根據選定的模型進行過濾，而設置面板始終顯示所有賬戶的配額。
- 配額窗口邏輯：配額窗口按 5小時 → 周 → 月 → 日 排序，環顯示會優先使用第一個可用的窗口。
- 上游查詢：支持通過上游配額 API 查詢 Codex、Claude、Antigravity、Gemini CLI、Kimi 和 xAI/Grok 的配額。對於其他 CPA 提供商，插件仍會顯示賬戶狀態和近期活動。
- 使用中檢測：插件通過 CPA 的每請求使用隊列構建本地 7 天賬本。在刷新週期內，懸停工具提示會顯示實際爲選定模型提供服務的賬戶（按最後使用時間排序，並帶有使用中標記和請求數/令牌數統計），其餘賬戶摺疊至“Other accounts”。
- 穩定性與容錯：賬戶探針運行在有界池中，具備每請求超時機制，防止單個上游掛起阻塞整個刷新週期。插件會保留刷新失敗前的最後成功快照，並在 DSH 屏幕重掛載時重用環。
- 視覺反饋：配額顏色根據剩餘量變化：綠色（≥20%）、琥珀色（<20%）、紅色（耗盡/錯誤）、灰色（加載中或缺少管理密鑰）。
安裝與啓用¶
通過官方命令行工具安裝並激活插件：
dsh plugin --profile web add dsh-client-ui-cpa-quota
安裝完成後，重啓 DSH Web 主機，然後在界面中打開：
* 設置 → 插件 → CliProxyAPI Quota。
在展開的設置卡片中，爲每個實例粘貼管理密鑰。
配置與注意事項¶
- 密鑰存儲：在設置卡片中輸入的密鑰存儲在當前瀏覽器的
localStorage中。如果通過 YAML 管理密鑰，則存儲在 YAML 文件中。瀏覽器設置卡片會覆蓋 YAML 配置。 - 刷新間隔：
refreshMinutes會被限制在至少一分鐘。 - 安全性：切勿將管理密鑰提交到公開倉庫。
依賴與限制¶
- DSH 版本：插件要求當前插件契約使用 DSH Web profile（已驗證版本：0.1.1-rc.2, 0.1.2-rc.1, 0.1.5-rc.2, 0.1.6-alpha.1）。
- 網絡依賴：需要可訪問的 CLIProxyAPI 實例，且該實例的管理 API 已啓用。
- 註冊範圍：該插件僅在 Web UI 中註冊。
總結¶
dsh-client-ui-cpa-quota 爲 DSH Web UI 提供了一個輕量級的配額監控方案，適合需要同時管理多個 CLIProxyAPI 實例和賬戶的用戶，能夠快速定位當前可用資源。
