Compaction 与分支摘要

沿执行轨迹走

1. Compaction 保留近期工作

   自动压缩按上下文窗口减去预留输出预算判断阈值，从后往前寻找保留区，概括更早历史，并保存 summary、压缩前 token 数和保留尾部或边界信息。

   [repo] [docs]

2. 分支摘要连接两条路径

   使用 /tree 离开旧分支时，Pi 可寻找旧 leaf 与目标路径的共同祖先，只总结被放弃的那段工作，再把摘要挂到新位置。

   [repo] [docs]

3. 文件状态随摘要累积

   默认摘要会追踪已读和已修改文件；重复压缩或嵌套分支摘要会合并这些记录，减少重要工程状态在长会话中丢失。

   [repo]

每一步改变了什么

• 压缩摘要是有损状态，应把不可丢的约束、验证结果和未提交改动写进稳定文件或结构化状态。

• 分支摘要适合带走结论，不适合替代需要逐字审计的原始工具输出；原始树仍应保留。

这条轨迹没有说明什么

• 阈值和保留预算可配置，模型生成的摘要也可能遗漏信息；不能把“压缩成功”理解为语义无损。