Memory Agent 采用项目记忆、会话检查点、任务进度三层机制协同工作：项目记忆（MEMORY.md）存长期规则，检查点（checkpoint.md）快照会话状态，任务进度（tasks/<id>/progress.md）跟踪单次compose流程。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
理解 Memory Agent 的三层记忆机制
MiMo Code 的 Memory Agent 不是简单缓存对话，而是通过项目记忆、会话检查点、任务进度三重结构协同工作。项目记忆（如 MEMORY.md）保存长期规则——比如“本项目禁用 React Class Component”或“所有 API 必须走统一网关”。会话检查点（checkpoint.md）在上下文即将溢出前自动快照当前状态，含已执行命令、工具返回结果、未完成子任务。任务进度则按 ID 存储在 tasks/<id>/progress.md，记录每一步完成标记、失败原因和重试策略。这三层不混用：项目记忆跨 session 持久存在；检查点仅用于中断恢复；任务进度只服务于单次 compose 流程。
主动干预记忆状态的实用命令
Memory Agent 支持手动触发关键操作，避免依赖自动机制：
-
/memory list查看当前加载的项目记忆条目及最后更新时间 -
/memory edit MEMORY.md直接编辑项目规则（支持 Markdown，保存后立即生效） -
/checkpoint save强制保存当前会话状态，适合复杂重构中途暂停 -
/task resume <id>恢复指定任务，系统自动重建上下文并跳过已完成步骤 -
/dream now手动触发记忆沉淀（默认每7天自动运行），合并重复认知、压缩冗余描述
注意：/dream 不会删除原始记录，而是生成 distilled_memory.md 供后续推理优先调用，原始 MEMORY.md 仍可人工维护。
在 Compose 模式中利用记忆做闭环验证
Compose 模式下，Memory Agent 与 Goal 验证器深度联动。例如你设定目标为“为用户登录模块添加双因素认证，并通过全部单元测试”，系统不仅执行代码修改，还会：
- 从项目记忆中提取已有认证流程规范（如 JWT 签名算法、OTP 时效要求）
- 在每次生成测试用例前，比对
tasks/<id>/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 或更高版本——低版本模型无法解析新版记忆格式
记忆不是黑盒，每个环节都有对应命令和日志路径可查。
