dsh-connect-opencode

把本机 OpenCode（opencode serve）里的免费模型接入 DeepSeek Harness（DSH）的模型选择器。

免费 = OpenCode provider 目录里 cost.input / output / cache.read / cache.write 全为 0、能输出文本、未废弃的模型。 具体有哪些免费模型由你的 OpenCode 配置决定（包括你自己添加的 provider）；没有免费模型时列表为空，见下方 FAQ。

安装

• DSH 插件市场：搜索 dsh-connect-opencode 一键安装（推荐）。
• 手动安装：在 DSH profile 目录执行 npm install dsh-connect-opencode，并在 ~/.dsh/profiles/desktop/package.json 的 dsh.profile.bundles 数组末尾加上 "dsh-connect-opencode"，然后重启 DSH。

运行前提

• 已安装 DSH 和 OpenCode（opencode 位于 ~/.opencode/bin、npm 全局或 PATH）。
• OpenCode 里至少配置了一个免费模型/供应商（可用 opencode models 自查）。

设置（设置 > 模型）

安装后，DSH「设置 > 模型」页会出现 dsh-connect-opencode 卡片：

字段	默认	说明
enabled	true	是否向 DSH 提供 OpenCode 模型
binary	""	opencode 可执行文件绝对路径；空 = 自动发现
autoRefreshMin	15	每隔多少分钟重扫一次免费模型（0 = 不重扫）

也可以直接写进 profile 根 cordis.patch.yml 配置，无需界面：

- id: dsh-connect-opencode
  name: dsh-connect-opencode
  config:
    enabled: true
    autoRefreshMin: 10

工作原理

DSH (pi-ai) ──OpenAI 兼容──▶ 本插件的本地 shim (127.0.0.1:<随机端口>)
                                  │  协议转换（流式 / 工具调用）
                                  ▼
                          opencode serve --pure（隔离 XDG 目录 + 随机端口 + Basic 鉴权拉起）

• 隔离实例：插件自己拉起一个 opencode serve --pure，不加载全局插件、不占用你日常 OpenCode 的会话与状态；数据在 ~/.dsh/dsh-connect-opencode/ 下独立存放。
• 凭据复用：为让自定义 provider 与登录态在隔离实例中可用，会把你的全局 opencode.json(c) 与 auth.json（API key）复制进该隔离目录——仅存于本机，绝不上传。
• 免费模型筛选：从 /provider 目录筛出 cost 全 0、支持文本输出、未废弃的模型（覆盖所有 provider，含内置 Zen 与自定义 provider），刷新进 DSH 模型选择器。
• 工具执行权归 DSH：OpenCode 原生工具（bash/read/write…）一律 deny，模型发起的工具调用转换为 OpenAI tool_calls 由 DSH 执行。

CLI 自检

node bin/cli.js doctor   # opencode 可执行文件是否找到
node bin/cli.js models   # 列出发现的免费模型
node bin/cli.js chat "你好"   # 走完整链路发一条消息

FAQ

模型列表是空的？ 说明 OpenCode 当前没有 cost 全 0 的模型。先跑 node bin/cli.js models 看发现结果；需要免费模型可在 OpenCode 里配置带免费档的供应商（如 OpenCode Zen 免费档或你自己的免费 provider）。

已知边界

• 图片输入：仅接受 base64 data URL（PNG/JPEG/WebP/GIF），整请求 ≤ 8 MB。
• 采样参数：不转发 temperature/max_tokens 等；推理档位仅在模型声明 variants 时映射。
• 协议兼容：OpenCode 端 structured output 字段名可能随其版本变化，若工具调用异常请先跑 bin/cli.js chat 验证并提 issue。

测试

test/bridge.test.mjs 用模拟 opencode 服务器端到端验证发现、模型列表、非流式、SSE 流式与工具信封协议：

node --test test/

许可 / 致谢

MIT。协议层移植并简化自 ow-bridge（LaoDing，MIT）；插件结构参考 dsh-connect-workbuddy（dingminhua，MIT）。