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

AI 代碼編輯時(shí)代，大型項(xiàng)目開(kāi)發(fā)的“痛點(diǎn)”你中招了嗎？

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

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

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

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

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

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

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

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

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

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

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

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

1. ??projectbrief.md?? (項(xiàng)目簡(jiǎn)介):

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

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

• 闡述項(xiàng)目為何存在，解決了什么問(wèn)題，用戶體驗(yàn)?zāi)繕?biāo)以及產(chǎn)品應(yīng)如何工作。
• 例如：“該庫(kù)存系統(tǒng)需要支持多倉(cāng)庫(kù)和實(shí)時(shí)更新。”

3. ??activeContext.md?? (當(dāng)前活動(dòng)上下文):

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

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

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

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

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

6. ??progress.md?? (項(xiàng)目進(jìn)展):

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

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

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

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

具體來(lái)說(shuō)：

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

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

2. 配置 Cursor:

• 在 Cursor 的設(shè)置中，找到“Rules”（規(guī)則）或類似的自定義指令配置區(qū)域。
• 將準(zhǔn)備好的 Memory Bank 規(guī)則（Markdown 格式）粘貼進(jìn)去。這些規(guī)則會(huì)告訴 Cursor 如何理解和使用 Memory Bank。
• 這里給出一個(gè)極簡(jiǎn)的示意性規(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).

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

3. 初始化 Memory Bank:

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

4. 日常使用與維護(hù):

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

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

Memory Bank 帶來(lái)的多重收益：讓開(kāi)發(fā)體驗(yàn)“起飛”！

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

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

總而言之，Memory Bank 就像是為你的 AI 配備了一個(gè)隨項(xiàng)目共同成長(zhǎng)的知識(shí)庫(kù)！

Memory Bank 適用場(chǎng)景與項(xiàng)目階段：何時(shí)何地都能用！

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

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

Memory Bank 不僅不會(huì)削弱 AI 對(duì)項(xiàng)目約束和設(shè)計(jì)選擇的理解，反而會(huì)顯著增強(qiáng)這種理解能力。

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

溫馨提示與進(jìn)階思考

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

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

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

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

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

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

參考鏈接

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

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