Smart Compact — 智能压缩增强

四阶段渐进式压缩策略，在 /compact 前先把重要信息救出来。

什么时候用

• - 用户说智能压缩、smart-compact、压缩检查
• 在手动执行 /compact 之前先跑一遍
• 对话上下文快满时，主动触发
• Heartbeat 检测到 context 接近 80% 时自动建议

核心理念

传统的上下文压缩是一刀切——整个对话被浓缩成一段摘要，大量细节在过程中丢失。

Smart Compact 采用四阶段渐进式策略，在 /compact 之前插入一个预处理阶段：

1. 1. 扫描：识别对话中的大块工具输出和关键信息
2. 提取：把值得保留的信息写入记忆文件
3. 检查：生成压缩前检查清单，标记风险项
4. 压缩：用户确认安全后才执行压缩

核心原则：先救再压，宁可多存也不能漏存。

执行流程

Phase 1 — 扫描工具输出

1. 1. 回顾当前对话中所有的工具调用结果
2. 识别大块输出（超过 50 行或 2000 字符的工具结果）
3. 对每个大块输出评估：

- 是否包含关键信息（决策、配置、错误信息、地址等） - 是否已经被后续对话引用或总结过 - 是否是重复或冗余的（如多次 ls、git status）

Phase 2 — 提取记忆

1. 1. 从工具输出和对话中提取值得持久化的信息：

- 新发现的事实：地址、配置值、端点、文件路径 - 决策和原因：为什么选了方案 A 而不是 B - 错误和解决方案：踩坑记录 - 用户偏好：明确表达的喜好或要求 - 任务进度：哪些做完了，哪些还没做

1. 2. 将提取的信息追加写入 memory/YYYY-MM-DD.md

- 使用 edit（追加模式），绝不覆盖已有内容 - 每条记忆附带简短的来源说明

Phase 3 — 生成压缩前检查清单

输出一份结构化的检查清单：

📋 Smart Compact 检查清单
━━━━━━━━━━━━━━━━━━━━━━

📊 扫描统计：

• - 工具调用总数：N 次
• 大块输出（>50行）：N 个
• 已引用/总结过的：N 个
• 可安全压缩的：N 个

💾 已提取到记忆：

• - [+] 新事实：简要描述...
• [+] 决策记录：简要描述...
• [+] 错误解决：简要描述...

（共 N 条写入 memory/YYYY-MM-DD.md）

⚠️ 需要注意：

• - [!] 某某工具输出包含重要数据但尚未被引用
• [!] 某某配置值只出现在工具输出中

✅ 建议：可以安全执行 /compact

Phase 4 — 执行压缩（可选）

• - 如果检查清单显示✅ 可以安全压缩，提示用户确认
• 用户确认后，执行 /compact
• 如果有 ⚠️ 警告项，先处理完再压缩

规则

必须遵守

• - 绝不丢弃未被记录的关键信息：宁可多存也不能漏存
• 追加写入：只用 edit 追加到 memory 文件，绝不覆盖
• 不自动压缩：除非用户明确确认，否则只生成检查清单
• 透明：每一步操作都告知用户

信息分类标准

• - 必须保存：重要配置、地址端点、文件路径、错误解决方案
• 建议保存：决策原因、用户偏好、任务进度
• 可以丢弃：重复的 ls 输出、已被总结的搜索结果、中间调试过程

与 Dream Skill 的配合

Smart Compact 和 Dream 是互补的：

• - Smart Compact：实时的，在压缩前抢救信息 → 写入日记
• Dream：定期的，把日记整合到长期记忆 → 更新 MEMORY.md

推荐工作流：

1. 1. 对话中随时触发 Smart Compact 保护信息
2. 每天凌晨 Dream 整合日记到长期记忆
3. 形成完整的记忆保护链条