前言¶

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