---

dsh-plugin-adapter 会向 DSH 注册一个原生的 LlmAdapter，直接流式对接 OpenCode Zen 的匿名免费通道——也就是 OpenCode 官方 CLI 无需登录即可使用的那批免费模型，它们会以 opencode2dsh 这个常规 provider 出现在你的 DSH 模型选择器里。

插件发出的请求与 OpenCode CLI 的流量完全同形（相同的 User-Agent、相同的 关联请求头），模型目录通过三级回退链保持新鲜。不用登录任何账号，也不用 自己部署任何东西。

特性

• 零凭据、零配置——匿名通道不需要任何 Key；装好、重启、开聊
• 原生 adapter，无 sidecar——一个 npm 包，没有子进程、没有二进制、没有本地端口（旧版 Go sidecar 不随包发行，见 legacy/）
• CLI 同形伪装——请求携带 OpenCode CLI 的 User-Agent 和整套会话/请求/项目关联头
• 网关兼容跟踪——Responses-only 模型自动走 /responses，真 session 同步让免费通道在网关只认真 session 时保持可用
• 实时目录 + 三级回退——上游实时列表 ∩ 元数据判定免费，断网时依次回退到磁盘缓存与已验证的静态名单
• 自愈能力——启动期快速重试、周期刷新，并落盘健康快照便于排查
• 规范的错误呈现——上游故障（限流、鉴权、超时、传输）以分类的 finish 原因送达 DSH，重试策略始终由 DSH 掌控

环境要求

带 web profile 的 DSH（DeepSeek Harness）；Node.js ≥ 20（DSH 能跑就满足）； 出站 HTTPS 需可达 opencode.ai 与 models.dev。

安装

从插件市场安装（推荐，收录后可用）：在 DSH 里打开 设置 → 插件市场， 搜索 dsh-plugin-adapter，一键安装。

从 GitHub 安装：

dsh plugin --profile web add github:1624318455/dsh-plugin-adapter

从 npm 安装：

dsh plugin --profile web add @memef1f1y/dsh-plugin-adapter

从源码安装（自行打包）：

git clone https://github.com/1624318455/dsh-plugin-adapter.git
cd dsh-plugin-adapter/packages/plugin
pnpm install && pnpm pack
dsh plugin --profile web add ./memef1f1y-dsh-plugin-adapter-<version>.tgz

验证：重启 dsh web，打开模型选择器，在 opencode2dsh 分组里选模型即可。

配置

默认配置开箱即用。需要覆盖时，编辑 profile 的 cordis.patch.yml：

- id: opencode2dsh
  name: '@memef1f1y/dsh-plugin-adapter'
  config:
    mode: adapter        # adapter（默认）| sidecar
    providerId: opencode2dsh
    refreshSeconds: 300  # 目录刷新周期（秒）

配置项	默认值	说明
mode	adapter	adapter：原生 LlmAdapter 直连 Zen。sidecar：旧版本地 agent 模式，不随包发行——请从 legacy/agent 自行构建并通过 agentPath 指定。
providerId	opencode2dsh	在 DSH 中显示的 provider 名称。
refreshSeconds	300	实时目录刷新间隔；定价元数据每 24 小时刷新。
gatewaySession	—	本机 CLI 的真 session id，作为 x-opencode-session 发送（Zen 只认它见过的 session）。优先于 gatewaySessionFile。
gatewaySessionFile	—	存 session id 的文件（单行），每轮重读，外部脚本轮换无需重启。
agentPath	自动解析	仅 sidecar：agent 二进制路径。
agentArgs	—	仅 sidecar：传给 agent 的额外 CLI 参数。
restartDelayMs / restartMaxDelayMs / maxConsecutiveCrashes	1000 / 60000 / 5	仅 sidecar：重启退避与熔断阈值。

工作原理

DSH 会话
   │  harness chunk（block-start / text-delta / usage / finish …）
   ▼
ZenAdapter（注册的 LlmAdapter）
   │  pi-ai openai-completions 流式（chat 模型）
   │  pi-ai openai-responses 流式（Responses-only 模型）
   ▼
https://opencode.ai/zen/v1        ← Authorization: Bearer public
   携带与 CLI 同形的请求头：
     user-agent: opencode/<当前版本>（裸串，无后缀）
     x-opencode-client, x-opencode-session, x-session-affinity,
     X-Session-Id, x-opencode-request, x-opencode-project

• 会话关联——默认 session/project id 由会话首条用户消息经 SHA-256 派生 （同一会话稳定、不可逆推），每个请求再附带一个全新的随机 id。设置了 gatewaySession/gatewaySessionFile 时，发送同步来的真 session （Zen 只服务它见过的 session）。
• 目录回退链——S1：实时 GET /v1/models；S2：models.dev 定价元数据判定 “免费”；S3：编译期验证的静态名单。上游故障时由磁盘缓存（约 7 天有效期）兜底。
• 韧性——adapter 在启动时立即注册；若首次目录拉取撞上网络尚未就绪 （VPN/TUN 重连、DNS 等），会以短周期重试（约 1 分钟内），随后转入常规刷新。 Responses 模型正文静默窗口放宽到 300 秒（阵发式 reasoning）；chat 模型保持 120 秒默认。
• sidecar 模式（mode: sidecar，旧版）——拉起本地 Go agent（ opencode2api 的单租户移植版）， 监听 127.0.0.1:<随机端口>、token 鉴权，并注册标准 llm-pi-ai 路由。 不随包发行；请从 legacy/agent 构建（go build ./cmd/agent）并把 agentPath 指向产物。

边界情况处理

• Responses-only 模型（muse-spark-*）：chat 必裸 500，/responses 200——自动路由，无需配置。
• 未知 session：网关只认它见过的真 session，未知 id 一律 403 FreeTierError——用 gatewaySessionFile 同步本机 CLI 的 session。 （注意：非流式探测必 403——排查一律用 stream:true 对照。）

设置持久化

adapter 配置在 profile 的 cordis.patch.yml 里（随安装静态）。同步用的 session 文件是纯文本（单行），每轮重读。IP 池卡片（设置 UI）管实时路由； 目录健康状态落盘到 ~/.opencode2dsh/adapter-status.json。

健康状态与排查

插件在每轮刷新后写入健康快照：

~/.opencode2dsh/adapter-status.json

{
  "status": "ready",
  "total": 64,
  "exposed": 9,
  "lastError": "",
  "writtenAt": "2026-08-29T07:01:54.915Z"
}

现象	可能原因与处理
启动页报 Failed to load plugins … list slot "settings.plugin.item" requires options.id	DSH 版本过旧（≤ 0.1.0-rc.6）：升级 DSH 到 ≥ 0.1.0-rc.7（推荐最新）即可；模型路由不受影响。
只有 3 个模型	启动时网络未就绪，重试会在约 1 分钟内补齐；看 adapter-status.json 里的 lastError。
lastError: "fetch failed" 持续出现	出站 HTTPS 到 opencode.ai 被拦截；检查代理/VPN 规则。
对话中报限流错误	匿名通道按 IP 限额；切换网络节点或稍后再试。
muse-spark-* 经 chat 报 500	Responses-only 模型；已自动路由到 /responses。
403 FreeTierError：free tier can only be used from within OpenCode	Zen 只服务它见过的真 session：用 gatewaySessionFile 同步本机 CLI 的 session，403 复发就重跑同步脚本。
reasoning 模型报 stream body idle timeout	阵发式 chain-of-thought 触发看门狗；Responses 模型已用 300 秒。若持续出现，可能是出口节点掐长 SSE——换节点。
连接 127.0.0.1:* 报错	残留的 sidecar 路由遮蔽了 adapter；插件 ≥ 0.2.1 启动时会自动清理。
安装时报 ERR_PNPM_IGNORED_BUILDS	pi-ai 的传递依赖（@google/genai、protobufjs）带构建脚本，运行时并不需要。在插件市场里按提示选择允许/拒绝，或在 profile 的 pnpm-workspace.yaml 的 allowBuilds: 下把这两项设为 false。

常见问题

• 需要 API Key 吗？ 不需要。匿名通道的 Key 就是字面量 public；限额按出口 IP 算。
• 好好的模型突然 403/500？ Zen 会不打招呼迁移接口、收紧指纹——先升级插件，再对照上表。
• muse-spark 很慢？ 它默认高强度 reasoning，首字可达约 30 秒。这是模型特性，不是插件问题。

开发

git clone https://github.com/1624318455/dsh-plugin-adapter.git
cd dsh-plugin-adapter/packages/plugin
pnpm install
pnpm typecheck && pnpm test
pnpm build                    # 打包到 lib/

旧版 Go sidecar 在 legacy/agent（go test ./...）。架构说明与移植记录见 docs/。

发布：在 packages/plugin 执行 pnpm pack（prepack 会构建并同步文档）。

测试状态：全量 162 通过；3 组环境敏感用例（看门狗时序、实时订阅、机场 fixture） 在缺构建产物/网络/余量时失败，早于本 fork 即存在。

已知限制

• 免费模型在免费期内可能拿你的数据训练（Zen 政策）——敏感代码请用隐私模型或本地运行。
• Responses 模型依赖同步到的真 session；文件过期会 403，刷新即可。

致谢

• opencode2dsh（FishBottle7）—— adapter、目录与 IP 池设计源自该项目，本项目在其基础上做网关兼容维护。
• opencode2api，作者 @jasonxu114514——legacy/agent 里的旧版 Go sidecar 是其匿名通道实现的移植版。
• OpenCode——运营免费匿名 Zen 通道。
• @earendil-works/pi-ai——adapter 模式使用的线上协议层。
• DeepSeek Harness 与 dsh-market 社区。

友链

许可证

MIT © FishBottle7, © 1624318455