前言¶

在 DSH 的日常使用裏，給智能體接入模型常常要處理註冊、API key、計費等步驟。dsh-opencode-zen 提供另一條路徑：它把 OpenCode Zen 的免費檔模型接入 dsh web 的模型選擇器，讓你直接選擇一個免費模型開始使用。

下面介紹它的定位、核心能力、安裝方式和注意事項。

這是什麼¶

dsh-opencode-zen 是由 xiaozhe7772222 維護的 DSH 插件，許可證爲 MIT。它的定位是：

OpenCode Zen free-tier models for DeepSeek Harness: zero-config public-key provider with quota-aware pacing.

簡單來說，它解決的是“在 DSH 中快速使用 OpenCode Zen 免費模型”的問題：插件暴露 opencode provider，接入 6 個免費模型，並內置 429/5xx backoff 和請求節流。

核心功能¶

• 接入 6 個免費模型：DeepSeek V4 Flash、Xiaomi MiMo、Tencent Hunyuan、兩個 NVIDIA Nemotrons、Laguna S 2.1。
• 零配置、零成本：無需註冊、無需 API key、無需計費。
• 通過 dsh web 模型選擇器暴露 opencode provider。
• 可與 dsh-api-key-pool 配合進行多 Key 輪換。
• 內置 429/5xx backoff 和請求節流。
• 支持 streaming、reasoning-content passthrough 和 tool calls。
• 支持 reasoning effort：off / low / high / max。
• 未配置時回落到官方 public tier（public）。
• 要求 DSH 0.8.0+，並需要 ctx.llm.registerAdapter API；舊版本可能需要手動註冊 route。

安裝與啓用¶

先確認 DSH 版本滿足要求：DSH 0.8.0+ with ctx.llm.registerAdapter API。舊版本可能需要手動註冊 route。

1、安裝插件：

dsh plugin --profile web add github:xiaozhe7772222/dsh-opencode-zen

2、驗證安裝：

dsh plugin --profile web list

3、重啓 dsh web，進入 Settings → Models，選擇 provider opencode，並選擇一個免費模型。建議從 deepseek-v4-flash-free 開始。

典型用法¶

默認零配置使用¶

不設置任何 key 時，插件回落到官方 public tier（public）。安裝並重啓後，進入模型選擇器選擇對應模型即可。

使用多個 Key 輪換¶

如果需要使用多個賬號，可以這樣做：

1、安裝 dsh-api-key-pool。

2、在 opencode pool 中添加 keys。

3、插件會自動輪換。

使用環境變量¶

如果需要顯式配置，在啓動 dsh web 前設置：

export OPENCODE_ZEN_API_KEY=...

或：

export OPENCODE_GO_API_KEY=...

兼容性與依賴信息¶

package.json 聲明 peerDependencies：

{
  "@deepseek-ai/cordis": "^4.0.1",
  "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
  "@deepseek-ai/schemastery": "^3.18.1"
}

package.json 同時聲明 dsh bundle patch 爲：

./cordis.patch.yml

適用場景與注意¶

適合：

• 想在 dsh web 中快速接入免費模型；
• 不想處理註冊、API key、計費；
• 需要支持 streaming、tool calls、reasoning-content passthrough；
• 希望用 dsh-api-key-pool 做多 Key 輪換；
• 需要 429/5xx backoff 和請求節流來控制配額。

注意：

• 服務可用性和配額限制受 OpenCode Zen 政策約束，本插件僅爲客戶端適配器。
• 免費檔存在 per-IP 限流；遇到 429 可等待 30–60 秒，或使用 dsh-api-key-pool 輪換 keys。
• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• DSH 0.8.0+ with ctx.llm.registerAdapter API；舊版本可能需要手動註冊 route。

結尾¶

dsh-opencode-zen 的價值，是把 OpenCode Zen 免費檔模型以零配置方式接入 DSH 的模型選擇器，同時保留 streaming、tool calls 和配額感知。適合需要低成本、快速可用的 DSH 插件接入方式。

GitHub：https://github.com/xiaozhe7772222/dsh-opencode-zen