ディレクトリに戻る

dsh-opencode-bridge

キュレーションリスト掲載メンテナンス: 活発

vikrant-aleph/dsh-opencode-bridge

互換クライアントプロトコルを使い、DeepSeek HarnessからOpenCodeの無料モデルを利用できます。

GitHub で見る
$ dsh plugin add dsh-opencode-bridge

インストール方法

dsh には中央のインストールコマンドはありません。このプラグインのエントリ(README に記載)をプロファイルまたはパッチ設定に追加し、再起動します。

インストールの仕組み

20

スター

2

フォーク

JavaScript

言語

MIT

ライセンス

2026-10-18

作成日

2026-11-20

最終プッシュ

README

OpenCode Bridge 图标

OpenCode Bridge

npm version dshfind Total npm downloads GitHub stars Last commit License Node.js requirement

中文 | English

在 DeepSeek Harness(DSH)里使用OpenCode 的免费模型——无需 OpenCode 账号或 API Key。另含可选的上下文精简与出口轮换。

OpenCode Bridge 在 DSH 中的位置:DSH agent loop 经 LlmAdapter 调用本插件,插件复刻官方客户端协议后请求 opencode.ai 网关

主要功能

伪装成官方 OpenCode 客户端,让 DSH 能使用 OpenCode 的免费模型。

它复刻官方 OpenCode 客户端的请求头、网关要求的请求形态,以及 TLS 与 HTTP 指纹。它是一个 LlmAdapter,接入 DSH 既有循环:agent loop、权限与工具执行仍由 DSH 负责,每次工具调用由 DSH 自行解析。网关检查什么、不检查什么,见下文。

同时还支持:

  • 模型自动刷新 —— 读取 OpenCode 的模型目录(与官方客户端同源),每 5 分钟刷新;目录变化时自动增删模型,刷新失败则保留上一份可用列表。
  • 可选上下文精简 —— 只清除已确认成功完成轮次中的思考,默认关闭。
  • 可选出口轮换 —— 按顺序配置多个 HTTP(S) 或 SOCKS 代理,连接失败时自动尝试下一个可用出口。
  • Code Mode 工具调用 —— 免费模型走 Code Mode 时,可直接调用当前步骤允许的 subagent。其他 SDK 工具经 execute 进入 DSH 原生 PTC,行为更接近 DSH 的 PTC 模式。
  • 子代理会话 —— 每个子代理有独立的线上会话 ID,同一父代理的子会话共享父会话亲和标识。这个标识用于会话分组,不改变免费额度。

[!IMPORTANT] OpenCode 免费模型有出口 IP 限额。 同一个公网 IP 使用过多时,后续请求可能被拒绝。共用一个公网 IP 的用户也可能相互影响。

安装

在 DSH 桌面端安装

  1. 侧边栏打开 插件,点右上角 添加插件。

  2. 输入:

    dsh-opencode-bridge@1.2.1
    
  3. 安装源优先选官方 npm registry;镜像可能滞后。

  4. 点 安装 并等待完成。

命令行安装

dsh plugin --profile desktop add dsh-opencode-bridge@1.2.1

把 desktop 换成你的 profile。若终端里没有 dsh:

npx @deepseek-ai/dsh plugin --profile desktop add dsh-opencode-bridge@1.2.1

然后在模型选择器里选 OpenCode Bridge 下的模型。若没有出现,重启该 DSH profile。

日常使用无需 API Key,也无需手改配置文件。模型列表变化会通知选择器重新读取,无需重启插件。刷新间隔等完整配置见配置参考。

OpenCode 如何判定客户端

以下结论全部来自实测——单变量、同一运行时、对真实网关验证。

网关会检查什么

要求 实测结果
User-Agent 使用官方客户端标识;插件默认复刻已抓取的 opencode/latest/2.2.0/cli。
至少声明一个工具 tools 为空数组会被拒。
系统提示含 <env> 块 仅含该块的 177 字节提示即可通过;同样的提示去掉该块就会被拒。
工具名形状 未识别的名称含下划线、连字符、点号或大写会被拒;网关认识的名称可带分隔符。插件会自动转换名称。
工具声明内容 一次声明大量富工具(真实描述 + 复杂 schema)会被拒;同尺寸的中性工具块可通过。

这些检查由官方客户端的形态满足,因此能当作客户端检查。用户可以改写系统提示、裁剪工具清单,但客户端仍会追加 <env> 块、声明工具。工具声明内容这条,官方客户端靠 Code Mode 满足——线上只留少量工具,完整目录进系统提示词;插件对免费模型也改用 Code Mode 规避。

工具名这条容易被误读:网关对不合规的名称返回 FreeUsageLimitError,与配额耗尽的报错一样。插件在发送前转换名称,收到模型返回的调用后再还原,所以工具调用不受影响。

网关不检查什么

不检查的东西分两种,插件对它们的态度不一样。

一种是官方恒发、但网关目前并不比对的细节。 插件仍然把它们复刻出来当保险:万一将来网关开始逐项比对,这些流量依然和官方无法区分。传输层是 TLS/HTTP 指纹(见下章);请求体与系统提示层面另有一批伪装细节(见「请求体与系统提示的预防性伪装」一章)。它们在 2026-11-17 的实测里都不是过闸条件,去掉也能通过。

另一种是本来就交给用户自由决定的内容。 网关不看,插件也就不模仿:系统提示正文、工具清单内容、Code Mode 目录的具体工具。

口径与证据

「目前」= 2026-11-17(最后一次活体探针;本文更新于 2026-11-18)。以上为 2026-11-13 至2026-11-17 的观测,不是规范。完整证据链与被排除的假设见伪装原则。

TLS 与 HTTP 指纹伪装(目前不检测,仅预防)

状态:已对齐,但截至 2026-11-17 未被证明是必需的。

它目前只是用来应对将来可能加入的指纹检查,让这些流量在对应层面无法区分于官方客户端。

TLS 指纹伪装

Node 无法表达官方握手。OpenSSL 自行排列扩展顺序,也不提供后量子 key share,产生的 hello 与官方客户端不同(约 270 字节,官方是 1482)。插件因此把握手交给wreq-js——基于 BoringSSL 的 Rust 引擎,与官方客户端用同一套底层 TLS 库。

元素 值
加密套件 抓包中的 17 个,顺序一致,以 TLS_AES_128_GCM_SHA256、TLS_AES_256_GCM_SHA384、TLS_CHACHA20_POLY1305_SHA256 开头
支持的曲线组 X25519MLKEM768、X25519、P-256、P-384——默认配置还会额外提供一个 MLKEM768 组;官方客户端没有这个组,因此要去掉
签名算法 抓包中的 11 个,顺序一致。其中两个容易搞错:0x0807 是 ed25519,不是 rsa_pss_pss_sha256(后者是 0x0809);0x0603 是 ecdsa_secp521r1_sha512,BoringSSL 中写作 ECDSA+SHA512
扩展 抓包中的 12 个,顺序一致,并关闭 GREASE、ECH 与 ALPS
ALPN 仅 http/1.1——官方客户端从不提供 h2,所以 HTTP/2 设置不属于它的指纹
结果 ClientHello 为 1482 字节;归一化随机数、会话 ID 与 key_share 载荷后,与抓包逐字节相同

HTTP 指纹伪装

元素 细节
头名称与大小写 Authorization、Content-Type、User-Agent、Connection、Accept、Host、Accept-Encoding、Content-Length 按抓包大写;自定义的 b3、traceparent、x-opencode-* 保持小写
头顺序 按抓包顺序,包括把 Host、Accept-Encoding、Content-Length 放在第 14–16 位——它们被显式提供,否则传输层会把它们追加到末尾
Accept-Encoding gzip, deflate, br, zstd,即 Bun 的默认值;Node 的默认值缺少 br 与 zstd
Connection keep-alive,并使用跨轮次复用的持久连接池
刻意不发送 不发送 sec-ch-ua*、sec-fetch-*、priority、accept-language——浏览器模拟会默认加上这些,而官方客户端从不发送,因此显式抑制

最终伪装的请求头(动态值归一化后)与官方抓包一致,唯一例外是 x-opencode-project——它由工作目录推导。这是头形态比对,不是整请求逐字节一致:正文因提示不同而尺寸不同(抓包 23,073 字节、插件示例 951 字节)。

wreq-js 是可选依赖。缺少原生绑定时,插件回退到普通 fetch,失去 TLS 对齐但仍能工作。某些代理环境下普通 fetch 根本连不上,所以这层传输的价值不止于指纹。

GitHub で README 全文を読む →

DSH Plugins は DeepSeek Harness プラグインの独立したコミュニティ ディレクトリです。DeepSeek との提携・公認はありません。サードパーティ製プラグインはセキュリティ監査を受けていません。インストール前にソースコードをご確認ください。

DeepSeek Harnessの新着プラグインを毎週お届け。スパムはありません。