dsh-opencode-bridge

dsh plugin --profile web add dsh-opencode-bridge

OpenCode Bridge






[English](README.md) | 中文

在 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 界面安装

1. 打开左侧 插件 页面，点击右上角 添加插件。

2. 在输入框中填写：

   dsh-opencode-bridge@0.5.5

3. 安装源建议选择 npm 官方源；如果使用镜像源，新版本可能需要等待同步。

4. 点击 安装，等待安装完成。

命令行安装

从 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 模型选择器重新读取，无需重启插件。刷新间隔的高级配置见[配置参考](TECHNICAL.zh.md#8-配置参考)。

可选上下文精简

打开 设置 → OpenCode Bridge → 上下文精简，可开启 精简已完成轮次的思考。默认关闭，完整回传；仅清空已确认成功完成轮次的思考，保留当前工具链、无法确认或中断的历史，必要的 reasoning_content 字段仍会发送。

选项通过 DSH 保存，对后续新请求生效，不删除本地会话、不打断正在执行的请求。节省效果取决于上游，DSH 本地估算仍可能按完整历史计算；若连贯性受影响可关闭。

可选代理配置

不配置代理时，插件默认使用本机直连。

1. 打开 设置 → OpenCode Bridge → 出口代理轮换（可选）。

2. 逐个添加已有的代理地址，例如 http://127.0.0.1:7890 或 socks5h://127.0.0.1:1080。可保留 direct（本机直连）作为一个出口。

3. 点击 测试全部 检查连通性；冷却中的出口会跳过，避免提前发出请求。新增、删除操作会自动保存并应用。

插件按列表顺序优先使用可用出口。明确的出口配额错误或连接失败会使该出口暂时冷却；有服务端等待提示时不立即切换出口，全部出口冷却时也不会提前请求。模型后端暂不可用或原因不明的 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、代理密码或私人聊天内容。

开发与技术文档

<details>

<summary>从源码开发与安装</summary>

需要 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

</details>

实现原理、完整配置、测试方法与维护规约见[技术文档](TECHNICAL.zh.md)（[English](TECHNICAL.md)）。

致谢与许可

协议研究参考 OpenCode 官方源码，以及 sub2api、9router、hermes-oc-free-provider、cpa-plugin-opencodezen 等开源项目；来源与对照记录见技术文档。

本项目采用 [MIT 许可证](LICENSE)。