dsh-opencode-zen-free-provider

dsh-opencode-zen-free-provider

OpenCode Zen Free provider for dsh.

English

本插件可以将 OpenCode Zen 的免费模型接入 dsh 使用。插件启动时从 OpenCode Zen 和 models.dev 同步模型目录与所有元数据，仅抓取一次，不轮循。哪怕启动时拉取失败，插件也能正常挂载，路由以空目录提供服务。

上下文窗口默认以 models.dev 的元数据为准。MiMo V2.6 Flash、DeepSeek V4.1 Flash 与 GLM 5.3 Flash 例外：它们的后端实际服务比免费档登记的 200K 更宽，本插件按实测值声明（前两者 1M，GLM 5.3 Flash 600K）。实测 deepseek-v4.1-flash-free 在 104 万 prompt tokens 时仍返回 200，把针藏在 3MB 文档 93% 深处也能准确取回；真正的天花板是请求体大小（约 3.9MB 字符）而不是上下文窗口。glm-5.3-flash-free（上游路由到 perplexity/glm-5.3-flash）在 26.4 万 prompt tokens 时同样取回藏在 93% 深处的标记，61.7 万 tokens 仍返回 200，65.9 万 tokens 起被上游 context_length_exceeded 拒绝，所以按 60 万声明而不是付费档的 1M。 安装

从 npm 安装（预构建产物，推荐）：

或从 GitHub 安装：

安装之后

模型列表无需任何配置，插件启动时会自动从远程同步并过滤所有免费模型。在 Web Models 页面选择 OpenCode Zen Free 和模型后即可开始使用。 推理深度（Reasoning effort）

模型只暴露上游接受的档位，不造档位。Default 表示"不发送 reasoning_effort"字段，由上游自行决定深度。Off 是真开关——发送上游的关闭字面值（none、off 等）。effort 配置为空或只有 toggle 的模型干脆不显示档位选择器。 错误提示

OpenCode Zen 把非凭证类拒绝（免费额度到期、区域限制等）以 HTTP 401/403 返回，dssharness 会把这些状态码归类为"API Key 无效"。本插件在终端错误事件里保留真实原因，让真因显示出来；真正的鉴权失败仍按 AUTH 走。无法解析的内容原样透传。

若看到 FreeTierError: OpenCode's free tier can only be used from within OpenCode，那是上游的客户端指纹门，与本插件无关，也不是 API Key 问题。2026-10-11 起免费层从 /zen/v1 迁到 /inference/v1，门禁下沉到不可审计的私有 inference 服务。本插件按实测通过条件构造请求： 走 /inference/v1（/zen/v1 对匿名请求一律 403）； 四个 session 头同值双发：x-opencode-session、x-opencode-session-id、x-session-affinity、x-session-id； x-opencode-project: global（40-hex project id 会触发 403）； 不发 x-opencode-request，不发 HTTP-Referer——这两个头的存在本身就会触发 403； session id 前 12 位 hex 必须是反转时间戳（ses_ 降序、msg_ 升序），纯随机即拒； 请求的 tools 必须包含 bash 与 read（按小写名精确匹配），缺任一即 403。精简、标题、摘要等工具数不足的请求由本插件自动补齐占位工具。