KKCode 的记忆系统解决两件事：
- 会话持久化：一次对话中断后，能从上次的状态无损续接。
- 长期记忆提炼（consolidation）：把跨会话的零散上下文，自动提炼成可复用的长期记忆。
相关模块：kkcode/session/（持久化）与 kkcode/memory/（记忆与 consolidation）。
- 每一轮交互（用户输入、模型输出、工具调用与结果）以 JSONL 形式追加写入会话目录。
- 支持断点恢复：重开会话时回放 JSONL 重建上下文。
- 与 两层上下文压缩 协同：压缩产生的
RecoveryState也随会话落盘，保证长会话崩溃后可续接。
- 自动记忆：重要事实、用户偏好、项目约定在交互中被自动抽取。
- Consolidation（ consolidation / 巩固）：定期对短期记忆做合并、去重、抽象，沉淀为长期记忆，避免记忆无限膨胀且保持高信噪比。
- 在 Team 场景下，记忆可在 teammate 间受控共享（受 文件锁邮箱 与权限规则约束），避免信息孤岛或泄漏。
记忆系统与两层压缩是正交的两套机制：
| 机制 | 关注点 | 触发 |
|---|---|---|
| 两层压缩 | 单次会话内的上下文窗口 | 窗口逼近阈值 |
| 记忆系统 | 跨会话/跨任务的长期知识 | 交互中自动 + 定期 consolidation |
二者配合，使 KKCode 既能「会话内不丢上下文」，也能「会话间积累经验」。
| 目录 | 职责 |
|---|---|
kkcode/session/ |
JSONL 持久化、断点恢复 |
kkcode/memory/ |
自动记忆、consolidation、共享记忆 |
返回：核心机制详解