Skip to content

与 billion-context native 模式共存:为 BILLION_CONTEXT_NATIVE 增加动作时退让检查 #405

Closed

Description

@ranxianglei

来源: ranxianglei/billion-context#820 分析 opencode 2.x native 插件化时发现。

背景

billion-context 新增 OpenCode 2.x host-native 模式(opencode-native,PR ranxianglei/billion-context#824):包内插件自拉起代理,并通过 http.request hook 把模型 API 请求整对象替换为指向 <proxy>/bili/<url> 的新 Request(Request.url readonly,#810)。若本扩展与该 native 插件同时加载 → 双压缩(违反单一压缩 owner 原则)。

核对结论:现有自禁用在 native 模式下不生效

逐一核对了本仓库代码:

  1. index.ts:38 的 BILLION_CONTEXT_PROXY 检查只在插件 setup 时读一次。native 模式下该变量由 bootstrap 异步写入(代理起来之后),setup 早于它完成 —— 漏检;
  2. config hook / lib/bili-proxy.ts 依赖 provider baseURL 里的 /bili/ 前缀。native 模式的替换发生在 http.request 时刻,配置的 baseURL 永远是原始上游地址 —— 信号不可见;
  3. 因此:launcher 模式(env 随子进程继承)和手动接线模式(baseURL 带 /bili/)下自禁用正常;native 模式下没有任何现有信号可检测。

修复建议(小改动)

billion-context 侧(PR #824)已提供同步标记:opencode-native 入口在模块求值时(任何 await 之前)设 process.env.BILLION_CONTEXT_NATIVE = "opencode"(gated、first-writer-wins,实现见 billion-context/src/agent/native-bootstrap.ts 的 markNativeHost())。本侧只需:

  1. 在工具执行 / hook 触发的动作时刻(lazy)补测 process.env.BILLION_CONTEXT_NATIVE;顺手把 BILLION_CONTEXT_PROXY 也改成动作时重读;
  2. 命中 → 走既有退让路径(deny ACP tools / no-op hooks + 一次性日志,仿 /bili/ 检测命中时的行为);
  3. 补测试(仿 tests/bili-proxy-integration.test.ts)。

影响面

不处理:同时装有 opencode-acp 与 native 插件(<configDir>/plugins/billion-context)的用户在 native 模式下双压缩。此为本仓库 installer 尚未对账第三方条目的安全网修复(bili plugin install opencode 目前不移除 opencode-acp 条目)。

Activity

  1. ranxianglei commented on Sep 16, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    [bot] 🏷 收到。先给审核结论(动手前逐项验证过):

    1. 问题属实。 核对结果与你的一致:

    • index.ts:38 的 BILLION_CONTEXT_PROXY 检查确实只在插件 setup 时读一次;
    • lib/bili-proxy.ts 只认 provider baseURL 里的 /bili/ 前缀;native 模式的替换发生在 http.request 时刻,配置的 baseURL 永远是原始上游地址 —— 信号不可见;
    • billion-context 侧已确认 PR #824(分支 2026-09-15_opencode-native-plugin)提供了同步标记:src/agent/native-bootstrap.ts 的 markNativeHost() 在模块求值时(任何 await 之前、first-writer-wins、受 nativeBootstrapGate 门控)设 process.env.BILLION_CONTEXT_NATIVE = "opencode",且其注释明确说这个标记就是给 opencode-acp 这类独立扩展退让用的 —— 但本仓库目前只在加载期采样,标记没被消费。

    2. 层次判断: 根因是 ACP 的自禁用信号全部在 setup/config 时刻静态采样,而 native 模式的 owner 标记出现时机取决于插件加载顺序(setup 可能早于它)。修复方向正确:改为动作时刻重采样(lazy),复用既有退让路径(deny tools + no-op hooks + 一次性日志),不动架构。

    3. 实现方案(进行中):

    • lib/bili-proxy.ts 新增纯函数 detectBiliEnvYield(env?)(返回 launcher / native / null,env 可注入便于测试);
    • index.ts 的 setup 早期检查扩展为同时覆盖两个 env 变量(fast path,命中直接 return {});
    • guard() 与 config hook 每次动作时重采样 env;命中 → deny 全部 ACP tools + no-op hooks + 一次性日志;
    • 工具 execute 时刻也补 lazy 退让(纵深防御:覆盖标记在最后一次 config run 之后才出现的竞态);
    • 新增 tests/bili-native-yield.test.ts(仿 bili-proxy-integration.test.ts,含 setup 前已设标记、运行中设标记、launcher 变量同样 lazy 化、re-enable、一次性日志断言)。

    PR 链接稍后回复。

  2. added a commit that references this issue on Sep 16, 2026
  3. ranxianglei commented on Sep 16, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    [bot] 🏷 完成。PR: #406

    审核结论(动手前逐项验证过,见上一条评论):你核对的三点全部成立。根因是 ACP 的自禁用信号全部在 setup/config 时刻静态采样,而 native 模式的 owner 标记出现时机取决于插件加载顺序(setup 可能早于它)。你给的修复方向(动作时重采样 + 复用既有退让路径)打到了核心,已按此实现。

    实现(分支 2026-09-16_billion-context-native-yield,2 个 commit + devlog REQ/DESIGN/WORKLOG):

    1. lib/bili-proxy.ts:新增纯函数 detectBiliEnvYield(env?)(返回 launcher | native | null;launcher 优先 —— native bootstrap 本身在 BILLION_CONTEXT_PROXY 存在时拒绝运行,两者正常不会共存),env 可注入便于测试;另加 biliYieldLogMessage(),保证 launcher 日志措辞与 master 逐字节一致;
    2. index.ts 三个采样点:setup fast path(命中直接 return {});guard() 每次 hook 调用重采样(命中 → no-op);config hook 每次运行重采样(命中 → deny 全部 5 个 ACP tools + 跳过 command/primary_tools 接线,与既有 /bili/ 分支共用抽出的 denyAcpTools(),该分支日志原文保留);
    3. lib/compress/types.ts:resolveToolContext()(全部 5 个工具 execute 的第一句)在动作时刻检测到标记即抛出明确的 "disabled" 错误 —— 纵深防御,覆盖"标记在最后一次 config run 之后才落地、工具调用先到达"的残余竞态窗口;
    4. 非 latching:marker 移除后 ACP 行为恢复;热路径 O(1)、无 I/O、无状态格式/API 变更。

    测试:新增 tests/bili-native-yield.test.ts(10 个测试,走真实 factory):检测器单测 + 优先级、setup fast path ×2 标记、运行中标记 → config deny / 所有 hook no-op / 全部 5 个工具 execute 抛错、launcher 变量同等 lazy 化、re-enable、一次性日志断言。变异验证:把 index.ts + types.ts 退回 master → 10 个测试中 7 个失败;应用修复 → 10/10 通过。全量套件 1273/1273,typecheck/build 干净。

    双 agent 独立评审已完成(源码 reviewer + 测试 reviewer),发现项已在 commit 32d94ac 修复:两处 tracked 文件的 prettier 违规;config hook 的 stale-flag 边界(env 分支在赋值 disabledByBiliProxy 前 return,两信号同时变化时标志会过期 —— 现改为先算标志再分支);launcher 日志措辞恢复为 master 原文;tool-gate 测试从 2 个工具扩到全部 5 个;hooks-no-op 补上 command.execute.before;re-enable 测试补 try/finally;兄弟测试文件 bili-proxy-integration.test.ts 也清理 BILLION_CONTEXT_NATIVE。接受一个 info 级项:一次性日志的去重变量不随进程内 marker 切换而重置(纯外观问题,检测本身每次调用都实时重采样)。

    已知取舍(fail-closed,已写入 PR 描述):若 marker 已设但 billion-context 自身的异步 bootstrap 随后失败,ACP 保持退让直到进程重启(移除插件重启即恢复)。选择 fail-closed 而非 fail-open,避免重新引入双压缩风险;且 marker 只在 gate 通过时才写入,该窗口很小。

    一句话总结:为 BILLION_CONTEXT_NATIVE / BILLION_CONTEXT_PROXY 增加了动作时(lazy)重采样退让检查,覆盖 native 模式标记晚于 ACP setup 出现的竞态,复用既有 deny/no-op 退让路径并补了 10 个经变异验证的测试;PR #406 已就绪通过双评审,按仓库规范等你人工合并。

  4. added a commit that references this issue on Sep 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

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions