dsh-opencode-free-model：为 DeepSeek Harness 接入免密钥免费模型通道

它是做什么的？

OpenCode Free Model 是 DeepSeek Harness（DSH）的模型接入插件，把 OpenCode Zen 的免费模型通道接进 DSH 的模型选择器，且无需任何 API 密钥。它解决的是「想用免费模型却要自己配密钥、自己适配协议」的麻烦：插件以 Host-only cordis 插件形式在 llm 服务上注册两条 provider 路由，把该通道的三种线上协议统一解码成 harness 的 StreamChunk 协议，并用后台探测决定哪些模型对外展示。由 artorias-zj 维护，采用 JavaScript 编写，创建于 2026-10-05。

核心功能

• 免密钥接入：该通道使用池化凭据，插件不持有也不存储你的任何密钥，启用后模型选择器里直接出现 OpenCode Free 分组。
• 三协议解码：按模型 id 分流到 Chat Completions、Responses、Messages 三种端点，三种 SSE 方言统一解码为同一套宿主块协议。
• 协议按报文形状判定：不信任网关返回的 Content-Type，改由响应体自身形状判断，且用于嗅探的字节会被回放，不缓冲任何 token。
• 指纹四件套：免费层要求请求体声明 bash/glob/grep/read 四个工具名，否则返回 403；缺失槽位会先用真实工具顶替再伪造，响应侧还原调用方自己的拼写。
• 可用性探测与区域路由：后台探测把每个模型标记为可用、区域受限、不可用、限流或未知，受区域限制的模型转入单独路由，可配置隐藏。
• 推理截断续写与预算档位：因推理被截断且无可见输出的回合会从检查点续写一次并关闭工具；light/balanced/deep 映射为真实输出预算，因为该通道只认 max_tokens。

怎么使用这个插件？

在 DSH 中启用该 DeepSeek Harness 插件并重启后，模型选择器里会出现 OpenCode Free 分组，直接选中其中的模型即可对话，无需填写任何密钥。分组内模型按显示名排序，顺序稳定、刷新不跳动；若你所在网络被区域限制，受限模型会出现在带原因标注的第二个分组里，可通过配置项隐藏该分组。会话保持一对一稳定映射，避免因每请求新建会话而被网关按会话计费限流。

报错怎么排查？

若请求返回 403 FreeTierError，说明请求体没有声明免费层要求的工具名，插件会自动补齐后再重试。若出现 429 限流，通常是会话不稳定或该轮全部被限流，插件会指数退避并重新探测，等待后重试即可。若模型在列表中消失，多为上游已下架该模型或探测判定为不可用，按官方说明重新探测或更换模型即可。