第十七節 歷史折疊（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 上以"折疊摘要 →（展開）→ 原訊息"層疊展示，可逐層展開到最早歷史。