第十七节 历史折叠（Compact）
[!ref] 详解见用户手册「历史折叠（Compact）」节。
17.1 触发方式
| 来源 | 时机 |
|---|---|
| 手动 | 用户 ⌘⇧K / 标签右键 / /compact |
| 自动 | 助手在自身 context 接近上限时反向触发 |
| 会话切换 | 切到长会话时按需 |
17.2 折叠摘要的字段
| 字段 | 说明 |
|---|---|
compacted_from_ids |
被折叠的原消息 id 列表 |
summary |
LLM 生成的摘要正文 |
plan |
当时计划的最新状态 |
todos |
当时待办的全部条目 |
decisions |
用户已确认的关键决策 |
facts |
必需事实（路径、版本号、配置项等） |
excluded_from_context |
被折叠的原消息是否对 LLM 隐藏 |
17.3 多次折叠
折叠是 append-only 的：每次折叠都新增一条节点而非替换；UI 上以"折叠摘要 →（展开）→ 原消息"层叠展示，可逐层展开到最早历史。