Cline Memory Bank

🚀 Cline記憶銀行集成指南

Cline記憶銀行是一個集中存儲和管理項目上下文信息的工具，能跟蹤開發會話信息、記錄項目進展、保存技術決策等，可提高開發效率、增強代碼可維護性、降低知識流失風險並改善團隊協作。

📦 安裝指南

在項目根目錄運行以下命令初始化記憶銀行：

use_mcp_tool('memory-bank', 'initialize_memory_bank', {
  projectPath: process.cwd()
});

文件結構如下：

your-project/
├── memory-bank/
│   ├── activeContext.md      # 當前上下文文件
│   ├── progress.md           # 進度跟蹤文件
│   ├── decisionLog.md       # 決策日誌文件
│   └── projectContext.md    # 項目上下文文件

💻 使用示例

基礎用法

初始化新記憶銀行

use_mcp_tool('memory-bank', 'initialize_memory_bank', {
  projectPath: process.cwd()  // 或指定路徑
});

訪問項目上下文

access_mcp_resource('memory-bank', 'memory://project/context');

高級用法

更新當前上下文

use_mcp_tool('memory-bank', 'update_context', {
  projectPath: process.cwd(),
  content: {
    currentSession: {
      date: new Date().toISOString().split('T')[0],
      mode: 'development',
      task: '當前任務描述'
    }
  }
});

記錄技術決策

use_mcp_tool('memory-bank', 'record_decision', {
  projectPath: process.cwd(),
  decision: {
    title: '決策標題',
    description: '決定的內容',
    rationale: '決定的理由'
  }
});

📚 詳細文檔

文件結構

初始化後，記憶銀行在項目根目錄下創建以下文件結構：

graph LR
    根目錄[項目根目錄] --> 銀行[memory-bank]
    銀行 --> PC[projectContext.md]
    銀行 --> AC[activeContext.md]
    銀行 --> P[progress.md]
    銀行 --> DL[decisionLog.md]
    PC --> Stack[技術棧]
    AC --> Tasks[活動任務]
    P --> Status[項目狀態]
    DL --> History[決策歷史]

初始文件內容

1. activeContext.md：
   • 當前會話信息（日期、模式、任務）
   • 開放問題
   • 最新更新部分
2. progress.md：
   • 當前階段（初始化階段）
   • 已完成任務
   • 進行中任務
   • 阻礙跟蹤
3. decisionLog.md：
   • 項目結構決策
   • 開發流程選擇
   • 文檔策略決策
   • 待決事項部分
4. projectContext.md：
   • 項目概述和版本信息
   • 技術棧和依賴項
   • 配置文件列表
   • 架構原則
   • 開發設置指南
   • 項目工作流程規範

使用Cline集成

工作流程圖

graph LR
    Start[開始] --> Init[初始化]
    Init --> Context[加載上下文]
    Context --> Update[進行更改]
    Update --> Progress[跟蹤進度]
    Progress --> Record[記錄決策]
    Record --> Sync[自動同步]
    Sync --> Context

開發

修改或增強服務器：

1. 進入Cline項目目錄
2. 安裝依賴：

npm install

3. 啟動開發服務器：

npm run dev

貢獻指南

1. Fork此倉庫到你的賬戶
2. 在你自己的倉庫中創建新分支：

git checkout -b feature/your-feature-name

3. 提交代碼更改：

git add .
git commit -m "添加功能：你的提交信息"

4. 將分支推送到遠程倉庫：

git push origin feature/your-feature-name

5. 創建Pull Request到主分支

系統提示

在代碼編輯器中，將以下內容粘貼到src/memory-bank.ts文件中：

export function initializeMemoryBank(projectPath: string): void {
  // 初始化邏輯
}

export function updateContext(content: any): void {
  // 更新上下文邏輯
}

🔧 技術細節

記憶銀行功能

核心特性

1. 上下文管理：跟蹤當前開發會話的信息
2. 進度跟蹤：記錄項目進展狀態
3. 決策日誌：保存重要技術決策
4. 項目配置：維護項目基礎信息和架構原則

主要優勢

• 提高開發效率
• 增強代碼可維護性
• 降低知識流失風險
• 改善團隊協作

最佳實踐

1. 每次提交前更新上下文文件
2. 定期審查決策日誌
3. 在項目文檔中引用相關記錄
4. 使用版本控制跟蹤所有變更