🚀 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. 使用版本控制跟踪所有变更