前言¶
在 DeepSeek Harness（DSH）里接第三方模型，常见做法是自备 API Key、维护端点配置，或自己写适配层。OpenCode 提供一批可免费调用的模型，但协议与 DSH 原生模型选择器并不直接一致。若你希望在 DSH 里选用这些模型、又不想默认注册 OpenCode 账号或填写 API Key，需要一层桥接插件。
下面介绍社区插件 dsh-opencode-bridge（维护者 Vikrant-Aleph，GitHub 仓库 Vikrant-Aleph/dsh-opencode-bridge）。它通过兼容客户端协议，把 OpenCode 免费模型挂进 DSH 的模型选择器；分类上属于「模型推理」类插件。插件为非官方项目，与 OpenCode、DeepSeek 无隶属关系；上游协议、模型与免费额度可能变化，持续可用性不作保证。
这是什么¶
dsh-opencode-bridge 是发布在 npm 上的 DSH 插件（当前文档示例版本 0.5.3）。一句话定位：在 DSH 中使用 OpenCode 免费模型，默认无需 OpenCode 账号或 API Key。
模型请求会发往 OpenCode 服务；若配置了代理，流量会经你指定的出口。安装前建议阅读仓库源码与 MIT 许可证，并理解插件以当前 DSH 进程权限运行。
核心功能¶
以下能力均来自项目 README 与 package 描述，可按需选用。
模型列表自动刷新¶
启动时拉取免费模型列表，默认每 10 分钟刷新一次；上游目录增删模型时，插件会同步增删。若某次刷新失败，会保留上一次成功获取的列表。列表变更会通知 DSH 模型选择器，一般无需重启插件；高级刷新间隔见仓库 TECHNICAL.md。
流式输出与工具调用¶
支持流式回复与多步工具调用，并在多步调用间保留 reasoning 历史；适配 DSH 原生工具。对无法安全转换的调用会拒绝，而不是把 Bash 命令误当成 PowerShell 执行。工具兼容问题可借助诊断日志或代理工具 opencode_bridge_audit 排查（见下文故障排除）。
可选的出口代理轮换¶
可配置多条 HTTP(S) 或 SOCKS 代理；在明确的出口配额错误或连接失败时，按列表顺序尝试其他可用出口，并尊重服务端要求的等待时间。未配置代理时，使用本机直连。
安装与启用¶
安装包名与版本须与资料一致，优先使用官方 npm 源（镜像同步新版本可能滞后）。
在 DSH Desktop 中安装¶
- 打开侧栏 Plugins，右上角点击 Add plugin。
- 在安装源中填写：
dsh-opencode-bridge@0.5.3
- Installation source 优先选官方 npm registry。
- 点击 Install 并等待完成。
命令行安装¶
将 desktop 换成你实际使用的 profile：
dsh plugin --profile desktop add dsh-opencode-bridge@0.5.3
若终端没有 dsh 命令：
npx @deepseek-ai/dsh plugin --profile desktop add dsh-opencode-bridge@0.5.3
安装完成后，在模型选择器里选择 OpenCode Bridge 下的模型。若未出现，重启对应 DSH profile。常规使用不需要 API Key，也无需手改配置文件。
典型用法¶
日常对话与 Agent¶
安装并启用插件后，在 DSH 模型选择器中选择 OpenCode Bridge 提供的某一免费模型即可开始对话或运行 Agent。默认路径主要支持文本与工具调用；图片与附件内容不会完整转发给模型，有强多模态需求时需另选方案。
可选：配置出口代理¶
本机无法直连或需要轮换出口时：
- 打开 Settings → OpenCode Bridge → Egress rotation (optional)。
- 逐条添加已有代理地址，例如
http://127.0.0.1:7890或socks5h://127.0.0.1:1080；可保留direct（本机）作为一条出口。 - 使用 Test all 检测连通性；处于冷却期的条目会被跳过。增删条目会自动保存并生效。
插件按列表顺序优先使用就绪的出口；代理密码以明文保存在本地配置中，勿对外发布配置文件。仅使用你有权使用的代理，并遵守上游服务限制。支持 HTTP(S)、SOCKS4/4a、SOCKS5/5h。
适用场景与注意¶
适合谁：已在用 DSH、想试用 OpenCode 免费模型、且接受请求经第三方服务处理的开发者。不想维护 OpenCode 专用客户端、又希望模型列表随上游自动更新时，该插件较省事。
使用注意：
- 非官方桥接；上游变更可能导致个别模型或能力不可用。
- 勿向模型发送不愿交给 OpenCode（及所配代理）的敏感内容。
- DSH 对失败请求最多自动重试两次；已开始流式输出的回复不会自动重放。
- HTTP 403、503 以及模型后端不可用、未说明原因的 429 不会自动触发代理 failover。
常见问题（摘自 README）：
| 现象 | 建议 |
|---|---|
| 安装后没有模型 | 确认 profile、插件已启用，重启 DSH 并检查网络。 |
| 工具结果后 thinking 模式失败（缺少 reasoning_content） | 升级到 0.5.3 及以上。 |
| HTTP 429 | 稍后重试；若配置了代理，在设置中查看代理状态。 |
| HTTP 403 / 503 | 检查插件更新与上游状态后重试；不触发代理切换。 |
| 工具调用失败 | 查看 Diagnostic log，或让 Agent 执行 opencode_bridge_audit。 |
问题反馈可在 GitHub 使用 Issue 模板，提交前脱敏日志与截图。
结尾¶
dsh-opencode-bridge 把 OpenCode 免费模型以 DSH 可识别的形式接入模型选择器，并处理列表刷新、流式与工具桥接、可选代理轮换等运维细节。社区目录页：skillhub.cn 插件条目；源码与完整说明：GitHub 仓库。DSH 生态强调「一切皆插件」，目录站点为社区维护，与 DeepSeek / 幻方无官方从属关系；选用插件前请自行核对版本、权限与合规要求。
