dsh-plugin-adapter：在 DSH 中直接使用 OpenCode Zen 模型

前言¶

DeepSeek Harness (DSH) 的核心設計理念之一是「一切皆插件」。在使用 DSH 進行模型推理時，接入外部模型通常需要 API 密鑰、註冊賬號或維護額外的進程。dsh-plugin-adapter 解決了這個問題，它將 OpenCode Zen 的匿名免費車道模型註冊爲 DSH 的原生 LlmAdapter，使這些模型無需密鑰、無需註冊即可直接在 DSH 的模型選擇器中使用。

是什麼¶

dsh-plugin-adapter 是一個爲 DeepSeek Harness 提供的插件，用於直接接入 OpenCode Zen 的免費模型資源。

核心價值：Free OpenCode Zen models, natively inside DSH (DeepSeek Harness). No API key. No registration. No extra process.
維護者：1624318455
解決痛點：繞過了傳統接入外部 API 需要的密鑰管理和流程，利用 Zen 的匿名免費車道進行推理。

核心功能¶

該插件提供了以下能力：

零憑證、零設置：直接使用 OpenCode 的匿名免費車道，無需配置 API Key。
原生適配器：註冊爲 DSH 原生 LlmAdapter，不依賴 Sidecar 進程或本地端口。
CLI 相似僞裝：發出的請求頭與 OpenCode CLI 保持一致（如 User-Agent 和會話標識），確保請求符合上游要求。
可選擇思考級別：支持 Off/Minimal/Low/Medium/High 的思考強度選擇，在 DSH 模型選擇器中配置。
實時目錄與回退：提供帶有回退鏈的實時模型目錄，支持自愈機制。
錯誤處理：能夠將上游的限流、認證、超時等錯誤以清晰的分類返回給 DSH。

安裝與啓用¶

使用官方命令進行安裝：

dsh plugin --profile web add github:1624318455/dsh-plugin-adapter

安裝完成後，重啓 dsh web，打開模型選擇器，即可在 zen-free 組中看到可用的模型。

典型用法¶

默認配置即可使用。如需調整，可在對應 Profile 的 cordis.patch.yml 中覆蓋配置：

- id: opencode2dsh
  name: '@memef1f1y/dsh-plugin-adapter'
  config:
    mode: adapter        # 使用原生適配器模式
    providerId: zen-free # 在 DSH 中顯示的提供商名稱

適用場景與注意¶

環境要求：
- 需要運行 DeepSeek Harness (DSH) 並開啓 Web Profile。
- 系統需安裝 Node.js ≥ 20。
- 需要出站 HTTPS 連接至 opencode.ai 和 models.dev。
注意事項：
- Sidecar 模式是遺留模式，不包含在發佈的插件包中。如需使用 Sidecar 模式，需自行構建 legacy/agent。
- 插件以當前 DSH 進程的權限運行，安裝前建議檢查源碼與許可證。

總結¶

dsh-plugin-adapter 通過原生適配的方式，讓 DSH 用戶能夠無縫訪問 OpenCode Zen 的免費推理能力。它簡化了接入流程，同時提供了完善的錯誤處理和模型目錄管理。

項目主頁：https://github.com/1624318455/dsh-plugin-adapter
插件目錄：https://www.skillhub.cn/plugins/1624318455/dsh-plugin-adapter