OpenCode 免费模型 Devanand-PA/dsh-opencode-zen-plugin

dsh-opencode-zen-plugin

DeepSeek Harness 插件，把 OpenCode Zen 的免费匿名模型注册为 LLM 服务商——不需要 API key。

整个插件只用一个名字：仓库、npm 包、配置档 bundle、harness 服务都叫 dsh-opencode-zen-plugin。

唯一的刻意例外是 LLM 服务商 id：opencode-zen-free。模型选择器里显示为 opencode-zen-free/<model>（和 nvidia-nim/z-ai/glm-5.3-flash、deepseek-official/<model> 并列）。它命名的是所服务的模型，不是提供服务的插件；保持稳定，已保存的会话和设置里引用该服务商下模型的配置才能继续用。

- 服务商 id：opencode-zen-free（显示名 OpenCode Zen Free）
- 包 / bundle / 服务：dsh-opencode-zen-plugin
- 支持 DSH 0.2.1-rc.2（web + headless 配置档）
- 零成本模型从 Zen 目录 + models.dev 元数据实时发现（免费 = 零成本或模型 id 带 -free），带磁盘缓存
- 流式输出文本和推理，支持工具调用、图片（模型支持时）、按模型选择推理强度
- 匿名访问在服务端有门槛；插件替你满足这个门槛（见匿名免费层门槛）

2026-10-21 用 DSH 0.2.1-rc.2 做过端到端验证：dsh --profile "…" headless 运行（普通问答和工具调用——模型通过 read 工具读文件），针对 deepseek-v4.1-flash-free 和 nemotron-3.5-lightning-free；另外对 glm-5.3-flash-free、big-pickle、longcat-2.5-preview-free、beam-free、muse-spark-（responses API）等做了直连协议测试。

要求

- DeepSeek Harness 0.2.1-rc.2（插件声明 dsh.compatibility.dsh: ">=0.2.1-rc.2 <0.3"，刻意排除 alpha 构建——在其他任何 DSH 版本上，加载器打印一行「skipping profile bundle」提示，然后不带插件启动；harness 本身不受影响）
- Node.js 20+，以及一个你能编辑的配置档（$DSH_HOME/profiles/<profile>）
- 不需要 API key。 匿名免费层开箱即用。
- 挂载从不阻塞，也从不等待网络。 apply() 是同步的：选择器立即提供 pi-ai 内置的 11 个零成本模型（加上磁盘上最后一次成功的目录），实时目录在后台惰性刷新（挂载后立刻、读取模型时、以及每天一次慢速轮询）。到 opencode.ai/models.dev 的路由慢或被封，只会拖慢刷新，绝不会拖慢 harness 启动或会话。

安装

方式 A——插件管理器（Web GUI）

打开 DSH Web GUI → Plugins → Install from source，输入 GitHub URL：

github:Devanand-PA/dsh-opencode-zen-plugin

（或 https://github.com/Devanand-PA/dsh-opencode-zen-plugin.git）。安装添加 bundle 并默认启用。

方案 B — 配置档 package.json（从 GitHub 或本地检出）

把包加为配置档依赖和 bundle，然后安装。在 $DSH_HOME/profiles/<your-profile>/package.json 中：

{
// …
"dependencies": {
// from GitHub:
"dsh-opencode-zen-plugin": "github:Devanand-PA/dsh-opencode-zen-plugin",
// …or from a local checkout (edit-in-place friendly): // "dsh-opencode-zen-plugin": "link:/path/to/dsh-opencode-zen-plugin" },
"dsh": {
"profile": {
"bundles": [
// …existing bundles…, "dsh-opencode-zen-plugin" ] } } }

然后在配置档目录里运行 pnpm install（插件管理器会替你执行），再重启 harness。想在不改动默认模型的前提下试用，在模型选择器里选 OpenCode Zen Free → <model>。

仓库里已经带了编译好的 lib/ 产物，所以从 GitHub 安装不需要构建步骤。想克隆下来改代码？在检出目录里执行 pnpm install && pnpm build，再用
"dsh-opencode-zen-plugin": "link:/path/to/checkout" 让配置档指向它。

想把它设为新智能体的默认模型，在配置档的 cordis.patch.yml 里加上：

- id: agent-default-model
name: '@deepseek-ai/dsh-agent-default-model'
config:
provider: opencode-zen-free
model: deepseek-v4.1-flash-free

方案 C — 一次性补丁覆盖

dsh --profile <your-profile> --patch ./opencode-zen.yml "your task"

opencode-zen.yml 里只放上面那段 agent-default-model 补丁（bundle 本身必须已经安装）。

从源码安装（开发）

git clone https://github.com/Devanand-PA/dsh-opencode-zen-plugin.git
cd dsh-opencode-zen-plugin
pnpm install
pnpm build # tsc → lib/
pnpm typecheck

用 "dsh-opencode-zen-plugin": "link:/path/to/dsh-opencode-zen-plugin" 让配置档指向检出目录，然后在配置档目录里重新运行 pnpm install。

可选：真实的 OpenCode API key

匿名访问用字面量 token public 即可。如果你有 OpenCode API key（限额更高），把它存为凭据 OPENCODE_ZEN_FREE_API_KEY（harness 凭据存储 / Models 页面）；插件每次请求时解析它，没有就回退到匿名访问。

配置

dsh-opencode-zen-plugin: 设置段（bundle 的条目 id 就是命名空间；所有字段都是易变的，改动后插件会重新读取）：

| 设置 | 默认值 | 含义 |
| maxRequestImageBytes | 2097152 | 提供给 Zen 的图片附件上限（字节） |
| requestImageMaxBytes | 1048576 | 超过此值的图片改为转成文本 |
| requestTimeoutMs | 60000 | 单次请求响应头的截止时间。头一到计时器就清除，所以长流不会被截断；静默丢弃请求的路由会直接失败，而不是把这一轮卡死 |
| streamIdleTimeoutMs | 120000 | 两个流式数据块之间允许的最长静默时间 |
| retryPolicy | 2 次重试，1–5s 退避 | Zen 临时故障的重试行为 |

请求卡住时

免费层是共享容量，路由一旦断开，请求可能永远挂在那里。三处设置把这种情况限制住：

- requestTimeoutMs：响应头没按时到达，请求直接失败。
- streamIdleTimeoutMs：流在回答中途静默，请求直接失败。
- 插件默认的重试策略只允许 两次 重试（总共三次尝试），而不是 harness 默认的五次，这样一条死掉的路由不会让界面冻结半小时。

如果免费层拥塞导致正常请求超时，把 requestTimeoutMs 调到 120000–180000；如果你更希望快速失败，就调低。

取消一轮对话（界面里的 Stop 控件）会立即中止请求——插件把 harness 的中止信号转发给 fetch。

匿名免费层校验

OpenCode 的免费层在服务端设了校验，要求请求看起来像 OpenCode 命令行。这些要求是通过对 OpenCode 命令行做抓包、对着一个记录日志的代理逐项二分定位出来的（细节见 notes/opencode-zen-anonymous-gate.md）。
本插件自动满足全部要求：

1. Authorization: Bearer public（真实密钥同样可用）
2. User-Agent: opencode/<semver>，semver ≳ 1.11（插件固定一个已知可用的版本——不探测版本，启动时不联网）
3. x-opencode-session / x-opencode-session-id / x-session-affinity /
x-session-id：每个 DSH 会话一个 ses_… id（26 个 base62/hex 字符），按 OpenCode 的 id 格式生成，并复用同一个以利于缓存
4. 请求体必须声明名为 read 的工具（以及 bash）——harness 没发这些工具时，插件用无害的占位项补齐工具列表，真实请求保持原样
5. "stream": true

harness 会在模型请求头上覆盖写入自己的归属 user-agent，所以插件包装了 globalThis.fetch（作用范围限于 opencode.ai 的推理/zen URL——或覆盖后的 DSH_ZEN_BASE_URL 主机），在传输层恢复所需的 opencode/<semver> UA。

模型可用性：

- GET https://opencode.ai/zen/v1/models（无需认证）列出模型；models.dev 中零成本的条目（或带 -free 的 id）会暴露出来。付费模型需要真实密钥，匿名使用时隐藏。
- muse-spark- 模型使用 OpenAI responses API；这里的其他模型都用 chat completions。

故障排查

- 429 / "Upstream request failed" —— 免费层是共享容量；上游临时故障和限流很正常。harness 的重试策略能处理大部分情况；再试一次或换一个免费模型。
- 每次调用都报 FreeTierError / 403 —— 请求看起来不像 OpenCode 命令行。如果你通过自定义代理转发 Zen，设置 DSH_ZEN_BASE_URL（例如 http://127.0.0.1:8899/v1）；插件会修补该主机也要带 UA。
- 426 Upgrade Required — OpenCode 把版本下限提到了插件锁定的 opencode/1.19.3 之上；更新插件（或提 issue）。
- 选择器里找不到模型 — 选择器离线提供 pi-ai 内置的零成本 OpenCode 模型；实时目录（多几个模型，包括 muse-spark- 这类 responses 模型）要等后台刷新才到。想强制刷新，删掉 $DSH_HOME/cache/dsh-opencode-zen-plugin-catalog.json（旧的 opencode-zen-free-catalog.json 会被读取并自动升级）。
- DSH 0.2.1-alpha. 打印 "skipping profile bundle" — 这是有意为之。插件只兼容 0.2.1-rc.2；alpha 构建被排除在外，因此永远不会受它影响。
- Zen 回合中 UI 卡死 — 请求一直没回来。在聊天里按 Stop（插件会把 harness 的中止信号转发给 fetch，请求立刻终止），或者等 requestTimeoutMs 超时。如果不得不杀掉进程，Ctrl+C 管用：中断后 harness 会在 5 秒后强制退出，插件在销毁时会中止自己尚未完成的请求。最后手段，也用来清理被杀掉的 wrapper 留下的孤儿进程：

pkill -f 'dsh/lib/bin.js' # the harness processes
pkill -f 'npm exec @deepseek-ai/dsh' # a wrapper that survived them
killall -9 node # everything, if nothing else helps

致谢

逆向工程与设计参考 —— 感谢：

- jiesou/dsh-opencode-zen-free-provider
（DSH 侧形态的主要参考；本插件针对 0.2.1-rc.2 的接缝，并增加了线路级门控、会话 id、工具填充、拒绝改写，以及基于 models.dev 的免费模型过滤）
- edynasty/dsh-opencode-go-provider
- wyouwd1/dsh-opencode-models
- opencode — id 格式和客户端行为来自它的源码（packages/schema/src/identifier.ts）

许可证

MIT