深度教程：MiMo Code 的持久化记忆存储原理与应用

聊到 MiMo Code 的持久化记忆，很多人第一反应是“不就是把聊天记录存下来嘛”。但如果你真这么想，可能就低估了它的设计意图。这套机制不是简单的日志归档，而是围绕真实开发场景构建的一套工程化状态维持系统。它要解决的实际问题是：当你一个编程任务需要跨天、跨会话、跨上百轮交互时——比如上周定下的接口规范、昨天改过的配置路径、甚至临时放弃的分支策略——AI 怎么还能记得住？答案不在语言模型的参数里，而在它的记忆架构里。

那么，这套记忆架构究竟是怎么工作的？

SQLite FTS5 驱动的本地记忆底座

所有记忆数据默认写入项目根目录下的

文件。它不是普通的数据库表，而是基于 SQLite 的 FTS5（全文本搜索）扩展构建的——专为语义检索优化的索引结构。这意味着什么？你可以搜“暗色模式组件”，结果能命中“dark mode toggle”或“theme switcher”，靠的是模糊匹配、词干提取和权重排序。

• 每次会话结束时，主 Agent 不会保存原始对话流，而是由 Writer 子 Agent 提取关键实体（文件路径、函数名、决策结论、错误日志），生成结构化的条目。

• MEMORY.md
  是可读摘要，

  checkpoint.md
  是二进制快照，两者都由 FTS5 索引同步维护，搜索响应基本在毫秒级。
• 数据库按项目自动隔离——不同仓库各自独立记忆，不会混用，也不会泄露。

三重记忆机制协同工作

单一存储应对不了长程任务的复杂性，所以 MiMo Code 把记忆拆成三个层次，各司其职：

• 项目记忆
  ：长期沉淀。自动生成 MEMORY.md，记录架构选型、编码规范、已知坑点、第三方依赖约束。举个例子：你第一次问“这个服务要不要加 JWT 验证”，回答会被提炼成一条规则写入项目记忆，后续所有跟鉴权相关的操作都会自动参考这条规则。

• 会话检查点
  ：中断续写保障。每 15 轮交互，或者检测到 Git 提交、文件保存时，自动创建 checkpoint.md。下次用 mimo --resume 启动，直接加载最新的检查点，一切无缝衔接，不需要重新解释上下文。

• 动态简报压缩
  ：上下文守门员。当对话接近模型窗口上限时，独立的子 Agent 启动压缩流程——合并同类操作（比如连续三次修改同一个 config.ts）、剔除中间调试输出、保留最终状态和失败原因，生成精简版上下文供主 Agent 继续使用。

/dream 命令：让记忆自我进化

记忆不是静态的归档，而是持续演化的知识体。/dream 是 MiMo Code 内置的记忆治理命令，每 7 天自动触发（也可以手动执行）。它调用专用的 Distill Agent 完成四件事：

• 扫描所有历史会话和当前的 MEMORY.md，识别重复描述（比如多次提到“API 返回 401 时要刷新 token”），然后去重合并。
• 验证所有引用的文件路径是否仍然存在，失效路径会被自动标记为 obsolete 并降权。
• 将分散的同类决策聚类——比如五次重构某模块的尝试，合并生成一条“该模块重构建议”的新条目。
• 输出一份 human-readable 的

  dream-summary.md
  ，告诉你这周项目认知有哪些更新。

开发者可干预的记忆控制点

虽然记忆系统默认是全自动的，但关键节点留出了人工干预的入口：

• 用 /forget file:src/utils/api.ts 可以主动清除某个文件相关的记忆，适合重构后清理旧上下文。
• 直接编辑 MEMORY.md，增删项目规则，保存后立即生效——FTS5 索引会自动重建。
• 设置 MIMO_MEMORY_RETENTION=30d 环境变量，控制历史会话在数据库中的保留天数。
• 启用 --no-memory 启动参数可以完全关闭持久化，适合敏感代码仓的临时调试。

这套机制没有依赖大模型自身的记性，而是用确定性的工程手段兜住不确定性。它不承诺“永远不忘”，但确保“该记住的，一定记得住；该遗忘的，干净利落。”