前言¶

在 DeepSeek Harness（DSH）的插件體系裏，擴展 LLM 提供方通常需要在 harness 的 LLM 接縫中註冊對應路由、處理請求協議和模型目錄。dsh-llm-opencode 面向這個環節：它爲 DSH 增加 OpenCode Zen 提供方，使 DSH 中的編碼任務可以選擇 OpenCode Zen 免費模型，且免費模型不需要配置 API key。

這是什麼¶

dsh-llm-opencode 是 bobowsh 維護的 DSH 插件，採用 MIT 許可證。

它的主要用途是在 DSH 的 LLM 接縫中註冊 opencode-zen 提供方路由，並把 DSH 的請求翻譯成 OpenAI 兼容的 chat completions 請求。插件同時處理 OpenCode Zen 的客戶端身份校驗和免費模型目錄同步。

核心能力¶

• 在 DSH 的 LLM 接縫中註冊 opencode-zen 提供方路由。
• 支持 OpenCode Zen 免費模型；免費模型無需 API key。
• 內置免費模型目錄，並在插件加載時後臺從網關和 models.dev 同步。
• 支持從網關 /models 自動發現帶 free 標記的模型。
• 將 harness 請求翻譯爲 OpenAI 兼容 chat completions 請求，並解析 SSE 流式響應。
• 付費模型可通過 OPENCODE_API_KEY 憑證或環境變量配置 API key。
• 可通過 DSH Web 設置或 settings.yaml 的 llm-opencode 節覆蓋 baseURL、maxTokens、models、autoSyncModels 等配置。
• 隨附 cordis.patch.yml，用於把插件註冊進 DSH bundle 加載器。
• 純文本請求受支持；圖片內容會被 UNSUPPORTED_CONTENT 拒絕。
• 請求會攜帶 User-Agent: opencode/1.0.0 等頭，以滿足 OpenCode Zen 客戶端身份校驗；默認的 deepseek-harness user-agent 會被網關拒絕。

安裝與啓用¶

先確認 DSH 版本滿足要求：

DeepSeek Harness >= 0.1.0-rc.7
@deepseek-ai/cordis ^4.0.1（peer dependency）

然後從 npm 安裝：

dsh plugin --profile web add dsh-llm-opencode

也可以直接從 GitHub 安裝：

dsh plugin --profile web add "github:bobowsh/dsh-llm-opencode#main"

安裝完成後，在 DSH Web 設置 → 模型中選擇 OpenCode Zen 作爲提供方。隨附的 cordis.patch.yml 會用於把插件註冊進 DSH bundle 加載器，使插件作爲當前 DSH profile 的一部分參與加載。

典型用法¶

1、把插件裝進 DSH 的 web profile：

dsh plugin --profile web add dsh-llm-opencode

2、打開 DSH Web 設置 → 模型，選擇 OpenCode Zen 作爲提供方。

3、選擇一個免費模型，例如 deepseek-v4-flash-free，直接開始編碼。免費模型無需 API key。

4、如果需要使用付費模型，在 DSH 憑證中設置 OPENCODE_API_KEY，或將其作爲環境變量導出：

export OPENCODE_API_KEY="..."

5、如需覆蓋默認行爲，可在 DSH Web 設置或 settings.yaml 的 llm-opencode 節中配置 baseURL、maxTokens、models、autoSyncModels 等字段。

適用場景與注意¶

適合以下場景：

• 在 DSH 中使用 OpenCode Zen 免費模型。
• 希望免費模型不配置 API key。
• 需要在 DSH 的 LLM 接縫中接入 OpenAI 兼容 chat completions 和 SSE 流式響應。

使用前需要注意：

• 免費模型由 OpenCode Zen 公共網關提供服務，可用性可能變化。
• 免費模型無需 API key；付費模型需要 API key。
• 僅支持純文本請求；圖片內容會被 UNSUPPORTED_CONTENT 拒絕。
• OpenCode Zen 網關會校驗客戶端身份；默認的 deepseek-harness user-agent 會被拒絕，插件會攜帶 User-Agent: opencode/1.0.0 等頭。
• 啓動目錄同步失敗時保留內置目錄；設置中自定義的 models 列表永不被覆蓋。
• 環境要求：DeepSeek Harness >= 0.1.0-rc.7；@deepseek-ai/cordis ^4.0.1（peer dependency）。
• 插件以當前 dsh 進程權限運行；安裝前應檢查源碼與許可證。許可證爲 MIT © bobowsh。

參考¶

目錄頁：https://www.skillhub.cn/plugins/bobowsh/dsh-llm-opencode
GitHub：https://github.com/bobowsh/dsh-llm-opencode