OpenCode Bridge
English | 中文
在 DeepSeek Harness（DSH）中使用
OpenCode 免费模型的插件，默认无需 OpenCode 账号或 API Key。
支持模型动态刷新、可选的上下文精简（精简已完成轮次思考）与代理出口轮换，
并提供默认拒绝不安全转换的工具桥及离线、按 Agent 作用域的兼容性审计。
主要功能
- 模型列表自动刷新：启动时获取免费模型列表，默认每 10 分钟重新获取一次，跟随上游增删模型；刷新失败时保留上次成功的列表。
- 可选上下文精简：仅精简已确认完成轮次的思考，保留当前工具链；默认仍完整回传。
- 流式对话与工具调用：保留多步工具调用中的思考历史，适配 DSH 原生工具，拒绝无法验证的工具转换，避免将 Bash 命令直接当作 PowerShell 执行。
- 可选代理轮换：配置多个 HTTP(S) 或 SOCKS 代理，在明确的出口配额限制或连接失败时尝试其他可用出口，并遵守服务端等待提示。
安装与开始使用
图片输入需要 DSH 的附件请求版本接口；本版按 DSH SDK 0.2.1-rc.2 构建和验证。
DSH Desktop 界面安装
- 打开左侧 插件 页面，点击右上角 添加插件。
- 在输入框中填写：
dsh-opencode-bridge@0.5.5
- 安装源建议选择 npm 官方源；如果使用镜像源，新版本可能需要等待同步。
- 点击 安装，等待安装完成。
命令行安装
从 npm 安装到你的 DSH profile：
dsh plugin --profile desktop add dsh-opencode-bridge@0.5.5
desktop 是示例 profile 名称，请按实际使用的名称替换。如果终端找不到 dsh，可使用：
npx @deepseek-ai/dsh plugin --profile desktop add dsh-opencode-bridge@0.5.5
安装完成后，在模型选择器中选择 OpenCode Bridge 下的模型即可开始对话；如果未显示，请重启对应的 DSH profile。
日常使用无需手动填写 API Key 或修改配置文件；列表变化会通知 DSH 模型选择器重新读取，无需重启插件。刷新间隔的高级配置见配置参考。
可选上下文精简
打开 设置 → OpenCode Bridge → 上下文精简，可开启 精简已完成轮次的思考。默认关闭，完整回传；仅清空已确认成功完成轮次的思考，保留当前工具链、无法确认或中断的历史，必要的 reasoning_content 字段仍会发送。
选项通过 DSH 保存，对后续新请求生效，不删除本地会话、不打断正在执行的请求。节省效果取决于上游，DSH 本地估算仍可能按完整历史计算；若连贯性受影响可关闭。
可选代理配置
不配置代理时，插件默认使用本机直连。
- 打开 设置 → OpenCode Bridge → 出口代理轮换（可选）。
- 逐个添加已有的代理地址，例如
http://127.0.0.1:7890或socks5h://127.0.0.1:1080。可保留direct（本机直连）作为一个出口。 - 点击 测试全部 检查连通性；冷却中的出口会跳过，避免提前发出请求。新增、删除操作会自动保存并应用。
插件按列表顺序优先使用可用出口。明确的出口配额错误或连接失败会使该出口暂时冷却；有服务端等待提示时不立即切换出口，全部出口冷却时也不会提前请求。模型后端暂不可用或原因不明的 429，不直接当作代理额度耗尽。
自动重试由 DSH 统一执行，最多重试两次；过长的等待会交还错误，供你稍后重试。已经开始输出的回复不会自动重放。
支持 HTTP(S)、SOCKS4/4a 和 SOCKS5/5h 代理。请仅使用获授权的代理并遵守上游服务限制。
注意事项
- 非官方项目：与 OpenCode、DeepSeek 无隶属关系。上游协议、模型和免费额度可能变化，不保证服务持续可用。
- 第三方数据处理：模型请求会发送给 OpenCode 服务；使用代理时，请求还会经过所配置的代理。不要发送不愿交给第三方处理的内容。
- 附件处理：图片按模型声明的能力输入，由 DSH 准备请求版本并执行图片预算／卸载规则；普通文件仍以文本句柄表示，不作为原生文件上传。图片字节和 data URL 不写入诊断日志。
- 凭据与日志：代理密码在本地配置文件中以明文保存；SOCKS 用户名/密码认证本身不加密，请使用可信代理与网络。不要公开配置文件，分享日志或截图前请检查并移除敏感信息。
常见问题
| 问题 | 建议 |
|---|---|
| 安装后没有看到模型 | 确认安装到了正在使用的 profile，插件已启用，然后重启 DSH 并检查网络连接。 |
| 思考模式在工具返回后报 reasoning_content 缺失 | 更新插件；0.5.3修复了assistant历史回传，空思考也会带上必要字段。 |
| 出现 HTTP 429 | 稍后重试；如已配置代理，可在设置中查看出口状态。 |
| 出现 HTTP 403 或 503 | 检查插件更新与上游服务状态，稍后重试；这类错误不会触发代理轮换。仍有问题时请反馈。 |
| 工具调用失败 | 在“诊断日志”标签查看错误，也可让 Agent 调用 opencode_bridge_audit 检查工具兼容性。 |
问题反馈或功能建议请选择 Issue 表单，按表单填写版本、复现步骤及预期/实际行为；日志请先脱敏，勿提交 API Key、代理密码或私人聊天内容。
开发与技术文档
从源码开发与安装
需要 Node.js ≥ 20.18.1 和 pnpm，建议使用 Node.js 22 或 24 LTS。
git clone https://github.com/Vikrant-Aleph/dsh-opencode-bridge.git
cd dsh-opencode-bridge
pnpm install
pnpm build
pnpm test
构建产物不会提交到 Git。要在 DSH 中安装本地构建：
pnpm pack
dsh plugin --profile desktop add ./dsh-opencode-bridge-0.5.5.tgz
实现原理、完整配置、测试方法与维护规约见技术文档（English）。
致谢与许可
协议研究参考 OpenCode 官方源码，以及 sub2api、9router、hermes-oc-free-provider、cpa-plugin-opencodezen 等开源项目；来源与对照记录见技术文档。
本项目采用 MIT 许可证。
