MiMo Code 的持久化记忆通过 MEMORY.md 和 checkpoint.md 实现：前者是人工+AI 维护的项目知识中枢，沉淀关键决策；后者是自动快照任务状态，含11个结构化字段。但它的价值远不止于“记住对话”，而是把项目真正变成可积累、可复用的上下文资产——关键不在装得多，而在结构清晰、调用精准、跨会话自动生效。

MEMORY.md：你的项目知识中枢

先拆解第一块——MEMORY.md。它是MiMo Code跨会话记忆的核心载体，本质上是一份人工+AI共同维护的项目文档，不记聊天流水，只沉淀真正影响后续开发的决策和事实。

• 首次启动时，MiMo Code会自动扫描项目结构，生成初始MEMORY.md（包含目录树、技术栈识别、关键配置说明）。
• 你每次用/remember命令添加内容，比如：/remember 这个服务必须兼容 iOS 15+，JWT token 有效期为24小时。
• Build模式下，Agent修改代码后若涉及架构调整（比如新增中间件、切换数据库驱动），会主动建议更新MEMORY.md并附上变更依据。
• 文件默认存于项目根目录，Git可直接跟踪——它本身就是项目文档的一部分，不是临时缓存。

简单说，这就是项目的“长期记忆”，每次打开都能找回状态。

checkpoint.md：任务状态的自动快照

第二块是checkpoint.md，它不是日志，而是结构化任务状态存档。每当会话进入关键节点（完成一个PR、修复一个阻塞Bug、跑通集成测试），系统自动生成该文件。

• 包含11个固定字段：意图、当前动作、任务树进度、已发现错误、设计决策、依赖变更、测试结果、未决事项、下一步建议、上下文压缩摘要、时间戳。
• 你下次打开同一项目，MiMo Code会读取最新checkpoint.md，自动恢复任务上下文——比如“上次卡在Redis连接池超时问题，已定位到config.js第37行”。
• 手动触发方式：/checkpoint now（适合人工确认重要节点）或/checkpoint rollback（回退到上一个稳定检查点）。
• 所有checkpoint文件按日期+哈希命名，存于.mimo/checkpoints/，支持命令行快速查看：mimo checkpoint list。

相当于给每个任务节点拍了张快照，下次回来无缝衔接。

让记忆真正“活”起来的三个实操技巧

光存不查、不联动，等于没建。记忆的价值取决于你怎么用。这里有三个让记忆“活”起来的技巧：

• 用 /search 精准唤醒：不是翻文件，而是自然语言检索。比如输入/search "登录页为什么不用JWT？"，它会同时搜索MEMORY.md中的约束说明 + 所有checkpoint.md中相关设计决策。
• 在 Plan 模式里验证记忆有效性：Plan模式只读不执行，适合快速确认记忆是否完整。比如运行mimo plan "给用户中心加信息验证码"，它会先比对MEMORY.md中的认证策略和已有checkpoint，再给出可行性评估。
• 把 notes.md 当作会话便签，别当主记忆库：notes.md是纯会话级临时笔记（比如“待确认张工邮箱”），关掉终端就清空。真正要保留的，必须用/remember写进MEMORY.md或触发checkpoint。

常见误区与避坑提醒

很多人配置完就以为万事大吉，结果下次打开发现“失忆”，往往是因为踩了这几个坑：

• 项目路径变了但没重新初始化：MiMo Code记忆绑定的是绝对路径。换目录或clone新副本后，需运行mimo init --force重建MEMORY.md和checkpoint索引。
• 误删 .mimo 目录：这个隐藏目录存着SQLite FTS5索引库和checkpoint元数据，删了等于清空所有记忆。建议Git忽略它，但备份脚本里要包含。
• 在非项目根目录启动：MEMORY.md和checkpoint.md都依赖项目根目录定位。务必cd到项目顶层再运行mimo或mimo web。
• 混淆Build和Plan权限：只有Build模式能写MEMORY.md和触发checkpoint；Plan模式只能读。想更新记忆，必须切到Build模式再操作。

以上这些细节到位了，持久化记忆才能真正成为你项目里的“第二大脑”，而不是一堆无用的文件。