在使用 DeepSeek Harness (DSH) 進行智能體開發或日常調用時，實時掌握賬戶餘額與 Token 消耗情況是調試和計費的基礎。手動查詢接口或查看日誌往往不夠直觀。下面介紹 dsh-plugin-quota，一個能將 DeepSeek 賬戶額度與會話用量直接掛載到 DSH Web 設置界面的插件。
這是什麼¶
插件名稱爲 dsh-plugin-quota，由 ArvenWang 維護。它是一個獨立的安裝插件，核心價值在於將原本需要額外查詢或從日誌中獲取的數據，一鍵接入 DSH 的 Web 設置界面，實現餘額與用量的可視化監控。
核心功能¶
插件提供兩類監控視圖：
-
賬戶額度
實時查詢 DeepSeek 賬戶餘額。支持按幣種展示總額度、贈送額度與充值額度。具備可用性狀態徽標（可用/不可用），並包含完整的加載、失敗與重試狀態。若失敗，會明確提示原因（如未配置 Key、HTTP 錯誤等）。 -
Token 用量
統計當前會話的累計消耗。將數據分爲未緩存輸入、輸出、緩存讀取、緩存寫入四個獨立桶，並顯示合計值。行內展示使用緊湊的 k/M 格式，懸停可查看精確數值。數據源爲 harness 的tokenUsage投影，隨會話實時更新。
安裝與啓用¶
使用官方命令安裝到 Web Profile：
dsh plugin --profile web add dsh-plugin-quota
安裝完成後，需要重啓 dsh web（或重啓桌面 App），並在設置界面找到“額度”分區查看。
典型用法¶
在使用前，需確保已配置 DeepSeek API Key。可以通過環境變量 DEEPSEEK_API_KEY 設置，或在 設置 → 模型 頁面配置。進入設置 → 額度後，即可看到賬戶餘額狀態及當前會話的 Token 消耗明細。
適用場景與注意¶
- 環境要求：DeepSeek Harness 版本需 >= 0.1.0-rc.5（Web profile）。
- 兼容性：需提供有效的 DeepSeek API Key。若使用自定義 OpenAI 兼容端點，該端點必須支持
/user/balance路由，否則會顯示 HTTP 錯誤。 - 安全機制：該插件遵循 DSH 的安全原則。路由僅只讀，API Key 不經過瀏覽器傳輸，全部留在宿主進程內，不會落盤或寫入日誌。
- 開發細節：插件零構建、零運行時依賴（僅 peer 依賴）。代碼可直接運行，主要依賴 Harness 官方包。
結尾¶
通過接入 dsh-plugin-quota，開發者可以在日常使用 DSH Web 界面時，無需離開設置頁面即可掌握資源狀態與消耗情況。其 MIT 許可證允許自由使用與修改。更多詳情或源碼，可參考項目倉庫：https://github.com/ArvenWang/dsh-plugin-quota
