OpenCode zen 免费模型（big-pickle）在 DSH 中必现 429 FreeUsageLimitError（附修复补丁）

[Liyuntong123]

问题 / Problem

在 DSH 中使用 opencode provider 的 zen 免费模型（如 big-pickle）时，每次生成请求都失败：

429: {"type":"FreeUsageLimitError","message":"Error from provider (Console): Rate limit exceeded. Please try again later."}

根因 / Root cause

OpenCode zen 网关（https://opencode.ai/zen/v1）的免费额度只放行带 opencode CLI 客户端标识（User-Agent: opencode/latest/<version>/cli）的请求；任何其他 User-Agent 都会被当作匿名客户端拒绝（直连实测可复现同一错误）。而 DSH 的 LLM 适配器按强制 attribution 策略给每个 provider 请求发送 User-Agent: deepseek-harness/<version> (+https://github.com/deepseek-ai/deepseek-harness)——正是被网关拒绝的身份。pi-ai 的 opencode 目录模型也没有自带 CLI headers（对比 github-copilot / kimi-coding 都在目录 JSON 里声明了 UA）。

社区常见绕行方案是本地起一个代理改写 UA（如 pi 的 zen headers 修复 方向一致），但需要用户额外运行一个进程，体验很差。

修复方案 / Proposed fix（补丁已完成，全部门禁通过）

在 dsh-llm-pi-ai 的 adapter 中，对指向 zen 网关的请求（provider 为 opencode/opencode-go，或解析后 baseURL 主机为 opencode.ai）发送 opencode CLI 客户端标识：

• User-Agent: opencode/latest/1.18.18/cli
• x-opencode-client: cli

其余 provider 仍发送 harness attribution UA。这属于 attribution 政策中的 provider 专属请求身份类别（与 DeepSeek 的 user-id / session-id 请求身份并列），并用新的 Agent Note 记录决策。

完整补丁在 fork 分支：https://github.com/Liyuntong123/deepseek-harness/tree/feat/opencode-zen-client-identity

包含：

• 代码改动：packages/llm/llm-pi-ai/src/adapter.ts（+54 行）
• 测试：mock-server wire 测试（zen 路由 UA / x-opencode-client）+ 谓词单测，adapter.ts 覆盖率 100%
• Agent Note（feature 类，中英双语三元组）
• 文档更新（llm-pi-ai README 中英 + docs/subsystems/llm-streaming.md 中英）
• 门禁：tests 104 passed / typecheck / lint / doc-sync（28 项 PASS）/ 翻译配对，全部通过

验证 / Verification

• 真实网关实测：仅带 User-Agent: opencode/latest/1.18.18/cli 的 chat completions → HTTP 200；不带 → 429（与上述错误一致）
• /models 不校验 UA（200），模型列表探测不受影响

如果维护者认可这个方向，我可以把补丁整理成正式 PR 提交。

[milandomio]

为啥不做成插件，这种绕过怎么可能给你合并

[Liyuntong123]

你也遇到了这个问题？如果确实很多人需要的话可以做一下。但是我昨天发现opencode zen的free好像是有限额的，我做这个是为了免费用big pickel的，现在我发现意义不大。

[milandomio]

可以考虑薅nvidia nim的 M3 或 Nemotron 3 Super，如果注册收不到短信用手机流量

[Jedidiah-Zhang]

万物皆插件，这种事情当然要做成插件。opencode zen的免费模型在任何非opencode环境都会报429。

[Liyuntong123]

如果opencode zen的免费模型没有这个限制的话，确实可以做成插件，我记得1，2个月以前big pickle似乎还没有这个限制，当时做小东西用的很爽。但是现在有了限额，而且限额似乎还很少，所以感觉没必要了

[ylwl1997]

OpenCode 免费套餐（zen / big-pickle）有严格的速率限制，DSH 这种高频工具调用场景很容易触发 429 FreeUsageLimitError——不是 DSH 的问题，是免费额度扛不住 agent 的调用频率。

实测建议：

• 轻度试用 → 免费套餐够用
• 正经跑任务 → OpenCode Go 套餐（首月 5 刀有 60 刀额度，按模型计费）或官方 DeepSeek API

三个方案的 base URL、模型名、邀请链接对比，整理在这：https://dshbase.com/blog/dsh-model-setup/

[Liyuntong123]

感谢您的分享，想请问一下为什么推荐agnes-2.5-flash吗？这个是目前效果比较好的免费模型吗？

[ylwl1997]

目前在免费模型阶，稳定和效果是比较有优势的，尤其是它的生图模型等

[liujianbo2013]

求插件

[QiE2035]

好巧，插件咱已经做了：https://github.com/QiE2035/dsh-llm-headers

[mc-lhz]

好巧，我也有：https://github.com/mc-lhz/dsh-add-headers-to-completions

[mc-lhz]

好巧，插件咱已经做了：https://github.com/mc-lhz/dsh-add-headers-to-completions

[zqy1-1]

不是只需要在保存provider的那个文件里加2行声明一下提供方就行了吗

[apanzinc]

详细讲讲？

[zqy1-1]

详细讲讲？
opencode在github里也有仓库，那边issue里有人说，就是加个请求头而已

[mc-lhz]

User-Agent: opencode/1.18.18

[mc-lhz]

对 User-Agent: opencode/1.18.18 在 2026-08-24 13:33:02，"zqy1-1" ***@***.***> 写道： 详细讲讲？ opencode在github里也有仓库，那边issue里有人说，就是加个请求头而已 — Reply to this email directly, view it on GitHub, or unsubscribe. Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS and Android. Download it today! You are receiving this because you commented.Message ID: ***@***.***>

[igofind]

似乎不行了

[shenxiu666]

这和dsh没关系，你需要自己有点手法才能解决

[mc-lhz]

现在又加了新的限制 在 2026-09-18 14:21:27，shenxiu666 ***@***.***> 写道： 这和dsh没关系，你需要自己有点手法才能解决 — Reply to this email directly, view it on GitHub, or unsubscribe. Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS and Android. Download it today! You are receiving this because you commented.Message ID: ***@***.***>

[mc-lhz]

加了新的限制 必须带完整工具，不然会403 在 2026-09-18 12:35:29，igofind ***@***.***> 写道： 似乎不行了 — Reply to this email directly, view it on GitHub, or unsubscribe. Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS and Android. Download it today! You are receiving this because you commented.Message ID: ***@***.***>