免费模型探测 xiean676/dsh-freemodels-opencode

dsh-freemodels-opencode

把 opencode Zen 免费车道的模型接进 DeepSeek Harness，并且解决「这堆模型到底哪个能用」这个手工问题：

- 刷新模型：一键从上游重新拉清单（含 models.dev 的上下文窗口、弃用标记）。
- 勾选启用：勾上的模型才会以 provider opencode 出现在模型选择器里；一个都不勾 = 一个都不显示。
- 测试能不能用：对单个模型或全部已勾选模型发一个真实尺寸的请求，给出七档结论，而不是让你自己瞎试。

界面在 设置 → 模型 页底部，标题「opencode 免费模型」。

本插件是独立项目，不修改也不依赖 @opencode2dsh/dsh-plugin。两者可以共存：原插件负责它自己的 provider，本插件负责 provider opencode。

为什么需要它

上游 https://opencode.ai/zen/v1/models 现在返回 85 个模型 id，其中 76 个是付费模型。本插件在拉取时就把付费的丢掉，只留免费车道的那 9 个左右，所以卡片里、探测队列里、状态文件里都不会出现付费 id。

免费车道的判定不只看 -free 后缀：big-pickle 不带后缀也在车道上，反过来有些模型带 free 却在黑名单里。

剩下这一点是静态清单回答不了的：免费车道随时会因为限流、区域封锁、上游策略变化而失效，同一个模型几小时前 200、现在 429。所以「能不能用」只能是实时观测，本插件就是这么做的。

安装

dsh plugin --profile desktop add dsh-freemodels-opencode

或者从源码装：

git clone https://github.com/xiean676/dsh-freemodels-opencode.git
cd dsh-freemodels-opencode
npm install --ignore-scripts
npm run build
dsh plugin --profile desktop add .

装完重启 Harness，进 设置 → 模型，滚到最底下就是卡片。

桌面版的设置页在 Electron 里，本插件的桥接走同源 HTTP；如果卡片显示「读不到插件状态」，说明桌面端没把 webServer 服务暴露给插件，此时勾选和探测不可用（provider 本身仍然正常工作，用的是上次保存的勾选）。

界面怎么用

1. 点 刷新模型 —— 拉一次清单。首次装完会自动拉一次。列表里只有免费模型。
2. 勾想要的模型。勾上的才会出现在模型选择器里。
3. 点某个模型右边的 测试 —— 发一个真实尺寸的请求（512 token 上限，而不是一个 ping），几百毫秒到几秒出结论。
4. 或者点 测试已勾选（N） —— 串行测一遍已经勾上的。遇到「需付费」「车道额度用尽」，或者带 5 分钟以上 retry-after 的「被限流」就立刻停：这三种结论对剩下的模型必然一样，继续测只会烧掉你在等的那段额度。

免费车道的判定是启发式的（黑名单 → 已知白名单 → models.dev 零价 → 名字含 free）。如果某个刚上线的免费模型没被识别出来，或者某个付费模型混了进来，点 刷新模型 会重新判定；判定逻辑在 src/catalog.ts 的 isFreeLane。

七档结论

| 结论 | 含义 | 该怎么办 |
| 可用 | 上游真的答完了这次请求，不是只回了个 200 | 用 |
| 被限流 | 429 FreeUsageLimitError，这个出口的额度暂时用完；有 retry-after 会显示「约 N 秒/分钟后可再试」 | 等到那个时间点再测，不是不可用 |
| 车道额度用尽 | 403 FreeTierError：车道按客户端指纹拒绝了这台机器 | 换模型也没用，只能等上游放开，或者去用 opencode 本体 |
| 需付费 | 401/403 AuthError：匿名车道没有这个模型的凭据 | 换免费车道的模型 |
| 区域受限 | 403 RegionError：模型存在，但你当前出口 IP 所在国家/地区被拒 | 换网络出口 |
| 上游不提供 | 400：上游不认识这个 id，或不用 chat-completions 协议 | 别选它 |
| 未测出 | 超时、5xx、空响应 | 重测；不代表不可用 |

「被限流」和「可用」分开是有代价的：探测请求从 ping + 16 token 改成了一段要求数到 60 的真任务 + 512 token 上限。太小的请求只证明「那一刻还有一点点额度」，正好会造出你说的那种「测着可用、一问就 429」。现在测出来可用，就意味着这条链路刚刚真的完整答完过一次。

结论只在当前会话里存在，不落盘 —— 限流会过期，把「不可用」写进磁盘会一直骗人。

推理档位

免费模型里有 7 个支持推理档位，但各自能选的不一样（beam-free 是 low/medium/high/xhigh/max，deepseek-v4.1-flash-free 只有 low/high/max，big-pickle 上游没声明就按 off/minimal/low/medium/high 给）。插件把这些声明从 models.dev 读进目录，通过 LlmAdapter.resolveModel() 的 reasoning.efforts 交给 harness，所以你才能在模型选择器里看到档位、选得动。选中的档位在请求里落成 reasoning_effort（off 发出去是 none）。

如果某个模型在 DSH 里还是选不到档位：先点 刷新模型 重新拉一次元数据，再重启 DSH。档位来自目录，目录没刷新就不会出现在选择器里。

会话里失败时

真发消息时撞上限流，不再套用 harness 默认的「5 次重试、每次等几百毫秒到 10 秒」——那条策略会把同一次拒绝重花五遍，最后仍然失败，只是多等十几秒。插件通过 providerRetryPolicy() 声明自己的策略：

- RATE_LIMIT 不重试。429 带的窗口是分钟到小时级，一轮对话里重试等于白烧。
- AUTH、LANE_EXHAUSTED、REGION_BLOCKED、MODEL_UNAVAILABLE 不重试。这些换 key、换模型、等一会儿都不会自己好。
- 只对 EMPTY_RESPONSE、TIMEOUT、TRANSPORT 重试 1 次。

失败消息里会带上游给的等待窗口，例如「opencode: Rate limit exceeded. Please try again later.（上游建议 20 小时后再试）」，不必自己猜。装没装 llm-retry 插件都一样：没装就是直接失败并显示这句话，装了也应该只看到一次。

自己测

npm run typecheck # 宿主 + 客户端两套 tsconfig
npm run check # build + 三组离线冒烟，全都不打上游
npm run selftest # 14 组：会话头、清单、档位、分类、存储、路由、adapter、SSE、bundle
npm run render # 用真 React 渲染构建产物里那张卡，验首帧不崩
npm run interaction # jsdom 里点一遍：勾选、单条测试、刷新、批量测试、失败路径
node scripts/live-check.mjs # 可选，真打上游：刷新清单并逐个测，打印七档结论
node scripts/live-smoke.mjs # 可选，真打上游：走一遍 adapter 的流式链路
node scripts/integration.mjs # 可选，要 FMO_HOST_MODULES

integration.mjs 把宿主真的 LlmRuntime 拉起来跑一遍注册与流式，能抓到离线用例抓不到的契约漂移。宿主把 @deepseek-ai/ 打进 app.asar，普通 node 进程 import 不了，所以要用解包出来的依赖树：

FMO_HOST_MODULES=/path/to/extracted/@deepseek-ai/tree node scripts/integration.mjs

没设这个变量就跳过，不算失败。

render 和 interaction 需要 react-dom，interaction 还需要 jsdom。两者都是 devDependency，装了 node_modules 就有；缺了会跳过而不是失败。

它怎么实现的（给想改的人）

| 文件 | 作用 |
| src/zen-ids.ts | 免费车道要求的 ses_ 会话 id 与 7 个伪装头 |
| src/catalog.ts | 拉 Zen 清单 + models.dev 元数据，丢掉付费模型后合并出 ModelMeta[] |
| src/probe.ts | 单模型探测与七档分类（永不抛异常） |
| src/store.ts | $DSH_HOME/data/dsh-freemodels-opencode/state.json，串行写、原子替换 |
| src/adapter.ts | provider opencode 的 LlmAdapter：只列勾选的、流式转发 |
| src/bridge.ts | 四条同源路由：/status /refresh /select /probe |
| src/index.ts | 宿主入口：注册 adapter、首轮加载清单、挂路由 |
| src/client/ | 浏览器入口 + 卡片（只 require react） |

关键设计：模型清单的权威是这个插件自己。LlmAdapter.listModels() 返回的就是勾选集，勾选为空时返回 [] —— 宿主允许空目录，于是模型选择器里干干净净什么都不显示，正是要的行为。

许可

MIT。src/zen-ids.ts / 免费车道闸门 / models.dev 解码 / 错误分类的原始协议工作来自 opencode2dsh（MIT, Copyright (c) 2026 FishBottle7），详见 THIRD_PARTY_NOTICES.md。

上游服务由 OpenCode 运营，与本项目无关。