从一次"记忆体检"说起
做前端 10 年，我一度觉得文档维护是团队管理的事，个人项目自己心里有数就行。但这两年 AI 深度介入开发后，我的看法彻底变了：当 AI 的上下文由一个记忆文件承载时，文档就是项目的真相。真相一旦漂移，AI 就会一本正经地把过期信息当输入，而你甚至看不出哪里不对——因为它写得足够自洽。
这篇文章记录我给梦想城镇攻略小程序（Taro 4 + Vue 3 + 微信云开发）做的一次记忆文件体检：怎么发现漂移、怎么逐条验证、最后沉淀了什么。
为什么文档会漂移
这个项目从"收菜提醒工具"转向"三消攻略平台"，中间经历了很多变更：tabBar 从 3 个变成 4 个、内容策略从文字攻略变成视频 UGC、新增资料库详情页。半年下来，代码在飞速迭代，记忆文件的更新永远慢半拍。
更深层的原因在 AI 协作模式本身：AI 生成文档的能力极强，但"校验文档是否与代码一致"这个动作它天然不会主动做。它只是顺着上下文把内容写完整、写自洽——越顺滑，越没人怀疑它没和代码对过。这跟人类写文档"凭印象"是同一个问题，但 AI 会把印象包装得更加可信。
体检过程：逐条交叉验证
我的方法朴素到不值一提：把 MEMORY.md 里每一条记录，拿到代码里找客观证据。
| 记忆条目 | 验证方式 | 结果 |
|---|---|---|
| 项目路径 | ls 实际目录 |
记录 /h/，实际 /my/，补 my/ |
| 云函数清单 | ls cloudfunctions |
记 1 个，实际 3 个 |
| tabBar 数量 | 读 app.config.js |
记 3 个，实际 4 个 |
| 上传架构 | 对照代码请求地址 | 记云存储，实际自建后端 |
| 压缩脚本路径 | 检查脚本可用性 | Windows 路径，macOS 失效 |
五个典型问题，按风险排个序：
架构事实错误排第一。 记忆里写"攻略视频走云存储 userVideos"，实际上代码早就改成了自建后端 https://getoffer.alleria.cn/api/upload。这种错最危险：排障时按错误链路查，方向直接跑偏；而且这条通道强依赖外部服务可用性，是需要重点维护的架构事实。
清单缺漏排第二。 云函数只记了 1 个 sendReminder，实际还有 getMyOpenId、match3Guide。AI 排查时少知道一个能力，就少一条排查路径。
路径与环境残留排第三。 项目路径少了 my/、脚本路径还是 Windows 的 H:\、D:\。这类错误不致命，但会让 AI 频繁定位失败，累积起来非常磨人。
另外还有一处漏记：7-30 落地的"资料库详情页反向关联（可用于）"功能，记忆里完全没提。漏记比错记更隐蔽——你不会知道 AI 少知道了什么。
非纠错观察：代码里的旧叙事
体检还发现首页注释仍写"提醒助手为核心功能"、导航栏标题还是"梦想的城镇收菜助手"——与产品转向三消攻略的旧叙事残留。这跟记忆漂移其实是同源问题：变更没有闭环。改产品方向时，代码文案、注释、记忆文件本应一起更新，漏了哪一块，哪一块就会成为误导源。
方法论沉淀
这次体检让我把"文档治理"从概念变成了可执行的动作，三条：
- 验证靠证据，不靠印象。
ls、读配置文件，是文档治理的最小可靠手段。 - 变更即回写。改架构、功能、脚本时顺手更新记忆文件，把"文档同步"做进变更的完成定义里。
- 定期全量校对。把文档漂移当技术债，按风险分级偿还：架构事实 > 清单 > 路径。
结尾
AI 辅助开发越深入，文档治理越重要。记忆文件是 AI 的输入，输入质量决定输出质量——这不是玄学，是工程事实。
如果你也在用 AI 协作开发，建议找个下午给项目记忆做一次体检，你会发现惊喜（或者惊吓）。有问题欢迎留言交流。