dsh-commandcode-quota：DeepSeek Harness 的 Command Code 餘額與配額面板

前言¶

在使用 DeepSeek Harness (DSH) 進行開發或交互時，實時監控 Command Code 的賬戶餘額以及配額窗口（5 小時、每週、每月）的使用情況非常重要。dsh-commandcode-quota 插件通過在 DSH Composer 下方渲染一個緊湊的狀態行，解決了這一需求，讓配額監控無需離開主界面。

插件介紹¶

該插件由用戶 fuqiancheng 維護，是一款單賬戶設計的狀態面板工具。

它不會在瀏覽器中接收或存儲 API Key，所有憑證處理均在本地進程中進行。插件會在 DSH 界面上顯示餘額，並以實時百分比展示 5 小時、每週和每月的使用窗口。點擊狀態行可展開查看詳細的賬單、Token 使用量、成功率、訂閱信息及賬戶詳情。

安裝與啓用¶

基礎安裝¶

推薦從 npm 安裝：

dsh plugin add dsh-commandcode-quota

DSH 會自動將打包的 cordis.patch.yml 擴展到你的配置中，無需手動編輯補丁文件。

本地開發安裝¶

如果從本地代碼倉庫安裝：

dsh plugin add file:/path/to/dsh-commandcode-quota

桌面應用手動安裝¶

Electron 桌面應用的管理方式與 Web 客戶端不同，dsh plugin add 命令不會自動處理插件的掛載。你需要手動創建 Junction 並編輯配置文件。

創建 Junction
在 PowerShell 中執行以下命令，將本地包鏈接到 DSH 的共享解析池：

   New-Item -ItemType Junction `
     -Path "$env:USERPROFILE\.dsh\profiles\node_modules\dsh-commandcode-quota" `
     -Target "C:\path\to\dsh-commandcode-quota"

配置補丁
編輯 ~/.dsh/profiles/<profile>/cordis.patch.yml，添加以下內容：

   - insert:
       - id: dsh-commandcode-quota
         name: 'dsh-commandcode-quota'
         config:
           apiKeyEnv: COMMANDCODE_API_KEY

注意：Junction 的名稱必須與包名完全一致，否則宿主無法解析導入。

安裝或修改插件後，請刷新插件樹（在插件頁面點擊刷新，或重啓客戶端）。

配置說明¶

插件依賴 Command Code 的 API Key，該 Key 通過 DSH 的憑證服務解析，不會暴露給瀏覽器。

配置項	默認值	說明
`apiKeyEnv`	`COMMANDCODE_API_KEY`	憑證解析的環境變量名
`fallbackEnv`	—	當第一個變量缺失時使用的備用環境變量名（可選）
`baseURL`	`https://api.commandcode.ai`	Command Code API 的基礎地址
`timeoutMs`	`30000`	單次請求的超時時間（毫秒）

憑證文件位於 ~/.dsh/.credentials.yaml 或在 DSH 設置 → 憑證中管理。切勿將包含憑證的文件提交到版本控制系統。

功能特性¶

狀態行展示
在 Composer 下方渲染一個緊湊的狀態行，實時顯示可用餘額以及 5 小時、每週、每月的使用率百分比。
展開詳情
點擊狀態行可展開詳細數據面板，包含：
* 已使用/限制/剩餘額度及重置時間
* 總花費
* Token 統計
* 成功率
* 訂閱狀態
* 賬戶信息
安全設計
* 單賬戶設計，無賬戶切換器。
* API Key 僅在本地進程內存中讀取，絕不發送至瀏覽器端。

工作原理¶

插件採用“主機-客戶端”分離架構：

主機端：負責解析憑證，註冊一個只讀的 HTTP 端點，將請求轉發至 Command Code API，並將結果聚合爲單一 Payload。
客戶端：將狀態行注入到 DSH 的 Dock Slot 中，定時輪詢主機端點，並根據 DSH 的主題 Tokens 進行渲染，確保適配淺色/深色模式。

數據來源於四個 Command Code API 端點：
* /alpha/billing/credits：餘額及 5 小時/每週限制
* /alpha/usage/summary：花費、Token 及成功率
* /alpha/billing/subscriptions：訂閱狀態及週期
* /alpha/whoami：賬戶信息

故障處理策略¶

插件在請求異常時的行爲如下：

並行請求：四個 API 請求並行執行，總延遲取決於最慢的那個，而非總和。
重試機制：連接層失敗會重試一次；超時請求不重試。
緩存回退：當所有請求失敗時，面板會顯示最後一次成功獲取的數據（在進程內存中保留 6 小時），並標記爲過期。
錯誤提示：HTTP 401（認證失敗）不會使用緩存數據，會立即提示錯誤，確保用戶能發現 Key 配置問題。

注意事項¶

環境要求
* 需要運行 DeepSeek Harness 的 Web 客戶端（dsh web）或桌面應用。
* 本地需要安裝 Node.js 20 或更高版本。
* 需要有效的 Command Code API Key。
桌面應用特殊說明
桌面應用默認不運行 dsh plugin add 的同步邏輯，因此必須按照上述“桌面應用手動安裝”章節中的步驟手動配置 Junction 和 cordis.patch.yml。
許可證
本插件遵循 MIT 許可證，開源託管在 GitHub。安裝前建議檢查源碼以確保符合你的項目需求。