dsh-opencode-zen-free

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

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

---

安装

1. 复制到 profile

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

2. 注册到 profile

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

dependencies 加入：

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

dsh.profile.bundles 数组加入：

"dsh-opencode-zen-free"

3. 配置

编辑 ~/.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"

4. 重启 DSH

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

---

可用模型

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

免费模型由 OpenCode 侧提供，可用性与数据条款随时可能变化，以官方说明为准。

---

配置项

字段	默认值	说明
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 模式使用自有额度。

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。