MiMo Code Memory Agent 高级教程：打造高效的 AI 编程协作流

Memory Agent 的记忆系统并不是简单地把对话缓存起来，而是通过三层结构协同工作：项目记忆、会话检查点、任务进度。项目记忆（比如 MEMORY.md）保存的是长期规则——比如“本项目禁用 React Class Component”或者“所有 API 必须走统一网关”。会话检查点（checkpoint.md）在上下文即将溢出前自动快照当前状态，记录已执行的命令、工具返回结果、未完成的子任务。而任务进度则按 ID 存储在 tasks//progress.md，标记每一步的完成情况、失败原因以及重试策略。这三层各司其职：项目记忆跨 session 持久存在，检查点仅用于中断恢复，任务进度只服务于单次 compose 流程。理解了这个分工，后面很多操作就自然而然了。

理解 Memory Agent 的三层记忆机制

项目记忆就像大脑的长时记忆区，会话检查点类似短期工作记忆的快照，任务进度则是手头的待办清单——三者彼此独立又互相支撑。举个例子：你在 MEMORY.md 里规定所有 API 都必须走统一网关，这个规则会在每次 compose 时被自动加载。当上下文快满时，系统自动生成检查点，把当前执行状态完整保留。而任务进度文件则记录每一步的进展，比如“测试用例通过率 80%”、“第三步执行失败原因：依赖包版本冲突”。这样一来，即便中间打断，重启后也能精准恢复。

主动干预记忆状态的实用命令

虽然自动机制已经挺智能，但有时还是需要手动干预。Memory Agent 提供了几个非常实用的命令：

• /memory list —— 查看当前加载的项目记忆条目及最后更新时间，确认规则是否生效。
• /memory edit MEMORY.md —— 直接编辑项目规则，支持 Markdown，保存后立即生效。适合临时调整规则。
• /checkpoint sa ve —— 强制保存当前会话状态，进行复杂重构时中途暂停的好帮手。
• /task resume —— 恢复指定任务，系统自动重建上下文并跳过已完成步骤。
• /dream now —— 手动触发记忆沉淀（默认每7天自动运行），合并重复认知、压缩冗余描述。注意，Dream 不会删除原始记录，而是生成 distilled_memory.md 供后续推理优先调用，原始 MEMORY.md 仍可人工维护。

这些命令就像一个控制面板，让你随时知道记忆系统的状态，必要时还能直接编辑。

在 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 或更高版本——低版本模型无法解析新版记忆格式

记忆系统不是黑盒，每个环节都有对应的命令和日志路径可查。只要按步骤走，绝大多数问题都能定位到根因。