前言¶

在 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