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 編碼工作流的一個巧妙補充。它不改變模型本身，卻改善了代理的長期記憶能力。如果你希望通過更少的廢話讓代理更有效地工作，這個工具值得一試。