前言¶
DeepSeek Harness (DSH) 的核心設計理念之一是模塊化,通過插件擴展功能。在使用 Command Code 進行模型調用時,查看賬戶積分、用量週期或同步模型列表往往需要切換到 Command Code 的控制台或通過 CLI 查看。commandcode-dash 插件將 Command Code 的關鍵信息整合進了 DSH 的 Web 設置面板,解決了在單一工作流中管理外部服務狀態的需求。
是什麼¶
這是一個由社區開發者 Momonaka 維護的 DSH Web 插件,它爲 DeepSeek Harness 的設置面板添加了一個 Command Code 專用的配置區塊。該插件主要解決三個問題:實時查看 Command Code 的賬戶積分餘額與用量週期;將本地的模型配置與官方 provider/v1/models 目錄進行比對並一鍵同步;以及在 DSH 界面內直接管理 API Key。
核心功能¶
- 積分與用量監控:通過 live billing API 獲取月度、購買和免費積分餘額。提供 5 小時和每週用量窗口,以進度條和倒計時形式展示剩餘時間。
- 賬單週期統計:展示請求次數、成功率、消耗積分和 Token 數量。
- 模型目錄管理:展示已配置模型的上下文窗口,支持搜索。
- 智能同步:將本地配置與官方
provider/v1/models進行比對,支持一鍵同步,並對新增或移除的模型請求用戶批准。 - 安全與認證:提供 Setup 卡片用於存儲寫權限的 API Key,支持一鍵登出以遺忘 Key。
安裝與啓用¶
- 確保已安裝 DeepSeek Harness 並啓用了
webprofile(或使用桌面應用)。 - 確保宿主機安裝了 Node.js 20+(插件使用了
AbortSignal.any)。 - 執行安裝命令:
dsh plugin --profile web add commandcode-dash
安裝完成後,重啓 dsh web 即可生效。
典型用法¶
- 配置 API Key:首次使用時,設置面板會顯示一個表單,用於輸入 Command Code 的 API Key(寫權限)。Key 會存儲在 Harness 的憑證庫中,引用名爲
COMMANDCODE_API_KEY。 - 手動配置 Key:也可以在
.credentials.yaml文件中手動添加:
refs:
COMMANDCODE_API_KEY: user_...
- 管理模型路由:保存 Key 後,插件會自動添加兩個 Provider 路由:
commandcode(使用openai-completions協議)和commandcode-anthropic(使用anthropic-messages協議)。前者支持除 Claude 外的所有模型,後者僅支持 Claude。 - 登出:點擊底部的 Sign out 按鈕,確認後會清除存儲的 Key,界面返回到 Setup 卡片狀態。
適用場景與注意¶
- 適用場景:需要頻繁在 DSH 界面內監控 Command Code 消費情況,或希望統一管理模型目錄配置的開發者。
- 注意:這是一個社區構建的非官方插件,與 DeepSeek 或 Command Code 無任何隸屬關係。使用前請確認你的 Command Code 計劃擁有 Provider API 訪問權限(除 Go 計劃外的所有計劃均支持)。插件依賴宿主機的 Node.js 環境,需版本 20 或更高。Key 僅用於訪問 Command Code 的 Provider API,不會發送至其他任何第三方服務。
commandcode-dash 將 Command Code 的管理功能下沉到 DSH 的設置面板中,減少了切換工具的成本。如需更多細節或源碼,請訪問 GitHub 倉庫。