dsh-commandcode-usage：CommandCode 用量與餘額面板

DSH（DeepSeek Harness）通過插件機制擴展功能。在開發或使用過程中，第三方 API 資源（如 CommandCode）的用量與餘額管理往往需要打開網頁或單獨的儀表盤。dsh-commandcode-usage 插件解決了這一痛點，將 CommandCode 的 API 用量、信用額度及週期性統計直接集成到 DSH 的側邊欄中。

該插件由 zouxiaoyang 開發，開源協議爲 MIT。它提供了一個精緻的卡片式面板，用於實時監控 API 消耗情況。

核心功能¶

插件在側邊欄底部提供統一的入口，主要包含以下數據展示與交互能力：

• 側邊欄入口：在側邊欄底部、設置按鈕左側顯示「⚡ 用量」按鈕。點擊即可彈出面板，收起側欄時自動顯示圖標。
• 用量概覽：顯示請求次數、成功率、Token 消耗及總花費。
• 額度週期：可視化展示月額度、5小時窗口和每週窗口。進度條直觀顯示剩餘空間。
• 重置時刻：每個週期下方標明重置時間（如「重置 今天 23:59」），便於規劃使用。
• 賬戶信息：顯示套餐信息、訂閱狀態及計費週期。
• 界面適配：精緻卡片 UI（漸變 header、套餐徽章、彩色百分比膠囊），並跟隨 DSH 的淺色/深色主題自動切換。
• 計費邏輯：月額度按當前計費週期統計，不結轉至下個週期。

安裝與啓用¶

通過 DSH 的命令行工具進行安裝。確保你的環境已安裝 DSH 並配置好對應 Profile。

dsh plugin --profile web add dsh-commandcode-usage

安裝完成後，重啓 DSH 或刷新頁面即可生效。

配置¶

插件通過 cordis.patch.yml 的 config 字段進行配置。默認情況下，它會嘗試自動讀取配置。

- id: dsh-commandcode-usage
  name: 'dsh-commandcode-usage'
  config:
    # API key（可選，默認自動從環境變量/配置文件讀取）
    apiKey: 'your-commandcode-api-key'
    # API 基礎地址（可選，默認官方）
    apiBase: 'https://api.commandcode.ai'
    # 環境變量名（可選，默認 COMMANDCODE_API_KEY）
    apiKeyEnv: 'COMMANDCODE_API_KEY'

API Key 解析優先級¶

插件按以下順序查找 API Key：

1. 插件 config.apiKey
2. 環境變量（默認 COMMANDCODE_API_KEY）
3. ~/.dsh/.credentials.yaml 中的 COMMANDCODE_API_KEY
4. launchctl getenv COMMANDCODE_API_KEY
5. 其他常見配置文件

使用方式¶

啓用後，主要有兩種方式查看數據：

1. 側邊欄面板：在側邊欄底部、設置按鈕左邊點擊「⚡ 用量」按鈕。
2. 對話指令：註冊了 commandcode_usage 工具，可在對話中直接輸入指令：

    查詢我的 CommandCode 用量

注意事項¶

• 權限運行：插件以當前 DSH 進程的權限運行，請確保 DSH 進程擁有訪問 CommandCode API 的必要權限。
• 源碼審查：在安裝未知來源的插件前，建議查看源碼與許可證（MIT）。
• 版本要求：需要 Node.js 環境版本 >= 18。

目錄與源碼¶

• 插件目錄
• GitHub 倉庫