在 DeepSeek Harness (DSH) 的使用場景中，智能體開發者往往需要同時管理多個 AI 服務的訂閱配額與賬戶餘額。手動查看各平臺的賬戶狀態會打斷工作流。dsh-ai-quota 插件提供了一站式的配額監控方案，將不同服務的狀態整合到一個界面中。
這是一個由 Carrick-K7 維護的 DeepSeek Harness 插件，支持 Codex、Kimi、GLM Coding Plan、DeepSeek、302.AI 和 OpenCode Go。它通過統一的格式展示訂閱窗口或餘額信息，並提供自動刷新與可視化的管理功能。
核心功能¶
該插件提供以下能力：
- 模型工具
query_ai_quota：在任意智能體會話中調用該工具，即可獲取配額摘要。 - 設置頁面：在“AI Quota”設置頁面中，按窗口展示使用情況條形圖和餘額，支持手動刷新。
- 每提供商可見性：設置頁面的標題欄包含一個齒輪按鈕，可打開二級設置，通過開關控制每個提供商的顯示狀態。
- Composer 芯片：在新建對話頁面和會話中，根據當前選定的提供商路由（而非模型 ID）顯示一行配額指示器。
- 自動刷新：支持可配置的自動刷新間隔，默認爲 2 分鐘，也可設置爲 0 以禁用。
- 統一格式：不同提供商的數據被歸一化爲訂閱窗口或餘額條目，單個提供商的故障不會影響其他提供商的顯示。
- 皮膚感知調色板：所有讀數顏色使用 CSS 變量定義。加載特定主題（如 dsh-miku-skin）時，芯片和使用情況條形圖會呈現相應的主題色。
- 無密鑰泄露：插件設計保證 API 密鑰和令牌絕不會出現在工具輸出或日誌中。
安裝與啓用¶
在終端中執行以下命令安裝插件。該命令會自動將插件行追加到 dsh.profile.bundles，安裝完成後請重啓 dsh web。
dsh plugin --profile web add github:Carrick-K7/dsh-ai-quota
典型用法¶
安裝完成後，可以通過以下方式使用：
- 會話查詢：在任何智能體會話中，調用
query_ai_quota工具，即可獲取當前所有提供商的配額摘要。 - 設置頁面查看：在 DSH 的設置頁面中找到“AI Quota”區域，可以手動刷新並查看各服務的餘額和使用情況條形圖。
- Composer 芯片查看：在新建聊天頁面，根據當前選中的模型路由，芯片會自動顯示對應提供商的配額狀態。
- 提供商管理：在設置頁面的“AI Quota”標題欄點擊齒輪按鈕，開啓或關閉特定提供商的顯示。
適用場景與注意¶
- 多服務管理：適合同時使用 Codex、Kimi、GLM、DeepSeek、302.AI 或 OpenCode Go 等多個服務的 DSH 用戶。
- 本地憑證：Codex 和 Kimi 使用本地 CLI 登錄狀態，無需在插件中輸入 API 密鑰。
- 依賴要求：運行該插件需要宿主環境安裝 React、Cordis 以及其他對等依賴項。
- 數據安全：插件通過 DSH 的憑證機制（
DEEPSEEK_API_KEY等）獲取密鑰，且絕不會將密鑰寫入輸出或日誌。
總結¶
dsh-ai-quota 通過工具、設置頁面和 Composer 芯片三個維度，爲 DSH 用戶提供了直觀、自動化的多平臺配額管理能力。所有顯示的餘額數據均來自各服務官方接口，且遵循統一的格式與皮膚規範。
