前言¶

在 DeepSeek Harness（DSH）裏接入外部 LLM 路線時，需要先確認文本輸出、流式輸出、工具調用、憑據配置和錯誤處理是否可用。dsh-plugin-commandcode-provider 爲 DSH 添加 commandcode LLM provider 路線，讓模型以 commandcode/<model-id> 的形式被選擇。

這是什麼¶

• 定位：爲 DSH 添加 commandcode LLM provider 路線。
• 倉庫路徑：mitian233/dsh-plugin-commandcode-provider。
• 許可證：MIT。
• 兼容版本：DSH 0.1.0-rc.6 及以後版本（npm next tag）。
• 來源說明：瀏覽器輔助 OAuth 流程移植自 MIT 許可證的 pi-commandcode-provider。

核心能力¶

下面介紹已覈實的能力：

• 支持文本消息和流式文本輸出。
• 支持標準 JSON Schema 工具和完整工具調用。
• 在模型聲明支持的推理力度下，支持 reasoning deltas。
• 支持用量報告、取消、空閒超時處理以及確定性 HTTP/流內錯誤分類。
• 在 Web 設置頁提供 Command Code OAuth 按鈕，用於瀏覽器輔助獲取並存儲 API key。
• 支持通過 DSH profile 配置覆蓋 baseURL、maxTokens、defaultContextWindow、streamIdleTimeoutMs 等。

安裝與啓用¶

先運行 Web 形態的 DSH：

npx @deepseek-ai/dsh web

如果 dsh 已在 PATH 中，也可以使用 dsh web。

從本地目錄安裝到 web profile：

cd /path/to/dsh-plugin-commandcode-provider
npx @deepseek-ai/dsh plugin --profile web add .

從 GitHub 安裝：

dsh plugin --profile web add github:mitian233/dsh-plugin-commandcode-provider

移除插件及其 bundle 層：

dsh plugin --profile web remove dsh-plugin-commandcode-provider

驗證時，先查看插件 layer，再啓動 Web UI：

dsh --profile web --dump-config
dsh web

典型用法¶

在 profile 配置中加入名爲 llm-commandcode 的插件條目：

- id: llm-commandcode
  config:
    apiKeyEnv: COMMANDCODE_API_KEY
    baseURL: https://api.commandcode.ai
    maxTokens: 64000

選擇模型時使用 commandcode/<model-id>，例如：

commandcode/gpt-5.6-luna

API key 通過 DSH credentials service 配置。如果掛載了 credentials service，它是權威來源；未命中不會回退到啓動環境。空白、僅空白或 HTTP-header-invalid 的 key 會在發送請求前被拒絕。

Web 設置頁中的 Command Code OAuth 按鈕可以啓動瀏覽器輔助流程，用於獲取並存儲 API key。該流程需要 DSH Web 服務器（Web profiles）。如果自動傳輸失敗或超時，可回退到按鈕下方的手動 API-key 輸入。

配置項¶

• apiKeyEnv：用於選擇 DSH credential reference，示例爲 COMMANDCODE_API_KEY。
• baseURL：用於修改 API origin。
• maxTokens：上限爲 64000。
• defaultContextWindow、streamIdleTimeoutMs：用於覆蓋模型上下文窗口和流式空閒超時等行爲。
• temperature：作爲兼容配置接受；顯式請求優先，wire 默認值爲 0.3。
• 靜態 models 條目：可提供顯示、context-window 和最大 token 覆蓋；它不用於發現模型。

適用場景與注意¶

這個插件適合需要在 DSH 中使用 commandcode provider 路線、並希望通過 Web 設置頁管理 API key 的場景。

v1 非目標如下：

• 不刷新憑證。
• 不做動態模型發現或目錄緩存。
• 不支持圖像輸入和 stop sequences。
• 圖像和 stop 請求會在網絡分發前失敗。

插件會以當前 dsh 進程權限運行，並處理 API key 相關配置。安裝前應檢查源碼與許可證。

鏈接¶

• 目錄頁：https://www.skillhub.cn/plugins/mitian233/dsh-plugin-commandcode-provider
• GitHub：https://github.com/mitian233/dsh-plugin-commandcode-provider