前言¶

DSH 生態裏，模型 provider 可以做成插件；社區目錄是獨立站點，不等同於官方應用商店。對希望在 dsh 裏使用 OpenCode Zen 免費模型的開發者來說，手工處理模型目錄、元數據、推理深度和錯誤提示會比較繁瑣。dsh-opencode-zen-free-provider 由 jiesou 維護，用來把 OpenCode Zen 的免費模型接入 dsh。

這是什麼¶

一句話定位：dsh-opencode-zen-free-provider 是 OpenCode Zen Free provider for dsh。

它主要做幾件事：

• 將 OpenCode Zen 的免費模型接入 dsh 使用。
• 插件啓動時從 OpenCode Zen 和 models.dev 同步模型目錄與所有元數據，僅抓取一次，不輪循。
• 許可證爲 MIT。

核心功能¶

模型列表¶

模型列表無需任何配置。插件啓動時會自動從遠程同步並過濾所有免費模型。

失敗降級¶

啓動時拉取失敗時，插件仍能正常掛載，路由以空目錄提供服務。

上下文長度¶

MiMo V2.5 後端額外支持到 1M 上下文。這裏只適用於 MiMo V2.5 後端，不能推斷適用於所有模型。

推理深度¶

推理深度只暴露上游接受的檔位。Default 表示不發送 reasoning_effort 字段；Off 發送上游的關閉字面值（none、off 等）。

錯誤提示¶

OpenCode Zen 會把非憑證類拒絕（免費額度到期、區域限制等）以 HTTP 401/403 返回。dsh 會把這些狀態碼歸類爲 API Key 無效。本插件在終端錯誤事件裏保留真實原因；真正的鑑權失敗仍按 AUTH 走，無法解析的內容原樣透傳。

安裝與啓用¶

從 npm 安裝¶

dsh plugin --profile web add @jiesou/dsh-opencode-zen-free-provider

從 GitHub 安裝¶

dsh plugin --profile web add github:jiesou/dsh-opencode-zen-free-provider

依賴版本¶

package.json 中聲明瞭 peerDependencies，包括 @deepseek-ai/cordis >=4.0.1 <5 等依賴版本要求。安裝前建議確認當前 dsh 環境滿足這些要求。

啓用¶

安裝之後，在 Web Models 頁面選擇 OpenCode Zen Free 和模型後即可開始使用。

典型用法¶

選擇推理深度¶

Default 表示不發送 reasoning_effort 字段，由上游自行決定深度；Off 發送上游的關閉字面值（none、off 等）。

處理網絡重試¶

對於 Ox Alpha 等經常遇到 network errors 的模型，建議手動設置：

- id: opencode-zen-free-provider
  name: '@jiesou/dsh-opencode-zen-free-provider'
  config:
    retryPolicy:
      mode: always

適用場景與注意¶

• 適合：希望在 dsh 中使用 OpenCode Zen 免費模型，並且不想手工維護模型目錄、元數據和錯誤提示。
• 權限：插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• 限流：OpenCode 的 Free 模型會被基於 IP 限流。
• 錯誤碼：OpenCode Zen 的非憑證類拒絕會以 HTTP 401/403 返回，插件會保留可解析的真實原因；真正的鑑權失敗仍按 AUTH 走。
• 上下文：1M 上下文只明確適用於 MiMo V2.5 後端。
• 安裝源：支持從 npm 或 GitHub 安裝。

結尾¶

dsh-opencode-zen-free-provider 的核心價值是把 OpenCode Zen 免費模型接入 dsh：啓動時一次性同步模型目錄與元數據，按上游規則暴露推理深度，並在錯誤事件裏保留更具體的拒絕原因。

GitHub：https://github.com/jiesou/dsh-opencode-zen-free-provider
目錄頁（來自插件線索，未見於本次已抓取資料）：https://www.skillhub.cn/plugins/jiesou/dsh-opencode-zen-free-provider