来源: #809 分析 opencode npm-plugin 部署(横向拉平到全宿主)时发现。归属建议挂在 #820 native 伞下跟踪。 ## Background 每个宿主最多有两条部署模式: - **Launcher**:`bili <client>`(入口 `<host>.ts`,gated on `BILLION_CONTEXT_PROXY`,launcher 拥有 proxy 生命周期)。 - **npm-plugin(无 launcher)**:`plugins:["<pkg>"]`(入口 `<host>-native.ts`,自 spawn proxy)。 今天**双模式实际存在的宿主只有两个**:pi(`pi.ts` + `pi-native.ts`)和 opencode(`opencode.ts` + `opencode-native.ts`)。omp / dsh 目前只有 launcher 模式;#820 会把 native 模式铺到它们身上。两者共用隔离原语 `nativeBootstrapGate`(互斥门)+ `markNativeHost`(first-writer-wins),在 `src/agent/native-bootstrap.ts`。 ## 现状结论:当前**无 UB**(设计已兜住) overlap(两条都装、又用 launcher 起)不会坏掉,因为: 1. launcher 在 spawn 子进程**之前**就写入 `BILLION_CONTEXT_PROXY`,子进程加载时必然可见 → **无竞态**。 2. 压缩唯一权威是 proxy 本身,插件只转发 → **无双压缩**。 3. `nativeBootstrapGate` 见 `BILLION_CONTEXT_PROXY`/`BILI_PROVIDER_REWRITES` 即不自启 → **无双 spawn**。 所以本 issue 是**硬化/整洁性**清单,不是修一个正在发生的 UB。owner 约束(#809):#820 方向没问题,别引入 UB —— 因此下面任何代码改动都必须**带 per-seam e2e** 再上,不能投机改。 ## 跨宿主结构性缺口(对每个宿主成立) 1. **无安装期跨模式冲突检测**:`src/plugin-install.ts` 各宿主 installer 都不提示“另一条部署也在用”(`.bili-conflict` 是文件写入冲突标记,与本项无关)。用户得自己知道当前走哪条路。 2. **开关在 env 不在 config**:`BILLION_CONTEXT_PLUGIN` / `BILI_NATIVE_<HOST>` 改 opencode.json / 各宿主 config 看不到,得知道变量名才能关。 3. **overlap 时冗余注册**:pi 的 `createBiliPlugin()`(`src/agent/pi.ts:252`,被 pi.ts / omp.ts / pi-native.ts 复用)与 opencode 的 `createOpencodeV2Setup()` 都是各自入口**无条件调用** → 两条都装时工具/hook 重复注册(OpenCode 工具表 last-wins),无害但不整洁。**pi 与 opencode 都发生**,非 opencode 独有。 ## Per-seam 差异(具体弱点) 真正危险的动作是改流量(改写 URL / spawn)。两宿主处理不同: - **pi**(全局 fetch patch):`installNativeFetchIntercept(state)` 整个包在 `if (nativeActive)` 里(`src/agent/pi-native.ts:59-72`)→ overlap 时**完全不装拦截器**,纯 no-op。干净。 - **opencode**(http.request hook):`createOpencodeV2Setup({route})` 在模块导出处**无条件**建(`src/agent/opencode-native.ts:171`),没像 pi 把 route 也 gate 住 → overlap 时不自启、不双改写(route 空转,`healthyOrigin` 拿不到 origin),但留一个空转路由:HTTPS provider(cert-MITM)场景会在首个 model 请求打一行误导性的 `proxy unavailable — model requests go direct`(其实 launcher 正在正常压缩)。HTTP provider(`/bili/` 包裹)不受影响(首段 `bili` 被 `isModelApiUrl` 挡掉)。 - **修复方向**:照抄 pi,把 opencode 的 route/setup 创建也塞进 `if (nativeActive)` 门里,overlap 时彻底静默。 ## 验证状态 / per-seam 审计待办 - [x] **opencode 缝**:已 hands-on 实测(overlap 空转、无双 spawn;HTTPS 误报确认)。 - [ ] **pi 缝**:仅读代码推断(fetch patch 有 gate)——需 hands-on 确认 overlap 是否真如推断那样完全静默。 - [ ] **omp / dsh**:今天单模式;#820 加进 native 入口后重跑本审计。 ## 建议修复(均 deferred,需 per-seam e2e 先行) (a) gate opencode 的 route/setup 创建(消除误导日志);(b) 安装期跨模式冲突检测/提示;(c) 把 env 开关映射到 config 或至少文档化。 Refs: found in #809;D/N4 已修(#835 / #836,commit 54f8fb2 on PR #824);本项归属 #820 native 伞。
Activity
ranxianglei commentedon Sep 16, 2026
收到,开工。计划与中期结论:
拓扑前提:双模式代码(
pi-native/opencode-native/native-bootstrap)目前只存在于两个叠放的 open PR 上:#706(pi native)← #824(opencode native,tip 54f8fb2,含 D/N4 修复)。master 上没有这些文件。本工作从 54f8fb2 分叉,PR base 到2026-09-15_opencode-native-plugin,随栈一起落。计划:
bili pi起,验证单 proxy、拦截器未装、无双注册、无误导日志)。nativeActive里。两个中期判断:
setup: nativeActive ? createOpencodeV2Setup({route}) : createOpencodeV2Setup()—— 即真正的“照抄 pi”:pi 只 gate 了 touch-traffic 的 fetch 拦截,plugin 导出保持无条件;opencode 侧对应地只摘掉 route(空转路由 + 误导日志的来源),overlap 时退化成与 launcher 插件同形(header stamp 幂等、无害)。这个形态保留了“手动 exportBILLION_CONTEXT_PROXY裸跑 opencode”边缘场景的既有行为(工具经 env 探测继续可用)。另一种形态——overlap 时 setup 完全 inert(什么都不注册)——会顺带消掉结构性缺口 Use kernel renderTags:"text-only" + forbid tag echoing in prompt #3 的冗余注册,但会改变上述边缘行为,超出 (a) 声明的范围(消除误导日志),我不擅自做;要的话说一声,拆出去单做。plugin数组,两条目同时加载);pi 侧机制存疑——packages 已装时 launcher 跳过-e,而 pi 从包只加载一个pi-native.js,理论上 overlap 时只注册一次。hands-on 会实测分辨,结论回帖。omp/dsh 项维持 blocked,等 #820 落地后重跑本审计。hands-on 完成后先回一次进度。
ranxianglei commentedon Sep 16, 2026
[bot] 🏷 审计完成 + 修复 (a) 已上 PR。一句话:pi 缝 hands-on 确认完全静默(与代码推断一致);opencode 缝的误导日志已按"照抄 pi"修掉并带 per-seam 回归证明;过程中发现一个新的真实问题(静默丢压缩,非 UB),已单开 #843。
Per-seam 审计结果(checklist 更新)
[x] pi 缝(原仅读码推断)——hands-on 完成:
bili pi起):单 proxy 实例、压缩生效(prefix-affinity 链推进、高 cache-hit)、全部日志零bili-native:行。if (nativeActive)里,overlap 时完全不装 → 完全静默,零空转件。tests/pi-native-overlap.test.ts:两种 launcher env 变体(BILLION_CONTEXT_PROXY/BILI_PROVIDER_REWRITES)下断言globalThis.fetch未被 patch(拦截 flag 不存在、fetch 引用不变)、无 native host marker、plugin 导出保持无条件。修复前后均绿(该缝本来就对)。[x] opencode 缝(你已实测;我补了路由级验证 + 回归测试):
x-bili-hop/x-bili-tunnel签名头 → 流量确实走 proxy,单 proxy、无双 spawn、修复后零误导日志。tests/opencode-native-overlap.test.ts:在 launcher env 下加载真实 native 入口,断言 request 引用不被替换、零proxy unavailable/bili-native警告、header stamping 正确降级为 launcher-mode 检测(env +/bili/wrapped URL 两例)。[ ] omp / dsh:仍单模式,等 #820 铺完 native 入口后重跑本审计。
修复 (a)— PR #842
#842 (base
2026-09-15_opencode-native-plugin,stacks on #824;#824 落地后 rebase 到 master)src/agent/opencode-native.ts的导出处改为nativeActive ? createOpencodeV2Setup({ route: createNativeRoute(state) }) : createOpencodeV2Setup()—— 照抄 pi 的门控思路:overlap 时 route 彻底不存在(不 probe、不 rewrite、不报警),setup 退化为与src/agent/opencode.ts(launcher-mode)完全同形。为什么没有更进一步(即顺带修掉结构性缺口 3"冗余注册"):把整个导出 inert 化会改变手动设
BILLION_CONTEXT_PROXY的边缘用户行为(他们目前经 env 检测仍保留 native 工具),超出你在 issue 里给 (a) 划的范围("消除误导日志")。缺口 3 维持 deferred,留 owner 拍板。Pre-flight:typecheck 干净 /
npm test1654 pass 0 fail 2 skipped(e2e gated)/ build 成功。分析中发现的新问题 → 已开 #843
#843 — 项目级
opencode.json会覆盖 launcher 的改写 → 静默丢失压缩(非 UB/双压缩)。做 opencode 路由验证时我发现一个反直觉现象并追到底:opencode 的配置解析顺序是 project > $OPENCODE_CONFIG > global XDG,而 launcher 正是经
$OPENCODE_CONFIG=tempfile交付改写的(src/launcher.ts:2406)。后果两条:readOpencodeConfigRoot(src/client-config.ts:936)根本不读项目层,discovery 看不到,连改写都不会发生。已端到端证实(黑盒 acceptor 捕获到 opencode 直连上游;对照实验干净 cwd 下流量正常走 proxy)。影响:该类配置的用户静默失去压缩,无其他危害。issue 里给了三个方案,我的建议是 (b) 检测+警告先行(hermes 已有同类先例,launcher.ts:2420),低成本且诚实;(a) discovery 补项目层单独做修不了场景 1(project 运行时仍压过 env)。pi/omp 不受此问题影响(manifest 在扩展加载期生效,晚于配置解析);hermes 未验证。
(b)/(c) 状态
按你的约束维持 deferred。(b) 的讨论材料已并入 #843(它其实就是跨模式冲突提示的一个更具体的实例——安装期/启动期都提示不了这件事,只有 launcher 运行时的项目层检测能抓住)。
—
中文摘要:审计收尾——pi 缝实测确认完全静默,opencode 缝的 overlap 误导日志已按 pi 模式门控修复(PR #842,带 per-seam 测试与修复前必失败的回归证明);过程中发现项目级 opencode.json 会静默绕过压缩的真实缺口,已单开 #843 并给出建议方案,待你拍板。
ranxianglei commentedon Sep 17, 2026
继续
Merge pull request #842 from ranxianglei/2026-09-16_840-coexistence-a…
Merge pull request ranxianglei#842 from ranxianglei/2026-09-16_840-co…