前言¶

在 DSH（DeepSeek Harness）環境中開發智能體時，管理 API 調用成本和配額是日常運維的關鍵。手動刷新網頁或檢查 CLI 輸出效率低下，且容易遺漏關鍵狀態。此插件通過在 DSH Host 端抓取官方接口數據，並在瀏覽器端提供可視化掛件，解決了實時監控與用量控制的問題。

插件簡介¶

這是由 XingPeng-Pixel 維護的 DSH 客戶端插件。它在 DSH Host 端運行，通過同源調用 Command Code 的 /alpha/* 接口獲取數據，並將狀態暴露給前端。插件不涉及任何明文 API Key 的傳輸，所有敏感操作均在 Host 端完成。

核心功能¶

• 實時用量快照：抓取 /alpha/whoami、/alpha/usage/summary 等接口數據，支持 5 小時與每週滾動窗口的餘量監測。
• 多賬戶支持：支持配置多個賬戶，Host 端獨立抓取並隔離錯誤。
• 可視化展示：提供側邊欄小掛件（自適應寬度）和設置頁儀表盤（圓環圖與進度條），顏色隨使用率變化。
• 零密鑰接觸：API Key 在 Host 端解析（支持環境變量、CLI 憑據等），瀏覽器端僅通過同源 HTTP JSON 接口消費數據。
• 交互接口：提供同源 JSON 查詢接口及聊天斜槓命令 /commandcode-usage，支持每輪對話消耗的實時推送。

安裝與啓用¶

插件已發佈至 npm，可通過 DSH 官方插件命令一鍵安裝：

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

安裝後，需在 DSH 設置頁的 CMDAI 監控 或環境變量中配置 API Key。

典型用法¶

1. 配置環境變量：

    export COMMANDCODE_API_KEY=user_xxx

也可以在 DSH 設置頁中填寫。

2. 驗證接口：
   安裝插件後，Host 會啓動同源 HTTP 服務，可通過 curl 驗證：

    curl http://127.0.0.1:3099/commandcode-usage/status.json
    curl http://127.0.0.1:3099/commandcode-usage/turn-cost.json
    curl http://127.0.0.1:3099/commandcode-usage/health

3. 使用斜槓命令：
   在聊天窗口輸入 /commandcode-usage 即可查看當前用量儀表盤。

適用場景與注意¶

• 適用場景：需要精細化管理 Command Code 配額與成本的 DSH 開發者。
• 安全說明：插件以 DSH 進程權限運行，瀏覽器端永遠不會接觸明文 API Key。
• 當前限制：
  • turn-cost.json 的 amount 字段目前爲 null（尚未內置價格表）。
  • 配置項 storagePath 與 activeAccount 爲預留字段，尚未參與運行時行爲。
  • 插件依賴於官方 /alpha/* 接口，若上游接口變更需同步更新。

結語¶

該插件通過 Host 端抓取與瀏覽器端展示的解耦設計，提供了安全、實時的用量監控方案。對於需要嚴格控制 Token 消耗或管理多賬戶的開發者而言，這是一個實用的輔助工具。

項目目錄 | GitHub 倉庫