mimo code 的持久化记忆通过 memory.md 和 checkpoint.md 实现：前者是人工+ai 维护的项目知识中枢，沉淀关键决策；后者是自动快照任务状态，含11个结构化字段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
MiMo Code 的持久化记忆不是“记住对话”，而是把项目真正变成可积累、可复用的上下文资产。关键不在装得多，而在结构清晰、调用精准、跨会话自动生效。
MEMORY.md：你的项目知识中枢
这是 MiMo Code 跨会话记忆的核心载体，本质是一份人工+AI 共同维护的项目文档。它不记录聊天流水，只沉淀真正影响后续开发的决策和事实。
- 首次启动时，MiMo Code 会自动扫描项目结构，生成初始 MEMORY.md（含目录树、技术栈识别、关键配置说明）
- 你每次用 /remember 命令添加内容，比如：/remember 这个服务必须兼容 iOS 15+，JWT token 有效期为24小时
- Build 模式下，Agent 修改代码后若涉及架构调整（如新增中间件、切换数据库驱动），会主动建议更新 MEMORY.md 并附上变更依据
- 文件默认存于项目根目录，Git 可直接跟踪——它本身就是项目文档的一部分，不是临时缓存
checkpoint.md：任务状态的自动快照
它不是日志，而是结构化任务状态存档。每当会话进入关键节点（如完成一个 PR、修复一个阻塞 Bug、跑通集成测试），系统自动生成 checkpoint.md。
- 包含 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 模式再操作
