Skip to content

[coexistence] cross-host dual-mode (launcher vs native) isolation audit — per-seam verification + opencode spurious-warning wart #840

Closed

Description

@ranxianglei

来源: #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 审计待办

建议修复(均 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

  1. ranxianglei commented on Sep 16, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    收到,开工。计划与中期结论:

    拓扑前提:双模式代码(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,随栈一起落。

    计划:

    1. 先补未勾项:pi 缝 hands-on 验证(装 native plugin + bili pi 起,验证单 proxy、拦截器未装、无双注册、无误导日志)。
    2. 实现 (a):把 opencode 的 route/setup 创建 gate 在 nativeActive 里。
    3. 两条缝各带 per-seam overlap 回归测试再上:确定性模块级缝测试(以 launcher env 求值真实入口模块 → 触发 http.request / 检查 fetch → 断言不改写、不打印误导日志、不自启、fetch 未被 patch),外加真实二进制 hands-on 证据写进 PR 描述(本地上游 hosted CI 够不到,与 ci-e2e.yml 同一约束,真机 e2e 不进 CI)。
    4. (b) 安装期跨模式冲突检测、(c) env 开关 config 映射:deferred,单独讨论后再动。

    两个中期判断:

    • (a) 推荐最小形态:setup: nativeActive ? createOpencodeV2Setup({route}) : createOpencodeV2Setup() —— 即真正的“照抄 pi”:pi 只 gate 了 touch-traffic 的 fetch 拦截,plugin 导出保持无条件;opencode 侧对应地只摘掉 route(空转路由 + 误导日志的来源),overlap 时退化成与 launcher 插件同形(header stamp 幂等、无害)。这个形态保留了“手动 export BILLION_CONTEXT_PROXY 裸跑 opencode”边缘场景的既有行为(工具经 env 探测继续可用)。另一种形态——overlap 时 setup 完全 inert(什么都不注册)——会顺带消掉结构性缺口 Use kernel renderTags:"text-only" + forbid tag echoing in prompt #3 的冗余注册,但会改变上述边缘行为,超出 (a) 声明的范围(消除误导日志),我不擅自做;要的话说一声,拆出去单做。
    • 缺口 Use kernel renderTags:"text-only" + forbid tag echoing in prompt #3 “pi 与 opencode 都发生”:opencode 侧机制成立(launcher 临时 config 合并用户 config 的 plugin 数组,两条目同时加载);pi 侧机制存疑——packages 已装时 launcher 跳过 -e,而 pi 从包只加载一个 pi-native.js,理论上 overlap 时只注册一次。hands-on 会实测分辨,结论回帖。

    omp/dsh 项维持 blocked,等 #820 落地后重跑本审计。hands-on 完成后先回一次进度。

  2. ranxianglei commented on Sep 16, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    [bot] 🏷 审计完成 + 修复 (a) 已上 PR。一句话:pi 缝 hands-on 确认完全静默(与代码推断一致);opencode 缝的误导日志已按"照抄 pi"修掉并带 per-seam 回归证明;过程中发现一个新的真实问题(静默丢压缩,非 UB),已单开 #843。

    Per-seam 审计结果(checklist 更新)

    [x] pi 缝(原仅读码推断)——hands-on 完成:

    • overlap(native 插件已装 + bili pi 起):单 proxy 实例、压缩生效(prefix-affinity 链推进、高 cache-hit)、全部日志零 bili-native: 行。
    • 与推断一致:fetch intercept 整块在 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 缝(你已实测;我补了路由级验证 + 回归测试):

    • 规范 overlap(干净 cwd)实测:请求到达上游时携带 proxy 转发的 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 两例)。
    • 回归证明:把源码修复 stash 掉只留测试 → 该文件失败(误导警告打出);恢复修复 → 全绿。

    [ ] 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 test 1654 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)。后果两条:

    1. 工作目录的项目文件重定义了同名 provider → 改写被项目值静默覆盖,流量直连、无压缩、无警告;
    2. provider 只写在项目文件里 → 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 并给出建议方案,待你拍板。

  3. ranxianglei commented on Sep 17, 2026

    @ranxianglei
    OwnerAuthor

    继续

  4. added a commit that references this issue on Sep 17, 2026
  5. added a commit that references this issue on Oct 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions