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 免费模型」分组
- 确认
package.json 的 dependencies 与 dsh.profile.bundles 都加了
- 确认
cordis.patch.yml 里的 id 是 llm-opencode-zen-free
- 重启 DSH Desktop
模型不调用工具
bash 与 read 需要注册成功才会被调用。若启动日志里有「未找到工具注册表」告警，说明宿主的工具服务未就绪——重启 DSH 通常可解决。
卸载
dsh plugin --profile desktop remove dsh-opencode-zen-free
并从 cordis.patch.yml 删除 llm-opencode-zen-free 段落。
说明
- 免费额度为共享池，高峰期可能被限流，
private 模式更稳。
- 部分免费模型会把输入用于改进模型，勿传敏感数据。
- 建议仅用于个人实验，不要用于生产环境。
想了解免费层的准入机制与实现细节，见 NOTES.md。
