各位開發(fā)者朋友們，大家好！我是你們的老朋友，專注于探索和推廣大模型在研發(fā)效能領域應用的‘非架構(gòu)’。今天，我們要聊一個在 AI 代碼編輯器中非常實用，但可能還未被廣泛認知和應用的技術(shù)——Memory Bank（記憶庫）。特別是對于 Cursor 這樣優(yōu)秀的 AI 代碼編輯器，Memory Bank 的引入，簡直是如虎添翼，能極大地提升我們大型項目的開發(fā)效率和代碼質(zhì)量。

AI 代碼編輯時代，大型項目開發(fā)的“痛點”你中招了嗎？

相信很多使用 AI 代碼編輯器（如 Cursor、Copilot 等）進行大型軟件項目開發(fā)的朋友們都遇到過類似的困擾：

1. 項目背景“說倦了”：每開啟一個新的對話（Session），都得不厭其煩地向 AI 重復項目的核心目標、技術(shù)棧選型、關鍵架構(gòu)特點等信息，生怕 AI “失憶”導致后續(xù)的建議偏離方向。
2. 上下文“等不起”：AI 編輯器在新對話中往往需要重新掃描和分析項目代碼，以獲取必要的上下文信息。這個過程不僅耗時，而且對于像 Cursor 這樣有請求次數(shù)限制的工具，頻繁的掃描無疑會加速額度的消耗。
3. 一致性“保不住”：由于跨對話的提示信息可能存在細微差別，AI 生成的代碼或提出的建議可能在風格、實現(xiàn)方式上出現(xiàn)不一致，給項目后期的維護埋下隱患。

這些是不是聽起來很熟悉？別擔心，你不是一個人！這些問題不僅影響開發(fā)效率，也可能間接影響代碼質(zhì)量和項目穩(wěn)定性。那么，有沒有一種方法能夠讓 AI 編輯器更“長記性”，更懂我們的項目呢？答案是肯定的！Memory Bank 技術(shù)，為我們指明了方向，并且實踐證明效果顯著。

Memory Bank：AI 的“外接大腦”是如何煉成的？

那么，神奇的 Memory Bank 究竟是什么呢？

簡單來說，Memory Bank 是一種結(jié)構(gòu)化的文檔系統(tǒng)，它允許 AI 代理（如我們配置后的 Cursor）在不同的會話（Session）之間保持項目上下文的連續(xù)性。它通過一系列精心組織的 Markdown 文件來存儲項目的核心信息，從而將 AI 從一個“健忘的助手”轉(zhuǎn)變?yōu)橐粋€能夠“記住”項目細節(jié)的持久開發(fā)伙伴。AI 在每次開始新任務時，都必須讀取這些 Memory Bank 文件，以確保其對項目有全面且準確的理解。

Memory Bank 系統(tǒng)是如何運作的？

Memory Bank 的運作機制并非特定于某個編輯器本身，而是一種通過結(jié)構(gòu)化文檔來管理 AI 上下文的方法論。

其核心思想是：將項目相關的各類重要信息，分門別類地存儲在一系列 Markdown 文件中。這些文件通常存放在項目根目錄下的一個特定文件夾內(nèi)（例如 ??memory-bank/??）。當你指示 AI（例如，通過自定義指令或特定的規(guī)則文件）遵循 Memory Bank 規(guī)則時，AI 會讀取這些文件，重建對項目的理解。

在項目開發(fā)過程中，AI 會根據(jù)新的進展、決策或你明確的指令（如“update memory bank”）來更新這些文檔。這樣，即使 AI 的“短期記憶”在會話結(jié)束后被重置，它也能通過 Memory Bank 這個“外部大腦”快速恢復對項目的認知。

Memory Bank 的核心組成部分：AI 的“記憶芯片”

一個典型的 Memory Bank 由以下幾個核心 Markdown 文件構(gòu)成，每個文件都承載著項目不同維度的信息：

1. ??projectbrief.md?? (項目簡介):

• 這是 Memory Bank 的基石，定義了項目的核心需求、目標和范圍。想讓 AI 快速了解你的項目是干什么的嗎？就靠它了！
• 例如：“構(gòu)建一個用于庫存管理的 React Web 應用，支持條形碼掃描功能。”

2. ??productContext.md?? (產(chǎn)品背景):

• 闡述項目為何存在，解決了什么問題，用戶體驗目標以及產(chǎn)品應如何工作。
• 例如：“該庫存系統(tǒng)需要支持多倉庫和實時更新。”

3. ??activeContext.md?? (當前活動上下文):

• 這是最常更新的文件，記錄了當前的工作焦點、最近的變更、下一步計劃、重要的決策和思考、學習到的經(jīng)驗以及項目洞察等。項目進展到哪了？AI 從這里找答案。
• 例如：“當前正在實現(xiàn)條碼掃描器組件；上一個會話完成了 API 集成。”

4. ??systemPatterns.md?? (系統(tǒng)模式):

• 記錄系統(tǒng)架構(gòu)、關鍵技術(shù)決策、正在使用的設計模式、組件關系以及關鍵的實現(xiàn)路徑等。項目代碼的“骨架”和“血脈”都在這。
• 例如：“使用 Redux 進行狀態(tài)管理，采用規(guī)范化的 store 結(jié)構(gòu)。”

5. ??techContext.md?? (技術(shù)背景):

• 列出項目中使用的技術(shù)棧（語言、框架等）、開發(fā)環(huán)境設置、技術(shù)約束、依賴項以及工具使用模式等。AI 需要知道用什么“工具”干活。
• 例如：“React 18, TypeScript, Firebase, Jest 用于測試。”

6. ??progress.md?? (項目進展):

• 跟蹤哪些功能已經(jīng)完成，哪些尚待開發(fā)，功能的當前狀態(tài)，已知的 問題和限制，以及項目決策的演變過程等。這是一個動態(tài)的項目“記事本”。
• 例如：“用戶認證已完成；庫存管理完成 80%；報告功能尚未開始。”

除了這些核心文件，還可以根據(jù)項目需要創(chuàng)建額外的文件或文件夾來組織更復雜的信息，如復雜特性文檔、API 文檔、測試策略等。

如何在 Cursor 中實踐 Memory Bank？給你的 AI 裝上“記憶引擎”！

將 Memory Bank 的理念引入 Cursor 其實并不復雜。核心步驟就是：1. 創(chuàng)建 ??memory-bank?? 文件夾。2. 在 Cursor 設置中配置好讀取和更新這些文件的規(guī)則。3. 通過聊天指令（如 ‘初始化記憶庫’）讓 Cursor 開始填充它。

具體來說：

1. 準備 Memory Bank 規(guī)則:

• 你可以參考其他 AI 工具（如 Cline）提供的 Memory Bank 自定義指令，根據(jù) Cursor 的特性和個人習慣進行調(diào)整和修改。
• 這里的核心是告訴 Cursor 兩件事：任務開始前讀哪些‘記憶’，任務過程中或結(jié)束后如何更新這些‘記憶’。例如，你可以規(guī)定，每次討論新功能時，AI 必須先查閱??projectbrief.md??? 和??systemPatterns.md??。
• 鼓勵大家積極搜索類似 "Cursor memory bank setup examples" 或 "Cursor custom rules for context" 的關鍵詞，探索社區(qū)中其他開發(fā)者的智慧和分享。

2. 配置 Cursor:

• 在 Cursor 的設置中，找到“Rules”（規(guī)則）或類似的自定義指令配置區(qū)域。
• 將準備好的 Memory Bank 規(guī)則（Markdown 格式）粘貼進去。這些規(guī)則會告訴 Cursor 如何理解和使用 Memory Bank。
• 這里給出一個極簡的示意性規(guī)則片段，幫助大家理解：

## My Project Memory Bank Rules for Cursor

**On new task/chat, ALWAYS:**
1. Read and understand `memory-bank/projectbrief.md`. This tells you the project's main goal.
2. Read and understand `memory-bank/activeContext.md`. This updates you on the current focus.
3. List the key technologies from `memory-bank/techContext.md` to ensure compatibility.

**After implementing a significant feature or making a key decision:**
1. Ask me: "Should I update `memory-bank/activeContext.md` or `memory-bank/progress.md` with these changes?"
2. If I confirm, please help me draft the update for the relevant file(s).

（免責聲明：以上規(guī)則為高度簡化示意，具體效果需在 Cursor 中實際測試和調(diào)整。實踐中大家可以參考下面的鏈接中給出的 cursor rule：https://gist.github.com/ipenywis/1bdb541c3a612dbac4a14e1e3f4341ab）

3. 初始化 Memory Bank:

• 在一個新項目或現(xiàn)有項目中，于項目根目錄創(chuàng)建一個專門存放 Memory Bank 文件的目錄（例如，名為??memory-bank/??）。
• 在與 Cursor 的聊天中，發(fā)出明確的指令，如“initialize memory bank”或“請幫我初始化項目記憶庫”。
• Cursor（在規(guī)則的指引下）會開始分析你的項目，并嘗試創(chuàng)建或填充 Memory Bank 中的各個文件。它可能會讀取??package.json?? 來了解技術(shù)依賴，分析代碼結(jié)構(gòu)來理解系統(tǒng)模式等。

4. 日常使用與維護:

• 在后續(xù)的開發(fā)中，當你與 Cursor 交流并進行代碼修改或添加新功能時，Cursor (理想情況下，并根據(jù)你的規(guī)則設置)會自動或在你提示下更新 Memory Bank 中的相關文檔，確保項目信息保持最新。
• 在開始新的開發(fā)會話或處理復雜任務時，可以提醒 Cursor "follow your custom instructions" 或 "read the memory bank" 來確保它充分利用了已有的項目上下文。

看到這里，你是否已經(jīng)躍躍欲試了呢？別急，了解了它的好處，你會更有動力！

Memory Bank 帶來的多重收益：讓開發(fā)體驗“起飛”！

采用 Memory Bank 技術(shù)，能為我們的開發(fā)工作帶來諸多好處：

1. 上下文保持 (Context Preservation): 最直接的好處，確保 AI 在不同會話間保持對項目的認知，減少重復解釋的麻煩。
2. 開發(fā)一致性 (Consistent Development): AI 基于更完整的項目理解提供建議，有助于保持代碼風格和架構(gòu)的一致性。
3. 項目自文檔化 (Self-Documenting Projects): Memory Bank 本身就是一套結(jié)構(gòu)化的項目文檔，隨著項目的推進而自動（或半自動）更新，成為項目寶貴的資產(chǎn)。
4. 可擴展性 (Scalable to Any Project): 無論是小型新項目還是大型復雜項目，Memory Bank 都能很好地適應。
5. 技術(shù)棧無關 (Technology Agnostic):Memory Bank 的核心是方法論，適用于任何編程語言或技術(shù)棧。
6. 提升 AI 效能: AI 能更準確地理解你的需求、項目的約束和設計選擇，從而生成更高質(zhì)量的代碼和建議。
7. 減少不必要的重復掃描和API調(diào)用: 由于核心上下文已經(jīng)存儲在 Memory Bank 中，AI 無需在每個新會話中都對整個項目進行地毯式掃描，從而節(jié)省時間，并可能減少對付費 AI 服務（如 Cursor）的請求次數(shù)。

總而言之，Memory Bank 就像是為你的 AI 配備了一個隨項目共同成長的知識庫！

Memory Bank 適用場景與項目階段：何時何地都能用！

• 新項目與現(xiàn)有項目皆宜: Memory Bank 既可以用于初始化一個全新的項目，幫助從一開始就建立良好的結(jié)構(gòu)化信息庫；也可以應用于已有的項目中，通過讓 AI 分析現(xiàn)有代碼庫來構(gòu)建初始的 Memory Bank。
• 項目更新與變更: Memory Bank 的設計初衷之一就是處理項目的動態(tài)變化。當項目需求變更、技術(shù)升級或代碼重構(gòu)時，應及時更新 Memory Bank 中的相關文件。理想情況下，AI 會在你的指導或其內(nèi)部規(guī)則的驅(qū)動下，協(xié)助完成這些更新，確保 Memory Bank 始終反映項目的最新狀態(tài)。

Memory Bank 與 AI 理解力的關系：強強聯(lián)合！

Memory Bank 不僅不會削弱 AI 對項目約束和設計選擇的理解，反而會顯著增強這種理解能力。

通過明確地將項目的技術(shù)棧、架構(gòu)模式、核心需求、已知問題等信息記錄在 Memory Bank 中，我們?yōu)?AI 提供了一個穩(wěn)定可靠的“事實來源”。AI 在執(zhí)行任務時，會被要求（通過自定義規(guī)則）首先查閱這些信息，從而確保其行為與項目的整體目標和約束保持一致。這遠比依賴 AI 在每個會話中臨時、片面地從代碼中推斷上下文要可靠得多。

溫馨提示與進階思考

• 維護也需用心：當然，Memory Bank 也需要我們開發(fā)者花一點心思去維護和更新，確保其準確性。但相信我，這份投入絕對物超所值。
• AI 非萬能：雖然 Memory Bank 提供了堅實的上下文基礎，但 AI 的理解仍然依賴于我們規(guī)則的清晰度和提示的準確性。把它當作一個強大的助手，而非完全的‘自動駕駛’系統(tǒng)。
• 迭代中完善：Memory Bank 的構(gòu)建和優(yōu)化是一個持續(xù)迭代的過程。隨著項目的進展，你可能會發(fā)現(xiàn)需要調(diào)整文件結(jié)構(gòu)或更新規(guī)則，這非常正常，也是不斷提升其效能的關鍵。

總結(jié)與展望：擁抱更智能的開發(fā)未來

在 AI 輔助編程日益普及的今天，如何更高效地與 AI 協(xié)作，充分發(fā)揮其潛力，是我們每一位開發(fā)者都需要思考的問題。Memory Bank 技術(shù)，以其結(jié)構(gòu)化、持久化的方式解決了 AI 在大型項目中上下文易丟失的痛點，為我們提供了一種提升 Cursor 等 AI 代碼編輯器效能的有效途徑。

雖然在 Cursor 中完美實現(xiàn)并自動化 Memory Bank 的所有流程可能還需要一些探索和規(guī)則上的調(diào)優(yōu)，但其核心理念和實踐方法已經(jīng)為我們展現(xiàn)了巨大的價值。

希望今天的分享能給大家?guī)韱l(fā)。不妨現(xiàn)在就動手，嘗試在你的 Cursor 中引入 Memory Bank 吧！讓 AI 真正成為你項目中最“懂你”的伙伴，共同打造更出色的軟件！

你是否也遇到過 AI “健忘”的困擾？你對 Memory Bank 在 Cursor 中的應用有什么看法或期待？歡迎在評論區(qū)留言交流，我們一起探討，共同進步！

參考鏈接

• ??https://gist.github.com/ipenywis/1bdb541c3a612dbac4a14e1e3f4341ab??
• ??https://docs.cline.bot/prompting/cline-memory-bank??

本文轉(zhuǎn)載自??非架構(gòu)??，作者：非架構(gòu)