前言¶

在 DeepSeek Harness（DSH）裏做智能體開發，模型來源通常通過 provider 插件接入。若你已有 Command Code 賬號或訂閱，希望直接在 DSH 的模型選擇器裏使用其在線模型目錄，而不是單獨維護一套 API 封裝，就需要一個官方的 provider 路由。

dsh-commandcode-provider 由社區維護者 Mars-Sea 開發，將 Command Code 註冊爲 DSH 的 commandcode provider，並提供設置頁、用量卡片與模型選擇器標註。項目從 pi-commandcode-provider（MIT）移植而來，當前在 GitHub 上約 87 stars、5 forks，npm 包版本爲 0.8.1，許可證 MIT。

這是什麼¶

@mars-sea/dsh-commandcode-provider 是一個非官方的 DeepSeek Harness LLM provider 插件，面向 Command Code 平臺。安裝後通過 dsh plugin add 寫入 profile，註冊 commandcode 路由，並在 Settings → Models 頁面顯示 Command Code 卡片。

插件只在你本地的 DSH profile 與 Command Code 賬號之間通信：本地讀寫憑證存儲與模型緩存，網絡上僅調用 Command Code API，不發送遙測數據。你需要自備 Command Code 賬號與 API key 或訂閱，並遵守 Command Code 的服務條款；本項目與 Command Code, Inc. 無隸屬關係。

核心功能¶

下面介紹插件在 README 中列出的主要能力。

Provider 與模型目錄¶

• 安裝後註冊 commandcode provider 路由，模型目錄從 Command Code API 即時拉取。
• 模型選擇器會標註最低套餐、活動優惠或 FREE 徽章、峯谷時段狀態、是否支持圖片輸入、上下文窗口；免費模型默認排在前面。
• 支持 reasoning-effort：對可選推理強度的模型，在選擇器中暴露對應檔位。
• 套餐感知：高於當前訂閱檔位的模型默認隱藏，可在設置中通過「Hide out-of-plan models」開關調整。

設置頁與憑證¶

Settings → Command Code 提供：

• API key 配置與連接選項；
• 即時 Account usage 用量卡片；
• 瀏覽器內登錄：點擊 Sign in to Command Code 啓動與 cmd login 相同的官方授權流程，批准後 key 自動寫入本地憑證服務；也可手動粘貼 key 或通過環境變量 COMMANDCODE_API_KEY 設置。

遠程 Host 場景下，瀏覽器登錄需要 Host 與瀏覽器在同一臺機器（loopback 回調）；遠程部署時請手動粘貼 key。若 composition 層設置了字面量 apiKey，其優先級高於已登錄憑證。

多賬號輪換¶

配置多個 Command Code 訂閱後，當一個賬號觸達用量上限，請求會自動切換到下一個賬號：

• 在 Settings → Command Code 的 Account rotation 卡片中添加帶標籤的賬號；頂層 key 始終作爲 default 賬號優先使用。
• Active account 下拉可固定首選賬號；若該賬號耗盡，會回退到其他賬號，並在窗口重置後恢復。
• /commandcode 命令與 Account usage 卡片可查看各賬號狀態。

圖片輸入¶

支持 Vision 模型的圖片輸入；純文本模型會拒絕帶圖請求。若在含圖片的會話中切換到純文本模型，DSH 會拒絕該操作，需選擇標註 Image 的模型或先移除圖片。

其他說明¶

• 模型目錄可在無 key 時瀏覽；實際對話請求需要 API key。
• 不支持 stop sequences，攜帶 stop 的請求會失敗。
• reasoning 塊不會在後續輪次重放；僅帶配對 tool result 的 tool call 會重放。

安裝與啓用¶

在 web profile 中安裝最新版：

dsh plugin --profile web add @mars-sea/dsh-commandcode-provider@latest

更新插件：

dsh plugin --profile web update @mars-sea/dsh-commandcode-provider@latest

安裝或更新後需重啓 web 應用。

卸載：

dsh plugin --profile web remove @mars-sea/dsh-commandcode-provider

卸載不會刪除 dsh 憑證存儲或 ~/.commandcode/auth.json 中的 key。

典型用法¶

獲取 API key¶

推薦通過官方 CLI（需 Node.js 22+）：

npm i -g command-code@latest
cmd login        # macOS/Linux；原生 Windows 使用 cmdc login

也可在 DSH 設置頁點擊 Sign in to Command Code，或在 Keys settings page 創建 key 後粘貼，或執行：

export COMMANDCODE_API_KEY="user_..."

驗證安裝¶

重啓後，在 Settings → Command Code 填入 API key 並保存。Settings → Models 應出現 Command Code 卡片，模型選擇器在 commandcode 下列出即時目錄。用你套餐內的模型發送一條消息即可驗證。

查看用量¶

插件註冊 /commandcode 斜槓命令：

/commandcode        # 或 /commandcode status

配置文件¶

等效配置可寫入 $DSH_HOME/settings.yaml（修改後立即生效，無需重啓）：

llm-commandcode:
  apiKeyEnv: COMMANDCODE_API_KEY   # credential reference
  apiBase: https://api.commandcode.ai
  workingDir: /path/to/project     # optional
  modelsCachePath: ~/.commandcode/models-cache.json
  requestTimeoutMs: 60000          # default 60s
  streamIdleTimeoutMs: 300000      # default 300s

多賬號輪換的 YAML 示例：

llm-commandcode:
  apiKeyEnv: COMMANDCODE_API_KEY        # first (default) account
  activeAccount: COMMANDCODE_API_KEY_2   # optional: pin the active account
  accounts:
    - label: Go #2
      apiKeyEnv: COMMANDCODE_API_KEY_2
    - label: Go #3
      apiKeyEnv: COMMANDCODE_API_KEY_3

禁用而不卸載¶

編輯 profile 的 cordis.patch.yml，註釋或刪除 llm-commandcode 行，或設置 disabled: true，然後重啓。

適用場景與注意¶

適合誰：

• 已有 Command Code 賬號或訂閱，希望在 DSH web profile 中直接使用其模型目錄與推理強度選項；
• 需要多賬號自動輪換以應對單賬號用量上限；
• 希望在 DSH 設置頁內完成授權、查看用量，而不是單獨維護 API 客戶端。

安裝前注意：

• 插件以當前 dsh 進程的權限運行，安裝前應檢查 GitHub 源碼 與 MIT 許可證。
• 這是社區集成，非 Command Code 或 DeepSeek 官方出品；DSH 生態遵循「一切皆插件」理念，SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
• 開發環境要求 Node.js >= 22（見 package.json engines 字段）。

鏈接¶

• SkillHub 目錄頁：https://www.skillhub.cn/plugins/Mars-Sea/dsh-commandcode-provider
• GitHub 倉庫：https://github.com/Mars-Sea/dsh-commandcode-provider
• npm 包：https://www.npmjs.com/package/@mars-sea/dsh-commandcode-provider

若你已在 Command Code 側完成訂閱配置，經過上面的安裝與 key 設置步驟，即可在 DSH 模型選擇器中按套餐選用 Command Code 的在線模型目錄。