Cline 内存库

Cline Memory Bank 完整指南

快速安装指南

要开始使用 Cline Memory Bank：

1. 安装或打开 Cline

2. 复制自定义说明 - 使用下面的代码块

3. 粘贴到 Cline 中 - 添加为自定义说明或添加到 .clinerules 文件中

4. Initialize - 要求 Cline “initialize memory bank”

查看详细的设置说明

Cline Memory Bank 自定义说明 [COPY THIS]

# Cline's Memory Bank

I am Cline, an expert software engineer with a unique characteristic: my memory resets completely between sessions. This isn't a limitation - it's what drives me to maintain perfect documentation. After each reset, I rely ENTIRELY on my Memory Bank to understand the project and continue work effectively. I MUST read ALL memory bank files at the start of EVERY task - this is not optional.

## Memory Bank Structure

The Memory Bank consists of core files and optional context files, all in Markdown format. Files build upon each other in a clear hierarchy:

flowchart TD
    PB[projectbrief.md] --> PC[productContext.md]
    PB --> SP[systemPatterns.md]
    PB --> TC[techContext.md]
    
    PC --> AC[activeContext.md]
    SP --> AC
    TC --> AC
    
    AC --> P[progress.md]

### Core Files (Required)
1. `projectbrief.md`
   - Foundation document that shapes all other files
   - Created at project start if it doesn't exist
   - Defines core requirements and goals
   - Source of truth for project scope

2. `productContext.md`
   - Why this project exists
   - Problems it solves
   - How it should work
   - User experience goals

3. `activeContext.md`
   - Current work focus
   - Recent changes
   - Next steps
   - Active decisions and considerations
   - Important patterns and preferences
   - Learnings and project insights

4. `systemPatterns.md`
   - System architecture
   - Key technical decisions
   - Design patterns in use
   - Component relationships
   - Critical implementation paths

5. `techContext.md`
   - Technologies used
   - Development setup
   - Technical constraints
   - Dependencies
   - Tool usage patterns

6. `progress.md`
   - What works
   - What's left to build
   - Current status
   - Known issues
   - Evolution of project decisions

### Additional Context
Create additional files/folders within memory-bank/ when they help organize:
- Complex feature documentation
- Integration specifications
- API documentation
- Testing strategies
- Deployment procedures

## Core Workflows

### Plan Mode
flowchart TD
    Start[Start] --> ReadFiles[Read Memory Bank]
    ReadFiles --> CheckFiles{Files Complete?}
    
    CheckFiles -->|No| Plan[Create Plan]
    Plan --> Document[Document in Chat]
    
    CheckFiles -->|Yes| Verify[Verify Context]
    Verify --> Strategy[Develop Strategy]
    Strategy --> Present[Present Approach]

### Act Mode
flowchart TD
    Start[Start] --> Context[Check Memory Bank]
    Context --> Update[Update Documentation]
    Update --> Execute[Execute Task]
    Execute --> Document[Document Changes]

## Documentation Updates

Memory Bank updates occur when:
1. Discovering new project patterns
2. After implementing significant changes
3. When user requests with **update memory bank** (MUST review ALL files)
4. When context needs clarification

flowchart TD
    Start[Update Process]
    
    subgraph Process
        P1[Review ALL Files]
        P2[Document Current State]
        P3[Clarify Next Steps]
        P4[Document Insights & Patterns]
        
        P1 --> P2 --> P3 --> P4
    end
    
    Start --> Process

Note: When triggered by **update memory bank**, I MUST review every memory bank file, even if some don't require updates. Focus particularly on activeContext.md and progress.md as they track current state.

REMEMBER: After every memory reset, I begin completely fresh. The Memory Bank is my onl

什么是 Cline 内存库？

Memory Bank 是一个结构化的文档系统，允许 Cline 在会话中维护上下文。它将 Cline 从无状态助手转变为持久的开发合作伙伴，随着时间的推移可以有效地“记住”您的项目细节。

Key Benefits 主要优点

• 上下文保留 ：在会话中维护项目知识

• 持续开发 ：体验与 Cline 的可预测交互

• 自文档化项目 ：创建有价值的项目文档作为副作用

• 可扩展至任何项目 ：适用于任何规模或复杂程度的项目

• 技术不可知 ：具有任何技术堆栈或语言的函数

内存库的工作原理

内存库不是特定于 Cline 的功能，而是一种通过结构化文档管理 AI 上下文的方法。当您指示 Cline “遵循自定义说明”时，它会读取 Memory Bank 文件以重建它对项目的理解。

Understanding the Files 了解文件

Memory Bank 文件只是您在项目中创建的 markdown 文件。它们不是隐藏文件或特殊文件 - 只是存储在存储库中的常规文档，您和 Cline 都可以访问。

文件以分层结构进行组织，从而构建了项目的完整图景：

内存库文件解释

Core Files 核心文件

1. projectbrief.md

   • 项目的基础

   • 您正在构建的内容的高级概述

   • 核心要求和目标

   • 示例：“使用条形码扫描构建用于库存管理的 React Web 应用程序”

2. productContext.md

   • 解释项目存在的原因

   • 描述正在解决的问题

   • 概述产品应如何运作

   • 示例： “库存系统需要支持多个仓库和实时更新”

3. activeContext.md

   • 更新最频繁的文件

   • 包含当前工作重点和最近的更改

   • 跟踪主动决策和注意事项

   • 存储重要的模式和学习

   • 示例：“当前正在实施条形码扫描仪组件;上次会话已完成 API 集成”

4. systemPatterns.md

   • 记录系统架构

   • 记录关键技术决策

   • 列出正在使用的设计模式

   • 解释组件关系

   • 示例： “使用 Redux 进行具有规范化 store 结构的 state management”

5. techContext.md

   • 列出使用的技术和框架

   • 描述开发设置

   • Notes 技术限制

   • 记录依赖关系和工具配置

   • 示例： “React 18， TypeScript， Firebase， Jest for testing”

6. progress.md

   • 跟踪哪些有效，哪些需要构建

   • 记录要素的当前状态

   • 列出已知问题和限制

   • 记录项目决策的演变

   • 示例：“用户身份验证完成;库存管理 80% 完成;报告未开始”

Additional Context 其他上下文 在需要时创建其他文件以进行组织：

• 复杂的功能文档

• 集成规范

• API 文档

• 测试策略

• 部署过程

Memory Bank 入门

First-Time Setup 首次设置

1. 在项目根目录中创建一个 memory-bank/ 文件夹

2. 准备好基本的项目简介（可以是技术性的或非技术性的）

3. 要求 Cline “initialize memory bank”

项目简介提示

• 从简单开始 - 它可以是您喜欢的详细或高级

• 专注于对您最重要的事情

• Cline 将帮助填补空白并提出问题

• 您可以随着项目的发展而更新它

使用 Cline

Core Workflows 核心工作流

Plan Mode 计划模式 从此模式开始进行战略讨论和高级规划。

Act Mode 行动模式 用于实施和执行特定任务。

键盘命令

• “follow your custom instructions” - 这会告诉 Cline 读取 Memory Bank 文件并从您上次中断的地方继续（在任务开始时使用它）

• “initialize memory bank” - 在启动新项目时使用

• “update memory bank” - 在任务期间触发完整的文档审查和更新

• 根据您当前的需求切换计划/行动模式

文档更新

在以下情况下，应自动进行内存库更新：

1. 您在项目中发现新模式

2. 实施重大更改后

3. 当您使用 “update memory bank” 明确请求时

4. 当您觉得上下文需要澄清时

常见问题解答

内存库文件存储在哪里？

Memory Bank 文件是存储在项目存储库中的常规 Markdown 文件，通常位于 memory-bank/ 文件夹中。它们不是隐藏的系统文件 - 它们旨在成为项目文档的一部分。

我应该使用自定义指令还是 .clinerules？

两种方法都有效 - 它基于您的偏好：

• 自定义说明 ：全局应用于所有 Cline 对话。适合在所有项目中保持一致的行为。

• .clinerules 文件 ：特定于项目并存储在您的存储库中。适合按项目自定义。

两种方法都实现了相同的目标 - 选择取决于您是希望 Memory Bank 系统的全球应用还是本地应用。

管理上下文窗口

当您使用 Cline 时，您的上下文窗口最终会填满（注意进度条）。当您注意到 Cline 的回复速度变慢或对对话前面部分的引用变得不准确时，是时候：

1. 要求 Cline “update memory bank” 以记录当前状态

2. 开始新的对话/任务

3. 让 Cline 在新对话中“按照您的自定义说明”

此工作流程可确保在清除上下文窗口之前将重要上下文保留在 Memory Bank 文件中，从而使您能够无缝地继续新的对话。

此工作流程可确保在清除上下文窗口之前将重要上下文保留在 Memory Bank 文件中，从而使您能够无缝地继续新的对话。

我应该多久更新一次内存条？

在重要的里程碑或方向发生变化后更新 Memory Bank。对于积极开发，每隔几次会话更新一次可能会有所帮助。当您想要确保保留所有上下文时，请使用 “update memory bank” 命令。但是，您会注意到 Cline 也会自动更新 Memory Bank。

这是否适用于 Cline 以外的其他 AI 工具？

是的！Memory Bank 概念是一种文档方法，可以与任何可以读取文档文件的 AI 助手一起使用。具体命令可能有所不同，但维护上下文的结构化方法适用于各种工具。

内存库与上下文窗口限制有何关系？

Memory Bank 通过以结构化格式存储重要信息来帮助管理上下文限制，该格式可以在需要时有效加载。这可以防止上下文膨胀，同时确保关键信息可用。

内存条概念可以用于非编码项目吗？

绝对！Memory Bank 方法适用于任何受益于结构化文档的项目 - 从写书到规划活动。文件结构可能会有所不同，但这个概念仍然很强大。

这与使用 README 文件有什么不同吗？

虽然在概念上相似，但 Memory Bank 提供了一种更结构化和更全面的方法，专门用于维护 AI 会话中的上下文。它超出了单个 README 通常涵盖的内容。

最佳实践

开始

• 从基本的项目简介开始，让结构不断发展

• 让 Cline 帮助创建初始结构

• 根据需要查看和调整文件以匹配您的工作流程

Ongoing Work 正在进行的工作

• 让模式在工作时自然出现

• 不要强制文档更新 - 它们应该有机地进行

• 信任过程 - 价值会随着时间的推移而复合

• 在会话开始时观察上下文确认

文档流程

• projectbrief.md 是您的基础

• activeContext.md 更改最频繁

• progress.md 跟踪您的里程碑

• 所有文件共同维护项目智能

详细的设置说明

对于自定义说明（全球）

1. 打开 VSCode

2. 单击 Cline 扩展设置 ⚙️

3. 查找“自定义说明”

4. 从本指南顶部复制并粘贴完整的 Memory Bank 说明

对于 .clinerules （特定于项目）

1. 在项目根目录中创建 .clinerules 文件

2. 从本指南顶部复制并粘贴 Memory Bank 说明

3. 保存文件

4. Cline 在此项目中工作时将自动应用这些规则

记得

The Memory Bank 是 Cline 与以前作品的唯一链接。它的有效性完全取决于在每次交互中保持清晰、准确的文档并确认上下文保留。

有关更多信息，请参阅我们在 Cline Memory Bank 上的博客

为 Cline Memory Bank 做出贡献

本指南由 Cline 和 Cline Discord 社区维护：

• 尼克鲍曼98

• 克里洛

• 狙击手

---

Memory Bank 方法是一种开放式的 AI 上下文管理方法，可以适应不同的工具和工作流程。