Skip to content

[PR] feat(pi): fold /acp block details with Ctrl+O - #4065

Merged
ranxianglei merged 5 commits into
ranxianglei:masterfrom
yanhuojiyusheng:2026-10-20_pi-acp-collapsed-display
Oct 24, 2026
Merged

ranxianglei merged 5 commits into
ranxianglei:masterfrom
yanhuojiyusheng:2026-10-20_pi-acp-collapsed-display

Conversation

@yanhuojiyusheng

Copy link
Copy Markdown
Contributor

Closes #4064.

长会话中,pi /acp 全量显示逐块明细,数百个块会占用大量终端空间。现在通过 pi 的自定义消息 renderer 默认折叠块明细,复用现有 Ctrl+O 展开/收起状态。

保留原标题边框、storage、空行、背景、Markdown 格式和页脚;展开时交回 pi 默认 renderer,显示完整原始报告。持久化消息内容保持完整,无明细或不支持 renderer 的宿主继续使用原有显示。改动仅涉及 pi 插件和对应测试,无配置、kernel 或 wire 变更。

验证:

  • npm run typecheck、npm run build 通过(现有 CONFIG_DIR_NAME stub 警告另由 [PR] fix: export pi config directory from host stub #3937 跟踪)。
  • node --import tsx --test tests/plugin-agent.test.ts:75/75 通过。
  • 250 块回归覆盖折叠、完整内容保留、标题/空行/主题背景以及无明细回退。
  • 构建产物通过真实 pi CustomMessageComponent 验证收起→展开→收起;除隐藏的明细和新增提示外,输出与默认 renderer 逐行一致。用户已在本地 pi 验证并认可效果。

效果图见下方独立评论。

@yanhuojiyusheng

Copy link
Copy Markdown
Contributor Author

(ai: custom/gpt-6.1-sol)

本地 pi 实际效果(用户提供并确认的截图):保留原标题、空行、主题背景与状态内容,默认仅隐藏逐块明细;Ctrl+O 可展开完整报告。

pi /acp 折叠块明细,保留原布局

@ranxianglei ranxianglei changed the title feat(pi): fold /acp block details with Ctrl+O [PR] feat(pi): fold /acp block details with Ctrl+O Oct 21, 2026
@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

查重:不重复。本 PR 关闭其自身来源 issue #4064(同作者);全仓 open+closed 检索无其他 issue/PR 涉及 pi /acp 块明细折叠。

标签:建议 pi、scope/ui、p3(功能增强、非缺陷,不打 bug)。已尝试经平台镜像 API 打标,但对 PR 对象写标不落库(issue 端点返回 200 却未生效、pulls 端点 404),故以文本留档,请 owner 侧确认。

结论先行:代码正确、门控双向测试齐全、diff 最小、无回归/缓存/配置/wire/kernel 影响;本地 tests/plugin-agent.test.ts 75/75 绿、build exit 0。唯一需 owner 拍板的设计点:本 PR 首次把 @earendil-works/pi-tui 作为运行时值依赖打进 dist/agent/pi.js(见第 7 问)。CI 红是 master 既有 flaky,非本 PR 引入(见末节)。

结构化八问

  1. 是什么问题:长会话里 pi /acp 把数百个压缩块的逐块明细全量铺在消息区,挤掉当前工作;pi 本身已有 Ctrl+O 展开/收起,但 bili 的 bili-acp-status 自定义消息没注册对应 renderer,所以没法折叠。

  2. 什么原因导致的:pi 侧缺一个针对该 customType 的 MessageRenderer——默认 renderer 无条件渲染整段报告文本;折叠只能在收起态由自定义 renderer 只输出「非块明细行」实现。

  3. 影响范围与严重程度:仅 pi 车道 /acp 的终端展示(UI 层);不动压缩行为、模型输入、持久化内容或其他客户端。严重度低(体验优化 / p3)。触发条件:有活跃压缩块的 pi 会话执行 /acp。

  4. 怎么修复的:createBiliPlugin 里当 agent==="pi" && typeof registerMessageRenderer==="function" 时注册 bili-acp-status renderer:展开态返回 undefined(交回 pi 默认 renderer 显示完整报告);收起态过滤掉 /^ \[b\d+\] T\d+ / 的逐块明细行、保留标题边框/storage/空行/背景/Markdown/页脚,包进带 customMessageBg 背景的 Box + 底部 Ctrl+O 提示;无块明细或宿主不支持 renderer 时也返回 undefined 走默认显示。

  5. 是否有回归问题:审过既有行为——(a) 宿主无 registerMessageRenderer → typeof 守卫跳过注册,行为不变;(b) 非 bili-acp-status 消息不经过该 renderer;(c) 持久化 message.content 原样保留(测试断言);(d) 无 wire/config/kernel/其他模块改动。高危模式逐项过:无语义漂移、无 fail-fast 变吞错、无阈值/时序/输出格式变化(仅新增一条 UI 提示行)。未发现回归。

  6. 是否破坏缓存:不涉及。纯终端渲染层,不触碰 prefix cache / 会话存储 / 增量游标 / 去重键。

  7. 是否改了设计方向:是(需 owner 决策)。本 PR 引入首个 @earendil-works/pi-tui 运行时值导入进 dist/agent/pi.js。此前 pi-tui 仅有 type-only 引用(src/agent/pi-subagents.ts:12 的 import type { KeyId },构建期擦除),而 pi-coding-agent 被 tsup 显式 alias 到空 stub 以保持 bundle 零运行时依赖(AGENTS.md §2.1 允许清单里没有 pi-tui)。因 pi-tui 是 devDependency,tsup 会把它内联:实测 build 后 dist/agent/pi.js=1.44MB、对外零 pi-tui import(自包含,发布安装不会 ERR_MODULE_NOT_FOUND)。代价:① 越过「零运行时依赖」设计意图;② bili 内部钉死一份 pi-tui@0.83.0,pi 上游升级后静默漂移(渲染分歧、不报错)直到有人 bump+发版;③ 为一个外观特性增加 bundle 体积。两个选项:(a) 接受并文档化——把 pi-tui 记为「有意内联依赖」(类比 pi-subagents 内联 typebox),保留自定义背景框;(b) 更轻路径——收起态只返回折叠后的纯文本/Markdown、让 pi 默认 custom-message renderer 负责样式,牺牲自定义背景框,从而不嵌入 pi 的 TUI 库。推荐 (a)(特性已验证、自包含、可用),但须按 Deliverables 规则 4 披露并补一句注释/文档说明 pi-tui 被有意内联且钉版本;若 owner 更在意 bundle 权重则转 (b)。此项属 feat/架构面,我不擅自改,等拍板。

  8. 是否引入了新的配置:不涉及。无新 config/env/CLI flag/默认值。

CI 状态:PR head 上 ubuntu/node22 的 test shard 2、3 红、1 绿(node24/windows 仍在跑)。关键对照:当前 master head(046db20)同样的 ubuntu/node22 shard 也红(那次红的是 shard 1、2,每次跑红的 shard 不同 = flaky/环境性,符合 AGENTS.md §7.2 端口冲突/网络探测抖动)。check-run 日志端点对本 token 返回 404,读不到确切失败用例名。综合判断:本 PR 是纯增量+守卫式改动、自身文件本地 100% 绿 + build 干净,CI 红判定为 master 既有 flaky,非本 PR 引入;不应据此单独卡本 PR,建议 re-run shards 或待 master flake 消退后再看全绿。

次要 nit(非阻塞,可选):① renderer 假定 content 为 string 或 text-part 数组(对 bili-acp-status 恒为 string 足够;acp-panel.ts 的 messageText() 更防御,可复用但价值低);② 标签用裸 ANSI \x1b[1m…\x1b[22m 而非 theme.bold(),与代码其余处风格略不一致。

收工判定:代码质量达标(外部提交从严清单全项通过),可合并的前提是 owner 就第 7 问的 pi-tui 依赖取舍拍板(推荐 a+文档披露);CI 红系 master 既有 flaky,与本 PR 无关。

@yanhuojiyusheng

Copy link
Copy Markdown
Contributor Author

关于本轮 CI 的 5 个 red,说明一下排查结论:与本 PR 的改动无关,代码上不需要处理。

5 个失败全部来自同两条存储层测试(分片不同,命中的条不同):

失败 job 失败用例
test (ubuntu-latest, 22, 2) issue3769-pooled-bare-load:bare-id loadSync hydrates the pooled envelope without the index
test (ubuntu-latest, 22, 3) issue3769-upgrade-compat:record hydrates before the upgrade turn
test (ubuntu-latest, 24, 1) 上述两条
test (windows-latest, 22, 1) issue3769-pooled-bare-load
test (windows-latest, 22, 2) issue3769-upgrade-compat

日志里另有 generic append-only stability ... # SKIP no SMT solver available,属跳过项,不计入 fail(各 job 的 # fail 为 1 或 2)。

判断依据:

  1. 本 PR 只改 src/agent/pi.ts 与 tests/plugin-agent.test.ts,与 storage / 会话水合路径无交集;新增的 /acp 用例在本轮 CI 中通过(ok 1622 - /acp renderer collapses large reports and restores every block when expanded)。
  2. 两条失败都发生在新建 SessionStore 后立即 loadSync() 读回记录的断言上,失败信息分别是 bare-id loadSync hydrates the pooled envelope without the index 与 record hydrates before the upgrade turn,属 [Bug] MCP failed compression record rotation prematurely rewrites the history prefix, triggering expensive cache recompu | [Bug] MCP 失败压缩记录轮换提前改写历史前缀,触发大额缓存重算 #3769 的水合时序问题。
  3. 失败发生在合并后的 head 上,且该 head 已包含今天早些时候的 765abe36 fix: seed the pooled-envelope walk for any unified mode, not just async backends (#3769 flake),说明该偶发在 master 上仍存在,与分支内容无关。
  4. 同一测试在不同分片/平台上红绿不一致(如 ubuntu 22 分片 2 红、分片 1 同轮全绿),符合时序偶发而非确定性回归。

本地复跑(Windows):issue3769-upgrade-compat 通过;issue3769-pooled-bare-load 仅在临时目录清理阶段报 EPERM,不是断言失败。

建议: 重跑失败的 5 个 job 即可;若需要,我也可以把分支 rebase 到最新 master 以触发新一轮 CI。当前账号在上游仅有 pull 权限,无法自行重跑,需维护者点击。水合竞态的根因跟踪属独立范围,不在本 PR 内处理。

@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

结论先行:你的排查方向正确——5 个红与本 PR 无关,代码上确实不需要处理。但有一个你评论时还看不到的关键更新:这批偶发的根因修复(#4077)已于今天 01:39Z 合入 master,而本轮红 CI 是 01:03Z 启动的,跑在修复之前的合并提交上。所以建议从「重跑」升级为**「把你的分支 rebase 到最新 master」**——重跑旧 job 复用的还是同一个未含修复的合并提交,偶发仍然活着,大概率白跑一轮。

独立核验(未直接采信结论,逐项重查过):

  1. diff 范围:已拉取你的分支 head 00dc37c3,相对 merge-base bc4a3f87e 仅动 2 个文件、纯新增共 82 行——src/agent/pi.ts(+36)、tests/plugin-agent.test.ts(+46),与 storage/水合路径零交集 ✓
  2. 失败用例归属:两条失败确在 tests/issue3769-pooled-bare-load.test.ts / tests/issue3769-upgrade-compat.test.ts,同属统一存储水合家族,与 pi renderer 改动无耦合 ✓
  3. 时间线:红的 CI run 39525046198 创建于 01:03:24Z;其合并提交含 765abe36(部分修复)但不含 [PR] fix(ci): Storage mode isolation — #3769 pin both to full, plugin-fork CCR cold recovery removes sidecar, same assertion | fix(ci): 存储模式隔离 — #3769 双件钉 full,plugin-fork CCR 冷恢复删 sidecar,两模式同断言 #4077(602996bc2,01:39:44Z 合入)✓
  4. SMT 行:# SKIP no SMT solver available 确属跳过项,不计 fail,无需处理 ✓

为什么 rebase 能根治而不是碰运气:#4077 在这两个测试文件里显式钉了 BILI_STORAGE_UNIFIED="full"。偶发的根因是 CI runner 镜像的 legacy storage baseline 用 ??= 预载环境变量,并发下可能把这两个套件的存储车道从 full 翻到 legacy,index-row 读路径随即落空、水合断言失败。显式 env 优先于预载的 ??=,钉死后车道不再被翻——确定性修复。

请作者执行(只有你能推 fork 分支):

git fetch https://github.com/ranxianglei/billion-context.git master
git rebase FETCH/master        # 当前 master head: 56a0f5a46
git push --force-with-lease origin 2026-10-20_pi-acp-collapsed-display

已验证整个 rebase 窗口(merge-base 之后 master 的 17 个提交)没有任何一个触碰 src/agent/pi.ts 或 tests/plugin-agent.test.ts,rebase 必无冲突。push 后自动触发新一轮 CI,这两条用例应稳定转绿。

兜底:若你暂时无法推分支,说一声我们代跑失败的 5 个 job——但注意那仍是 #4077 之前的合并提交,可能再次变红,届时仍需回到 rebase。

结构化八问(本轮零代码变更,代码面结论沿用上一轮 review,此处仅就 CI 事件作答):

  1. 是什么问题:CI 5 个红全部来自 [Bug] MCP failed compression record rotation prematurely rewrites the history prefix, triggering expensive cache recompu | [Bug] MCP 失败压缩记录轮换提前改写历史前缀,触发大额缓存重算 #3769 存储家族两条测试的时序偶发,与本 PR 的 pi /acp 折叠功能无关。
  2. 什么原因导致的:CI runner 镜像的 legacy storage baseline 经 ??= 预载可翻动这两个套件的存储车道,使 full 模式的 index-row 水合断言失配;[PR] fix(ci): Storage mode isolation — #3769 pin both to full, plugin-fork CCR cold recovery removes sidecar, same assertion | fix(ci): 存储模式隔离 — #3769 双件钉 full,plugin-fork CCR 冷恢复删 sidecar,两模式同断言 #4077 已在两个文件内显式 pin BILI_STORAGE_UNIFIED=full 根治。
  3. 影响范围与严重程度:仅影响这两个套件在 CI 的红绿信号(flaky),不影响任何产品行为;对本 PR 表现为误报阻塞。
  4. 怎么修复的:本 PR 无需改码;根因已由 [PR] fix(ci): Storage mode isolation — #3769 pin both to full, plugin-fork CCR cold recovery removes sidecar, same assertion | fix(ci): 存储模式隔离 — #3769 双件钉 full,plugin-fork CCR 冷恢复删 sidecar,两模式同断言 #4077 修在 master,作者 rebase 到最新 master 即可让新 CI 带上修复。
  5. 是否有回归问题:本轮零 diff,不引入回归;本 PR 代码面的回归审查结论维持上轮(未发现回归)。
  6. 是否破坏缓存:不涉及。
  7. 是否改了设计方向:不涉及。
  8. 是否引入新配置:不涉及([PR] fix(ci): Storage mode isolation — #3769 pin both to full, plugin-fork CCR cold recovery removes sidecar, same assertion | fix(ci): 存储模式隔离 — #3769 双件钉 full,plugin-fork CCR 冷恢复删 sidecar,两模式同断言 #4077 的 pin 是测试内环境变量,非用户配置面)。

收工判定:待作者 rebase 并推送 → 新轮 CI 全绿后,本 PR 仅剩上一轮 review 第 7 问的 owner 决策项(@earendil-works/pi-tui 运行时值依赖内联进 dist/agent/pi.js,上轮推荐选项 (a) 接受+文档披露),该拍板仍悬空,其余无阻塞。

@ranxianglei
ranxianglei force-pushed the 2026-10-20_pi-acp-collapsed-display branch from 00dc37c to a7c4cfb Compare October 21, 2026 06:21
@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

已动手(auto-fix 通道第 2/2 次尝试):我直接把 PR 分支 rebase 到最新 master 并推回了你的 fork 分支,你不需要再手动操作。新一轮 CI 已全部触发(新 head a7c4cfbf4,06:21Z 起跑;当前 mergeable_state: blocked 是「等待必检项完成」,不是冲突)。

操作明细:

结构化八问:

  1. 是什么问题:CI 5 个红全部来自 [Bug] MCP failed compression record rotation prematurely rewrites the history prefix, triggering expensive cache recompu | [Bug] MCP 失败压缩记录轮换提前改写历史前缀,触发大额缓存重算 #3769 统一存储家族两条测试的时序偶发,与本 PR 的 pi /acp 折叠功能无关。
  2. 什么原因导致的:CI runner 镜像的 legacy storage baseline 经 ??= 预载环境变量,并发下可把这两个套件的存储车道从 full 翻到 legacy,index-row 水合断言随即失配;[PR] fix(ci): Storage mode isolation — #3769 pin both to full, plugin-fork CCR cold recovery removes sidecar, same assertion | fix(ci): 存储模式隔离 — #3769 双件钉 full,plugin-fork CCR 冷恢复删 sidecar,两模式同断言 #4077 已在两个测试文件内显式 pin 根治,但上一轮红早于其合入。
  3. 影响范围与严重程度:仅影响这两个套件在 CI 的红绿信号(flaky 误报阻塞合并),对任何产品行为零影响。
  4. 怎么修复的:无需改码;把 PR 分支 rebase 到含 [PR] fix(ci): Storage mode isolation — #3769 pin both to full, plugin-fork CCR cold recovery removes sidecar, same assertion | fix(ci): 存储模式隔离 — #3769 双件钉 full,plugin-fork CCR 冷恢复删 sidecar,两模式同断言 #4077 的最新 master 并推回 fork 分支,让新 CI 跑在带修复的合并提交上。内容零变更。
  5. 是否有回归问题:rebase 本身不引入回归(内容字节不变);唯一理论风险是 master 新提交与 pi.ts 导入面的类型耦合——已核查窗口变更均在无关功能域,待新一轮 CI 确认。
  6. 是否破坏缓存:不涉及。
  7. 是否改了设计方向:不涉及。
  8. 是否引入新配置:不涉及。

后续说明:

判定:修复动作已完成(rebase 推送成功 + 新 CI 已触发),等待新一轮结果即可,期间任何人无需操作。

@ranxianglei

Copy link
Copy Markdown
Owner

为啥这个没有自动发布npm

@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

因为 npm 自动发布只由「发布 PR 合入」触发,而本 PR 还没合入——两层原因:

  1. 机制上:这个仓库的自动发版只认发布分支(*_release-v*、commit 只改 version)合入那一刻,CI(release.yml)才会构建→测试→发 npm→打 tag→建 Release。像 [PR] feat(pi): fold /acp block details with Ctrl+O #4065 这种功能 PR,合入只是把代码放进 master,本身不触发任何发布。
  2. 现状上:[PR] feat(pi): fold /acp block details with Ctrl+O #4065 目前仍是 OPEN 未合并。最新已发布版本是昨天出的 v0.1.204([PR] release v0.1.204 #4190),所以这个折叠功能要到下一次发版才会进 npm。

要让它上线,两步:

  1. 合并 [PR] feat(pi): fold /acp block details with Ctrl+O #4065(当前 head 2786c1f5b 是你刚把 master 并进 PR 分支的提交,behind 状态不阻塞;注意该 head 上的 CI check-runs 目前全被取消、没有有效绿结果,合并前可先让 CI 重跑一轮确认);
  2. 你批准发版(比如回一句「发版 v0.1.205」)——按仓库规则发版必须你点头,我不能自行切发布分支。批准后我切 release PR,你合并它,CI 就自动发到 npm。

@ranxianglei
ranxianglei merged commit c81c17d into ranxianglei:master Oct 24, 2026
29 of 30 checks passed
@github-actions

Copy link
Copy Markdown
Contributor

📦 Merged Build Published

This merge to master was published as 0.0.812-master.c81c17d (rolling master tag).

npm install -g billion-context@0.0.812-master.c81c17d  # this exact build
npm install -g billion-context@master  # always the newest merged build

npm view billion-context@master prints the current version at any time.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

2 participants