dsh-opencode-zen-free

把 OpenCode Zen 的免费模型接入 DeepSeek Harness（DSH） 的模型选择器。

• 免 key 即可用：默认走公共额度，不需要 OpenCode Console 账号
• 零本地依赖：不需要本机装过 OpenCode，不需要登录，不读任何本地数据
• 零第三方依赖：只依赖 Node 内置模块与 DSH 自身的包
• 支持工具调用，bash / read 是真实可执行的工具，不是占位

---

安装

推荐用 npm 安装（也可手动复制文件，见下方「手动安装」）。

方式一：npm（推荐）

dsh plugin add dsh-opencode-zen-free

然后跳到第 3 步「配置」。

如果 dsh plugin 子命令在你的版本里不可用，退回到方式二。

方式二：手动安装

复制到 profile 的 node_modules：

PROFILE="$USERPROFILE/.dsh/profiles/desktop"
cp -r dsh-opencode-zen-free "$PROFILE/node_modules/"

编辑 ~/.dsh/profiles/desktop/package.json：

dependencies 加入：

"dsh-opencode-zen-free": "file:./node_modules/dsh-opencode-zen-free"

dsh.profile.bundles 数组加入：

"dsh-opencode-zen-free"

配置

编辑 ~/.dsh/profiles/desktop/cordis.patch.yml，追加：

- id: llm-opencode-zen-free
  name: "dsh-opencode-zen-free"
  config:
    mode: anonymous          # 免 key 走公共额度；改成 private 用自己的 key
    providerId: "opencode-zen-free"
    displayName: "OpenCode Zen 免费模型"

想用自己的 Console API key（公共额度被限流时更稳）：

- id: llm-opencode-zen-free
  name: "dsh-opencode-zen-free"
  config:
    mode: private
    apiKey: "oc_sk_你的key"

重启 DSH

模型选择器会出现「OpenCode Zen 免费模型」分组。

---

可用模型

清单取自 OpenCode 的 models 端点（https://opencode.ai/zen/v1/models）实际返回的 id，不是照抄官方文档。

模型	说明
big-pickle	Stealth 模型，免费期数据可能用于改进
longcat-2.5-preview-free	零留存
mimo-v2.6-flash-free	免费期数据可能用于改进
glm-5.3-flash-free	限时免费，零留存
deepseek-v4.1-flash-free	限时免费，零留存
minimax-m3.1-flash-free	限时免费，零留存
nemotron-3.5-lightning-free	NVIDIA 试用端点，勿传敏感数据
nemotron-3.5-super-vl-free	NVIDIA 试用端点，支持图片输入
beam-free	数据保留 30 天；中国大陆/香港/澳门等地区不可用

免费模型由 OpenCode 侧提供，可用性与数据条款随时可能变化，以官方说明为准。 上游会增删免费模型（例如 space-bunny-free 已下线），插件不自动跟随， 更新插件即可拿到新清单。

---

配置项

字段	默认值	说明
mode	anonymous	anonymous 免 key；private 用自己的 Console API key
apiKey	—	Console API key，仅 private 模式使用；留空则读 OPENCODE_API_KEY
baseUrl	https://opencode.ai/zen/v1	上游端点
providerId	opencode-zen-free	在模型选择器里的 provider id
displayName	OpenCode Zen 免费模型	模型分组显示名
maxAttempts	12	上游偶发错误时的最大重试次数
retryBaseDelayMs	400	首次重试等待毫秒（之后按倍数增长）
retryMaxDelayMs	4000	重试等待上限毫秒
streamIdleTimeoutMs	180000	流式响应空闲超时
registerGateTools	true	把 bash / read 注册为可执行工具

---

常见问题

模型调用返回 RegionError

该模型不在你所在地区开放。beam-free 明确排除中国大陆/香港/澳门等地区，换其他模型即可。

间歇性失败

上游偶发空响应错误，插件会自动重试（默认最多 12 次）。若持续失败，换一个模型，或切到 private 模式使用自有额度。

所有模型返回 FreeTierError（提示「can only be used from within OpenCode」）

这不是配置问题，是 OpenCode 侧对出口 IP 的风控判定。免费层是 IP 维度封禁，与账号无关，换 API key 无效。表现通常是：免费模型全部 403，而付费模型仍能正常返回余额/计费错误。

可尝试的解法（按成功率排序，均不保证）：

1. 换一个干净的出口 IP（重启光猫、切换网络、换代理节点）
2. 用 private 模式配合自己的 Console key —— 若付费层正常，这条能立刻恢复可用
3. 邮件申诉至 help@anoma.ly（OpenCode 官方只认这个渠道，GitHub issue 多为模板回复）

若你之前密集测试过，很可能触发了频次阈值；建议改为按需调用，不要短时间大量重试。

private 模式全部 401

apiKey 没配上。检查 cordis.patch.yml 里的 apiKey，或设置环境变量 OPENCODE_API_KEY。

看不到「OpenCode Zen 免费模型」分组

1. 确认 package.json 的 dependencies 与 dsh.profile.bundles 都加了
2. 确认 cordis.patch.yml 里的 id 是 llm-opencode-zen-free
3. 重启 DSH Desktop

模型不调用工具

bash 与 read 需要注册成功才会被调用。若启动日志里有「未找到工具注册表」告警，说明宿主的工具服务未就绪——重启 DSH 通常可解决。

---

卸载

dsh plugin --profile desktop remove dsh-opencode-zen-free

并从 cordis.patch.yml 删除 llm-opencode-zen-free 段落。

---

说明

• 免费额度为共享池，高峰期可能被限流，private 模式更稳。
• 部分免费模型会把输入用于改进模型，勿传敏感数据。
• 建议仅用于个人实验，不要用于生产环境。

想了解免费层的准入机制与实现细节，见 NOTES.md。