opencode2dsh：为 DeepSeek Harness 免密钥接入免费模型的 DSH plugin

它是做什么的？

opencode2dsh 是 DeepSeek Harness（DSH）的模型接入插件，把 OpenCode Zen 的匿名免费模型通道直接变成 DSH 模型选择器里的一个原生 provider。它解决的是「想用免费大模型却要注册、要填 API key、要额外跑一个本地进程」的麻烦，让你在 DSH 里装好重启就能直接开聊。插件以原生 LlmAdapter 形式注册，请求从本机发出时与 OpenCode 官方 CLI 的流量特征一致，模型目录则通过三级回退链保持新鲜。由 FishBottle7 维护，采用 MIT 协议，用 TypeScript 编写。

核心功能

• 零凭据零配置：匿名免费通道不需要任何 API key，也无需注册账号，安装后重启 DSH 即可在模型选择器里选到 opencode2dsh 分组下的模型。
• 原生适配器、无旁路进程：以单个插件包注册 LlmAdapter，不启动子进程、不依赖本地二进制、不占用本地端口，流式输出直接对接 DSH 会话。
• CLI 级请求伪装：每次对话按会话派生 OpenCode CLI 的 user agent 与 session/request/project 请求头集合，让出站流量与官方 CLI 一致。
• 可选思考等级：支持推理的免费模型会在 DSH 模型选择器里暴露 effort 选项，元数据提供阶梯的按声明展示，否则给出 Off/Minimal/Low/Medium/High；选 Off 会向上游发送停止思考的标记，不选则沿用 provider 默认值。
• 实时目录加回退链：上游实时列表与「按元数据判定免费」取交集，失败时依次回退到离线缓存和一份经验证的静态列表。
• 自愈与规范报错：启动快速重试、周期性刷新目录，并写出健康快照供诊断；上游的限流、鉴权、超时、传输类失败会以分类后的结束原因进入 DSH，重试仍由 DSH 掌控。

怎么使用这个插件？

在 DSH 的 web profile 下启用插件并重启后，打开模型选择器，从 opencode2dsh 分组里挑一个模型即可开始对话，全程不需要登录或填写密钥。默认配置开箱即用，需要调整时在 profile 的 cordis.patch.yml 里覆盖选项：mode 可选 adapter（默认，原生直连）或 sidecar（旧版本地 agent 模式，未随包分发），providerId 决定模型选择器里显示的名称，refreshSeconds 控制目录刷新节奏（默认 300 秒，价格元数据每 24 小时刷新一次）。运行环境要求 Node.js 20 及以上，并能出站访问 OpenCode Zen 与模型元数据服务；想确认是否生效，重启后看模型选择器里有没有出现对应分组即可。

报错怎么排查？

上游限流、鉴权、超时或传输失败会以分类后的结束原因出现在 DSH 中，先按这些分类判断是网络问题还是上游侧限制，重试交由 DSH 处理。若模型列表为空或长时间不更新，说明实时目录拉取失败，插件会自动回退到离线缓存与静态列表，可检查本机到 OpenCode Zen 与模型元数据服务的出站 HTTPS 是否通畅。插件会写出健康快照用于诊断，遇到异常时按官方说明查看该快照定位问题。