Skip to content

[pi] native 模式第三方 pi-subagents 深度测试与修复:extension registry 自注册(方案 A)落地 #2185

Closed

Description

@ranxianglei

背景与问题

#2047 收尾时已核清 pi 官方包 pi-subagents(pi.dev 列出,nicobailon,0.75.x,pi 0.83.6)在 native 安装(bili plugin install pi / pi install npm:billion-context)下的两格缺陷:

  1. 前台子代理 = 匿名档:前台 child 的 loader 硬编码 noExtensions:true(child-session.js,host:"parent" → ambient 发现关闭)→ 子会话不加载 bili 扩展,流量只是骑父进程的全局 fetch patch → 代理侧记为 proxy 模式 + 内容派生 pfa-* 身份。压缩独立成立,但:无以 child pi sessionId 建立的具名 x-bili-plugin-conversation 会话、无 parentSession 血统、子代理工具面里没有 ACP 工具(frontmatter tools 白名单无对象可控)。
  2. 后台 async run = ambient 运气:runner 步骤 child 是 host:"runner",ambient 发现默认开(child-tool-plan.js:272),默认配置下 bili 会被加载生效;但三个失效条件任一命中即静默回归直连:① agent 定义显式设 extensions(含空数组)或 denyExtensions:true;② pi-subagents 版本漂移;③ runner 里 npm: 条目 store 同步问题。

修复方案(已论证,待落地)

#2047 末评的 方案 A:bili 向 pi extension registry 自注册;required extensions 走 additionalExtensionPaths → resource-loader 的 cliEnabledExtensions 桶(resource-loader.js:315/408:noExtensions ? cliEnabledExtensions : mergePaths(...))→ noExtensions:true 时也确定性加载,覆盖前台+后台全部绕过场景;async-execution.js:894 证实注册表快照正是后台步骤 requiredExtensions 的来源之一。

需披露的副作用①:前台 child 从 pfa-* 匿名升级为 child-sid 具名 plugin 模式。requireForAllRunners 默认关(#2047 建议)。

本 issue 任务(ework 深度测试 + 实施)

  1. 按 [pi] pi-subagents 后台 async runner 以 --no-extensions 启动,模型流量绕过 billion-context 压缩 #2047 矩阵做真机深测:native × launcher / 前台 × 后台 / 默认配置 × agent-def 显式禁扩展 / HTTP × WS 传输,逐格记录压缩是否具名生效、身份形态、失效模式;
  2. 实施方案 A(自注册 + 确定性加载),回归覆盖上述全部格子;
  3. 补 [Pi] 原生入口 fetch-only 拦截漏掉 WebSocket 模型流量:Codex provider auto 模式直连上游,工具已注册但会话状态未建立 #2073 遗留的 ④:CLIENTS.md en/zh 子代理章节(含本修复后的矩阵与旧版行为差异)。

关联:#2063(总纲)、#2047(矩阵核实+方案论证)、#2073/#2080(文档)、#2075(nativeCaller)、#2158(子代理 search_context 零命中,深测时顺带复核)。

Activity

  1. ranxianglei commented on Oct 5, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    [bot] 🏷 开始处理 #2185。计划:① 按 #2047 矩阵做真机深测(native×launcher / 前台×后台 / 默认配置×显式禁扩展 / HTTP×WS),逐格记录身份形态与失效模式;② 实施方案 A(pi extension registry 自注册 + 确定性加载,零新配置面);③ 补 CLIENTS.md en/zh 子代理章节(#2073 遗留④)。#2158 的 search_context 问题顺带在深测中复核(内核修复 PR #2162 已出,等合并)。先做环境核查与代码定位,进展随时同步。

  2. ranxianglei commented on Oct 5, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    [bot] 🏷 深测基线完成(修复前),真机矩阵已逐格跑通。测试装置:隔离 PI home(不动用户状态)+ 脚本化 OpenAI 兼容上游(多轮 filler → nudge → compress 往返)+ pi 0.83.6 + pi-subagents 0.76.0(注册表契约已对真实 tarball 重新核实:Symbol.for 形状、同会话重复注册抛错、required paths 存活 extensions: [];新发现:0.76.0 里 capability ceiling denyExtensions × required extensions 组合从静默绕过变为启动前硬性拒绝,child-tool-plan.js:174-176,深测后按实测记录)。

    三格基线结果(native 安装):

    格子 子代理身份 模式 ACP 工具面 压缩
    前台 × 默认配置 pfa-* 匿名(prefix-affinity) proxy(fetch patch 骑父进程) 本地无;仅 proxy 在 wire 注入 pfa-* 下成立(1 block)
    后台 × 默认配置 child-sid 具名(ambient 运气命中,bili 经 settings packages 加载) plugin 被 agent 定义 tools: 白名单滤掉(scout 等内置 agent 全带白名单) 未走到(工具不存在)
    后台 × agent-def extensions: 显式空 完全直连:无 header、proxy 零参与 无(静默绕过) 无 无

    与 #2047 预判一致的两格之外,两个新增实证:

    1. 前台匿名档确认:launchResolvedExtensions 显示 disableAmbientExtensions:true、required=[],流量记为 pfa-871ee…;compression 在 pfa-* 会话下独立成立。
    2. 后台具名档的隐藏缺陷:[pi] pi-subagents 后台 async runner 以 --no-extensions 启动,模型流量绕过 billion-context 压缩 #2047 说 ambient 命中后"bili 会被加载生效",实测确实加载且具名(plugin header 齐全),但内置 agent 定义的 tools: frontmatter 是白名单语义,把扩展注册的 compress/decompress/… 全部滤出工具面。对照实验:去掉 tools: 字段的等价 agent,ACP 工具从第 2 轮起正常出现。即:即便 ambient 运气好,只要 agent 带白名单(内置 agent 全带),子代理仍调不了 ACP 工具——这使方案 A 的价值比原预判更大(确定性加载解决"加载"问题,但工具面白名单是独立的第二道门,需要在本 issue 结论与 CLIENTS.md 里如实写明)。

    另:本机的 pi 是定制构建(pi-stable),pi-subagents 后台 runner 不认,需显式提供 @earendil-works/pi-coding-agent npm host 包才能起后台跑——这本身就是 #2047 失效条件③(npm: 条目/runner 环境漂移)的一个实例,已记录进矩阵备注。

    下一步:实施方案 A(session_start 自注册 globalThis 注册表 + kill-switch 门禁 + 冲突让位),然后重跑全矩阵对比。

  3. ranxianglei commented on Oct 5, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    [bot] 🏷

    **收工。PR:https://github.com/ranxianglei/billion-context/pull/2209**(分支 wt-2185-ework-daemon,rebase 到最新 master e5a0066,Closes #2185)。三项任务全部落地:真机深测(修复前基线 + 修复后回归)、方案 A 实施、CLIENTS.md en/zh 子代理章节。

    结构化七问

    1. 是什么问题:native 安装下 pi-subagents 的子会话不能可靠加载 bili 扩展——前台 child 被记成匿名 pfa-* proxy 会话(压缩成立但无具名身份/血统/本地 ACP 工具),后台 async run 靠 ambient 发现运气加载,agent 定义显式禁扩展时静默回归直连(代理零可见性)。

    2. 什么原因导致的:pi-subagents 前台 child 的 loader 硬编码 noExtensions:true(ambient 发现关闭),后台 child 默认开但可被 agent-def / 版本漂移打掉;bili 对 child loader 没有任何「必须加载」的通道,只能被动等 ambient。根因在加载通道缺失,不在流量路由(父进程 fetch patch 恰好让前台「看起来能用」,掩盖了身份缺陷)。

    3. 怎么修复的:方案 A——pi 扩展在 session_start 向 pi-subagents 全局 required-child-extension registry 自注册(feature-detect globalThis[Symbol.for("pi-subagents.required-child-extensions.v1")],形状与 0.76.0 逐字对齐,不 import 该包)。必需扩展经 additionalExtensionPaths → pi 的 cliEnabledExtensions 桶,noExtensions:true 时也确定性加载。按父会话粒度注册、session_shutdown 释放、同会话冲突先写者胜、registry 缺失/异形时降级回旧行为并记一次日志;requireForAllRunners 刻意不设(外部/machine 放置保持现状);kill switch(BILLION_CONTEXT_PLUGIN=0/BILI_NATIVE_PI=0)抑制注册。无新配置面。

    4. 是否有回归问题:逐项审过既有行为——① 仅 agent==="pi" 分支注册,omp/dsh/codex 路径零触碰;② launcher 模式刻意不受 BILI_PROVIDER_REWRITES 门控(child 同样受益,已实测);③ 无 fail-fast 变吞错——反而在 0.76.0 下把「runtime 能力上限硬性 denyExtensions」从静默绕过变成 child 启动大声失败(fail-fast,已披露);④ 两个既有现象原样保留、非本 PR 引入:后台 child 首请求注册竞争(ACP 工具 t2 起出现)、agent-def tools: 白名单过滤扩展工具(见下条披露披露③);⑤ wire 形状、持久化格式、消息 id/ref 逻辑零改动。

    5. 是否破坏缓存:不涉及——纯进程内注册表 + 复用既有扩展加载路径,不触碰 prefix cache、去重键、增量游标、重试策略。

    6. 是否改了设计方向:否——仍是单写者 install-lane 契约;只是给 child loader 增加一条「必需扩展」确定性通道,即 #2047 论证的方向,未转向。

    7. 是否引入新的配置:无(无新 env/config/CLI flag)。

    行为变更披露(旧 → 新)

    1. 前台 child:匿名 proxy 模式(pfa-*)→ 具名 plugin 模式(child 会话 id + parentSession 血统)——[pi] pi-subagents 后台 async runner 以 --no-extensions 启动,模型流量绕过 billion-context 压缩 #2047 预告的副作用①;以 pfa-* 为键的工具会看到不同 id。
    2. 后台 child × 限制性 agent 定义:静默直连 → 确定性 bili 加载(named session,launchResolvedExtensions.required=["bili"])。
    3. 注意(既有机制,升级后被放大):frontmatter tools: 白名单不含 ACP 工具名的 agent(如内建 scout)修复前前台靠 wire 注入还能拿到工具,升级后本地 ACP 工具被白名单滤掉——省略 tools: 字段或补 compress,decompress,search_context,acp_status,acp_cache 即可恢复。已在 CLIENTS.md en/zh 写明。

    实机矩阵(pi 0.83.6 + pi-subagents 0.76.0,隔离 XDG/PI_CODING_AGENT_DIR,脚本化 OpenAI 上游)

    格子 修复前 修复后
    native×前台×默认 pfa-* 匿名 proxy 模式,wire 注入工具 具名 child-sid plugin 模式,t1 起本地 ACP 工具,Compressed m00001–m00011 → 1 block(s) 具名生效
    native×后台×默认 ambient 运气 确定性(required:["bili"]),具名,压缩生效
    native×后台×extensions: [] 静默直连(零可见性) 确定性加载,具名 plugin 会话
    launcher×后台 rewrite 继承但加载靠运气 注册生效(不受 REWRITES 门控),父子均具名经 /bili/ 路由
    纯 WS 传输 不在范围 不变——客户端侧 WS 拦截仍 owner-gated(#2073),文档记录

    测试:新增 tests/pi-subagent-registry.test.ts 10 项(真实 globalThis registry 契约:建形/冻结快照/幂等重放/冲突先胜/kill switch/launcher 不门控/omp 不注册/坏 sid/path/异形降级/dispose 身份校验/工厂接线);既有 plugin-agent + pi-native 套件 77/77;typecheck 干净(rebased head);全量回归交 CI。

    #2158 顺带复核

    子代理 search_context 零命中:根因确认在内核词法搜索门槛标定(score > 0.1 过滤线高于 summary 单次命中的 0.04 最小正信号),与子代理/fork 无关;修复 PR #2162 仍 open,等人工合并(kernel 层按 Kernel Boundary 不可 auto-merge)。本 PR 不依赖它。

    判定:CI 绿后即可合并(非 auto-merge 类——涉及 wire 身份形态变更与新增模块,走人工审查)。

  4. ranxianglei commented on Oct 6, 2026

    @ranxianglei
    OwnerAuthor

    第三方 pi-subagents 两泳道端到端验证(#2209 真机复核)

    在 owner 要求下对 pi-subagents 0.76.1(第三方,nicobailon)做了独立真机验证:子代理可用性 + 子代理自身会话压缩。构建 = master bd33b11(#2209 + #2221 之后)。两条泳道(前台/后台)全部通过。

    泳道 1:前台 child ✅

    • 装置:隔离 pi home、packages=["<bili>/dist/agent/pi-native.js","npm:pi-subagents"]、干净 env、真模型(qwen3.8-27b via 127.0.0.1:8199)
    • 父代理经 subagent 工具起前台 child(acpprobe 探针 agent,自定义于 ~/.pi/agent/agents/),任务=读 8KB 文档 + 6 次 bash 往返 + 调 compress m00001–m00004
    • 结果:子会话 01a10fa5-cf69-7b16-… 具名(独立 uuid、独立记账、5 requests / 27 msgs),子代理自己调用 compress 成功:
      [Compressed m00001–m00004 → 1 block(s), ~2013 tokens saved.
       Excluded 2 protected message(s) m00001, m00002 …]
      
      block b1(8KB 文档全文)落子会话自己的记录,父会话零变化;全程零个 pfa-* 匿名会话(feat(pi): deterministic bili loading for pi-subagents children — required-extension self-registration (Plan A) #2209 头条修复逐轮生效)
    • 中间还顺带验证了策略层全部对子会话正确生效:5000 字符下限、ref 校验(session highest ref)、保护区(最近 5 条)、摘要 ≥50 字符 —— 子代理被拒后按工具自带的修复指引三轮自主自愈(换 ref→扩区间→加长摘要)到成功,错误文案的可操作性实测有效

    泳道 2:后台 async child ✅(Docker + 官方 pi 宿主)

    本机 pi 是定制构建,后台 runner 报 "Background children require a supported standalone Pi host or the installed npm package (@earendil-works/pi-coding-agent)" —— 改用 Docker 容器验证:

    • 容器:ework-aio:e2e 镜像 + 挂宿主 node 25.9 + npm install @earendil-works/pi-coding-agent@1.0.4(官方独立宿主;注意它要求 node ≥22.19,node 20 会死在 enableCompileCache)+ 只读挂载 master 构建
    • 父 pi 起后台 child 后即退出(PARENT_DONE rc=0);分离 runner 进程里的子代理继续跑完
    • 结果:子会话 01a10fb6-879c-744b-… 具名(独立 uuid)、5 requests / 20 msgs、bash×6 + compress,compress 成功折叠 ~2013 tokens、block b1 落子会话;父会话 01a10fb6-16b4 独立记录
    • 附加:官方宿主里父会话的 ACP 上下文管理器同样在工作(父退出前打了 "No compressible ranges remain")

    结论矩阵

    泳道 子代理可用 子代理具名会话 子代理 ACP 工具 子会话压缩实证
    前台 child ✅ ✅ uuid 具名,零 pfa-* ✅ acp_status/compress ✅ block b1,~2013 tok
    后台 async child ✅(分离 runner) ✅ uuid 具名 ✅ ✅ block b1,~2013 tok

    如实披露

    • 本机(pi-stable 定制构建)无法本地起后台 child —— 后台格的证据来自 Docker + 官方宿主,与 ework 深测环境等价
    • 第三方内置 agent 的 tools: 白名单(如 researcher 含 web_search,系它自家 ambient 扩展工具,前台 child 永不加载它自家扩展)会被 pi-subagents 自己 pre-flight 拒绝 —— 这是它包内的自洽机制,与 bili 无关;自定义 agent 不写 tools: 即不受限
    • 测试方法论两条:① native 安装入口是 dist/agent/pi-native.js(装成 pi.js 会静默变 launcher 无压缩);② 测 native lane 必须 env -i 干净环境(宿主 shell 的 BILLION_CONTEXT_PROXY/BILI_PROVIDER_REWRITES 会让扩展按 launcher 姿态 stand-down)
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

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions