@satanfire/opencode2dsh
在 DSH（DeepSeek Harness）里使用 OpenCode Zen 的匿名免费模型：原生 LlmAdapter，无需 API Key，零运行时依赖。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:satanfire/opencode2dsh#3ace5c0510c87425dff871f3aa15dce8e84105adOpencode2dsh 以 @satanfire/opencode2dsh 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
在 DSH（DeepSeek Harness） 里原生使用 OpenCode Zen 的匿名免费模型。
无需 API Key，无需注册，无子进程，零运行时依赖。
OpenCode 的 CLI 无需登录即可访问一批 Zen 免费模型。本插件把这条匿名通道接成 DSH 的
原生 LlmAdapter：装好后，opencode2dsh 会作为一个普通 provider 出现在模型选择器里，
和内置 provider 一样直接选用。
public，不需要任何个人密钥node: 内置模块，没有 dependencies，安装时不会触发依赖构建脚本llm-retry从 GitHub 安装：
dsh plugin --profile web add github:satanfire/opencode2dsh
从本地目录安装：
git clone https://github.com/satanfire/opencode2dsh.git
dsh plugin --profile web add ./opencode2dsh
装好后重启 dsh web，在模型选择器的 OpenCode Zen 免费 分组里选模型即可。
不需要修改默认模型配置。
包名与 provider 名不是一回事。 包名是
@satanfire/opencode2dsh，装到node_modules/@satanfire/opencode2dsh； provider 名是opencode2dsh，也就是模型选择器里的分组，以及请求里的provider字段。 两者都可以用配置里的providerId单独调整（包名除外）。
默认配置开箱即用。需要覆盖时，在 profile 的 cordis.patch.yml 里改这一行：
- id: opencode2dsh
name: '@satanfire/opencode2dsh'
config:
refreshSeconds: 900
| 配置项 | 默认值 | 说明 |
|---|---|---|
providerId | opencode2dsh | provider 路由名，也是模型选择器里的分组名 |
refreshSeconds | 900 | 模型目录刷新周期（秒） |
startDelayMs | 3000 | 首轮探测的延后，避免与启动期请求抢连接 |
requestTimeoutMs | 300000 | 单次请求总超时（毫秒） |
exposeAll | false | true 时跳过可用性探测，直接暴露全部免费候选 |
modelOverrides | {} | 按模型 id 覆盖展示名与容量，见下 |
- id: opencode2dsh
name: '@satanfire/opencode2dsh'
config:
modelOverrides:
big-pickle:
name: Big Pickle
contextWindow: 262144
maxTokens: 32768
上游不公布免费模型的上下文窗口，插件默认按保守值申报（上下文 131072、输出上限 16384）。
知道确切值时用 modelOverrides 覆盖，避免 DSH 过早压缩或请求超出模型容量。
DSH 会话
│ StreamChunk（block-start / text-delta / reasoning-delta / tool-call-delta / usage / finish）
▼
ZenAdapter（本插件注册的 LlmAdapter）
│ OpenAI chat/completions 流式协议
▼
POST https://opencode.ai/zen/v1/chat/completions
Authorization: Bearer public
user-agent: opencode/<版本> (<平台> <架构>; node<版本>)
x-opencode-client / -session / -request / -project
上游按客户端形状放行匿名通道，三者缺一即 403 FreeTierError：
user-agent 必须是 opencode/<版本> (...) 的形状，追加任何后缀都会被拒；ses_ + 12 位小写 hex + 14 位 Base62。
那 12 位 hex 不是随机串，而是把真实毫秒时钟加每毫秒序号后整体按位取反，
上游会解回时间戳并校验低 12 位序号；stream: true，且 tools 数组里出现 bash 与 read。插件的处理：
bash / read 时补占位定义；tool_choice: "none"，模型不会真的去调用它们。listModels 只返回探测通过的模型：
GET /v1/models 拉取上游在售列表；-free 后缀，或已知的免费别名）；200 与 429（被限流但已放行）算通过，
地区封锁与协议不支持排除；$DSH_HOME/opencode2dsh/catalog.json，供下次启动直接使用。只有确定性拒绝（地区封锁、协议不支持）才会把模型从列表里摘掉。 探测撞上网络错误、两次都拿不到结论时，上一轮已知可用的模型会被保留—— 网络抖动不该让正在使用的模型从选择器里消失。从未成功过的候选不给这个豁免。
刷新失败不会清空现有列表：插件保留上一次的结果并记录原因，然后按短周期重试。
只有两三个模型
首轮探测尚未完成，或当前出口 IP 被上游按地区限制。看
$DSH_HOME/opencode2dsh/catalog.json 里的 lastError。等待一次刷新周期即可补齐。
对话中报限流
匿名通道按 IP 共享配额，429 很常见。插件已把 provider 重试策略放宽到 8 次、1s→20s 退避，
并把 RATE_LIMIT 交给 DSH 的 llm-retry。仍被打满时，换一个竞争较小的模型再试。
某个模型报"当前网络地区不可用"
Zen 不向该地区提供这个模型。这是上游限制，换用当前地区可用的模型即可。
装好后模型列表里没有这个 provider
重启 dsh web。DSH 的插件加载器按模块名缓存已导入的模块，替换已安装的包必须重启
才会加载新的 JS 代际。
和参考实现能一起装吗
不能。本插件与 @opencode2dsh/dsh-plugin 都注册 opencode2dsh 这个 provider 名，
同时启用会因为路由重名而注册失败。
npm test # 离线单元测试，不联网
npm run test:live # 联网集成测试：目录探测 + 文本流 + 工具调用
目录结构：
lib/protocol.js 请求伪装：会话 id、请求头、工具闸门
lib/models.js 模型元数据：展示名、容量、免费候选判定
lib/messages.js DSH 消息 → OpenAI 消息
lib/errors.js 上游失败 → DSH 失败码
lib/catalog.js 免费模型目录：发现、探测、落盘、刷新
lib/stream.js SSE 解析 + 流式块翻译
lib/adapter.js LlmAdapter 实现
lib/index.js 插件入口
改动后必须重启 dsh web 才会加载新代码。
这条通道能走通，靠的是前人的逆向与验证：
本插件是独立实现，不使用上述项目的代码；协议事实均以对上游的真实请求复核为准。