第三部分，上下文与 Sessions

Compaction 与分支摘要

理解上下文阈值、自动 Compaction、手工压缩和 Branch Summarization 的信息保留方式。

进阶 / 12 分钟 / 第 17 篇

上下文何时被压缩

当对话接近模型上下文上限时，Pi 会把较早内容总结为 CompactionEntry，同时保留最近消息。也可以使用 /compact 手工触发并提供自定义要求。

摘要应保留目标、约束、进展、决策、下一步和关键上下文。扩展可以通过 session_before_compact 事件自定义或取消压缩。

/compact
/compact 保留所有失败测试、修改文件和未解决风险

从 /tree 离开一条分支时，Pi 可以总结被放弃路径并追踪文件变化，让新分支理解之前尝试过什么。

摘要是有损压缩。关键决定、测试和恢复步骤应写进仓库文档或提交，不要只依赖 Session 摘要。

本页由 xueai 根据 Pi 官方资料用中文重新组织和讲解。Pi 更新频繁，命令、包名和接口以官方最新文档为准。