Memory Agent 的记忆系统并非简单地缓存对话记录，而是通过三层结构高效协同运作：项目记忆、会话检查点与任务进度。项目记忆（例如 MEMORY.md）用于存储长期规则——如“本项目禁止使用 React Class Component”或“所有 API 必须经由统一网关”。会话检查点（checkpoint.md）会在上下文即将溢出前自动保存当前状态的快照，记录已执行命令、工具返回结果及未完成的子任务。任务进度则按 ID 存储在 tasks/ 中，标明每一步的完成情况、失败原因以及重试策略。三个层级各司其职：项目记忆跨会话持久保留，检查点专为中断恢复设计，任务进度仅服务于单次 compose 流程。理解这一分工后，后续许多操作便会更加顺畅自然。
深入理解 Memory Agent 的三层记忆机制
项目记忆类似于大脑的长时记忆区域，会话检查点好比短期工作记忆的快照，任务进度则如同手头的待办清单——三者既彼此独立又相互支撑。举个例子：你在 MEMORY.md 中规定所有 API 都必须走统一网关，这条规则会在每次 compose 时被自动加载。当上下文接近满载时，系统自动生成检查点，将当前执行状态完整保留。任务进度文件则记录每一步的进展，例如“测试用例通过率 80%”、“第三步执行失败原因：依赖包版本冲突”。这样一来，即便中途被打断，重启后也能精准恢复，确保 AI 编程协作流程不中断。
主动干预记忆状态的实用命令
尽管自动机制已经相当智能，但有时仍需手动介入。Memory Agent 提供了几个非常实用的命令：
/memory list—— 查看当前加载的项目记忆条目及其最后更新时间，确认规则是否生效。/memory edit MEMORY.md—— 直接编辑项目规则，支持 Markdown 格式，保存后立即生效，适合临时调整规则。/checkpoint sa ve—— 强制保存当前会话状态，是进行复杂重构时中途暂停的好帮手。/task resume—— 恢复指定任务，系统自动重建上下文并跳过已完成步骤。/dream now—— 手动触发记忆沉淀（默认每7天自动运行），合并重复认知、压缩冗余描述。注意，Dream 不会删除原始记录，而是生成distilled_memory.md供后续推理优先调用，原始MEMORY.md仍可人工维护。
这些命令就像记忆系统的控制面板，让你随时掌握记忆状态，必要时还能直接编辑，提升 AI 编程助手的可控性。
在 Compose 模式中利用记忆实现闭环验证
Compose 模式下，Memory Agent 与 Goal 验证器的联动才是真正的高阶玩法。假设你设定的目标是“为用户登录模块添加双因素认证，并通过全部单元测试”，系统不会仅仅机械地修改代码，而是会：
- 从项目记忆中提取已有的认证流程规范（如 JWT 签名算法、OTP 时效要求）
- 在每次生成测试用例前，比对
tasks/中的覆盖率目标/progress.md - 执行
npm test后，将实际失败信息写入进度文件，而非简单地丢弃结果 - Goal 验证器检查时，同时读取原始需求描述、项目记忆约束、当前进度文件和终端输出日志，三者全部匹配才判定完成
这种设计让 AI 不再“自说自话”，而是基于可追溯的记忆证据链做出决策。闭环验证确保每一步都有据可查，显著提升代码生成的质量与可靠性。
调试记忆失效的常见排查路径
遇到 AI 忽略已声明规则的情况，不必急于怀疑，按以下顺序排查：
- 确认
MEMORY.md文件是否位于项目根目录，且编码为 UTF-8（BOM 会导致解析失败） - 运行
/memory list，检查对应条目状态是否为 active 而非 stale - 查看
.mimo/cache/下最近的checkpoint_*.json，确认关键记忆字段是否被正确序列化 - 若刚执行过
/dream now，检查distilled_memory.md是否覆盖了原始规则（此时需手动合并） - 使用
/model info确认当前模型为 MiMo-V2.5 或更高版本——低版本模型无法解析新版记忆格式
记忆系统并非黑盒，每个环节都有对应的命令和日志路径可供查询。只要按步骤排查，绝大多数问题都能准确定位并解决，让 AI 编程协作更加顺畅高效。