前言¶
DeepSeek Harness（DSH）的插件化架构让扩展能力变得灵活。但如果你本机已经安装了 OpenCode CLI，并在终端里免费用着它的免费模型，每次在 DSH 里切换回 OpenCode 就要多走一层流程。dsh-opencode-connect 插件做的就是把同一份本地能力直接接到 DSH 的模型选择器上，省掉来回切换的麻烦。
是什么¶
这是一个独立的 DSH bundle 插件，维护者为 sanser9。它把本机已安装的 OpenCode CLI 的免费模型（如 deepseek-v4.1-flash-free、glm-5.3-flash-free、big-pickle、kimi-k3-free、qwen3.7-max-free 等）接入 DSH 的模型选择器，让你在 DSH 里直接使用，无需 API Key、无需登录、不产生任何费用。
核心功能¶
- 零配置接入：装好 OpenCode CLI 和本插件，重启 DSH，模型选择器里会出现
OpenCode分组，无需任何配置。 - 免费模型自动发现：启动时从本机
opencode serve的/config/providers读取当前可用的免费模型；上游新增或下线模型时，插件每 5 分钟自动刷新一次目录，模型选择器随之更新（模型名统一带· Free后缀）。 - 自动管理 OpenCode 服务：检测到本机已有
opencode serve在跑就直接复用；没有才按需拉起，并在 DSH 退出时干净地回收自己启动的进程。 - 安全 loopback shim：每次进程启动生成一个 32 字节随机 secret，仅绑定
127.0.0.1，并校验Host/Origin必须是回环地址；真实的 OpenCode 服务地址不暴露给 pi-ai，适配器只拿到 shim 的地址与一次性 token。 - 流式输出与用量回传：把 OpenCode 的
message.part.delta事件流翻译成 OpenAI 兼容 SSE，包含增量文本、结束帧与 token 用量；中断时立即释放上游连接。 - 零费用：所有模型的
cost都被声明为 0，DSH 的用量统计不会虚报开销。
安装与启用¶
前置条件¶
- Node.js
^22.19.0或>=24.0.0（DSH 自身的要求） - DeepSeek Harness（桌面版或
dshCLI） - OpenCode CLI ≥ 1.18.0（免费层的版本门槛）
安装方式任选：
# 官方安装脚本（macOS / Linux）
curl -fsSL https://opencode.ai/install | bash
# 或通过 npm
npm install -g opencode-ai
# 验证版本（必须 >= 1.18.0）
opencode --version
插件按以下顺序查找二进制，任一命中即可：
~/.local/share/dsh-opencode-connect/bin/opencode
~/.local/bin/opencode
/usr/local/bin/opencode
PATH 上的 opencode
如果你的 opencode 不在上述位置，把它软链到 ~/.local/bin/opencode 即可。
安装插件¶
# 方式一：从 npm（发布后）
dsh plugin install dsh-opencode-connect
# 方式二：从源码（开发/自用）
git clone https://github.com/sanser9/dsh-opencode-connect.git
cd dsh-opencode-connect
npm install --omit=dev
npm run build
dsh plugin install "$PWD"
安装完成后重启 DSH（或让宿主重新加载 profile），模型选择器里会出现 OpenCode 分组。
典型用法¶
安装并重启 DSH 后，在模型选择器里找到 OpenCode 分组，选择任意带 · Free 后缀的模型（如 deepseek-v4.1-flash-free· Free），即可像使用其他 DSH 模型一样进行对话。整个过程无需 API Key，所有计算都在本地完成，费用为 0。
适用场景与注意¶
适合已经安装 OpenCode CLI 并希望统一在 DSH 里使用其免费模型、不希望引入第三方 API Key 或中转服务的用户。插件以当前 dsh 进程权限运行，安装前建议查看源码与许可证。需要说明的是，本插件依赖 OpenCode CLI 的免费层，属于非官方集成方式；上游一旦调整免费策略或接口，插件可能需要更新甚至失效。需要长期稳定与合规性时，请使用各家的官方 API。
短结尾¶
dsh-opencode-connect 把 OpenCode 的免费模型直接接入 DSH，零配置、零费用、开箱即用。你可以通过下面链接获取更多细节：
- GitHub：https://github.com/sanser9/dsh-opencode-connect
- 目录页：https://www.skillhub.cn/plugins/sanser9/dsh-opencode-connect
