mex为 AI 编码代理提供持久化项目记忆

如果你经常用 AI 编码助手来写复杂项目，大概遇到过这样的场景：聊着聊着，代理就忘了之前的讨论，或者在新一轮对话里彻底跑偏。问题不在于模型本身，而是代理缺乏对项目全貌的“记忆”——每次对话几乎从零开始。mex 正是来填补这个空白的。它是一个轻量的 CLI 工具，核心功能是为 AI 编码代理提供持久化的项目记忆，让它们记住代码库的结构、关键决策和当前进度。

工作原理：结构支架与漂移检测

mex 的做法很务实。它通过两种机制来维系代理的上下文：结构化支架和漂移检测。结构化支架是一套可定制的提示模板，引导代理以一致的方式理解项目基础结构、API 设计和数据流。漂移检测则持续监控项目状态，当发现实际代码与“预期”记忆出现偏差时（比如新增了模块或修改了接口），会主动通知代理更新记忆。

具体使用流程很简单：

• 初始化：在项目根目录运行 mex init，生成一份描述文件（mex.json），记录项目名称、语言、关键依赖等元数据。
• 注册支架：用 mex scaffold 定义核心模块、函数签名和文件路径，形成一张“逻辑地图”。
• 启动代理：将 mex 的输出注入到 AI 对话的 system prompt 中，代理就能“读取”项目记忆。
• 检测漂移：每次代码变更后运行 mex drift，对比当前代码与记忆的差异，自动更新描述文件。

听起来有点技术向，但实际跑一遍就知道，它把本来需要手动维护的上下文变成了自动化流程。

典型使用场景

对独立开发者或者小型团队而言，mex 最直接的价值体现在长期项目维护。假设你用一个 AI 代理来生成新功能的代码，但每次对话都从零介绍项目结构，两轮下来就烦了。用 mex 之后，代理能记住你已经定义的核心类、数据库模型以及路由规则，减少了大量重复上下文。

另一个典型场景是重构或迁移。比如你需要把代码从 JavaScript 迁移到 TypeScript，或者替换一个基础库。mex 可以保持对变更的追踪：代理知道哪些文件改过了、哪些类型需要更新，不会再出现“这个函数明明已经删掉了，为什么代理还在生成调用”的尴尬。

注意：mex 主要面向使用 Cursor、Copilot Chat 或类似工具的开发者。它本身不是代理，只是一个记忆持久化层。

上手体验与局限

安装方面，mex 基于 Node.js，通过 npm 全局安装即可：npm i -g mex-memory。首次使用需要一点配置来定义支架，但对熟悉命令行的人来说耗时不过十分钟。文档写得清晰，示例也很充分。

当然，它也有局限。首先，mex 依赖用户手动运行 drift 命令来更新记忆——消息推送的感觉不强。其次，支架的自定义度较高，对大型复杂项目，初始定义需要投入一些时间。另外，当前版本仅支持 JavaScript/TypeScript 项目，其他语言的适配尚在计划中。

不过从社区反馈看，这个方向很受期待。项目在 GitHub 上不到两个月就积累了超过 1100 星，说明大家在 AI 编码的“记忆问题”上确实有切身体会。

实用建议

• 如果你的项目已经使用 Cursor 或 Copilot，且感到上下文丢失频繁，可以立即试用 mex。它带来的连贯性提升很容易感受到。
• 建议从小型项目或单个模块开始尝试，熟悉支架定义后，再推广到整个代码库。
• 配合 CI 流程：在 git hook 里加入 mex drift 命令，实现记忆的自动更新。

总的来说，mex 是对 AI 编码工作流的一个巧妙补充。它不改变模型本身，却改善了代理的长期记忆能力。如果你希望通过更少的废话让代理更有效地工作，这个工具值得一试。