> ## Documentation Index
> Fetch the complete documentation index at: https://cat.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 上下文管理

> 上下文是充分利用 Cline 的关键

> **快速参考**
>
> * 上下文 = Cline 了解您项目的信息
> * 上下文窗口 = Cline 一次可以保持的信息量
> * 使用上下文文件维护项目知识
> * 当上下文窗口满时重置

## 理解上下文和上下文窗口

![在无限上下文的世界中，上下文窗口是 Cline 当前可用的内容](https://storage.googleapis.com/cline_public_images/docs/assets/image%20\(2\).png)

在无限上下文的世界中，上下文窗口是 Cline 当前可用的内容

将与 Cline 合作看作与一个彻底、积极主动的队友协作：

### 上下文如何构建

Cline 通过两种方式积极构建上下文：

1. **自动上下文收集（即 Cline 驱动）**
   * 主动读取相关文件
   * 探索项目结构
   * 分析模式和关系
   * 映射依赖关系和导入
   * 提出澄清问题
2. **用户引导的上下文**
   * 分享特定文件
   * 提供文档
   * 回答 Cline 的问题
   * 引导焦点区域
   * 分享设计思路和需求

**关键点**：Cline 不是被动的——它积极寻求理解您的项目。您可以让它探索或引导其焦点，特别是在[计划模式](https://cat.mintlify.site/features/plan-and-act.md)中。

### 上下文和上下文窗口

将上下文想象成您和 Cline 共享的白板：

* **上下文** 是所有可用信息：
  * Cline 发现的内容
  * 您分享的内容
  * 您的对话历史
  * 项目需求
  * 以前的决定
* **上下文窗口** 是白板本身的大小：
  * 以令牌衡量（1 令牌 ≈ 3/4 个英文单词）
  * 每个模型都有固定大小：
    * Claude Sonnet 4：1,000,000 令牌
    * Qwen3 Coder：256,000 令牌
    * Gemini 2.5 Pro：1,000,000+ 令牌
    * GPT-5：400,000 令牌
  * 当白板满时，Cline 自动总结对话以释放空间

**重要**：拥有大的上下文窗口并不意味着您应该完全填满它。模型在 400-500K 令牌左右开始降级，即使它们声称有更高的限制。就像杂乱的白板一样，太多信息可能使专注于重要内容变得更加困难。

## 理解上下文窗口进度条

Cline 通过进度条提供监控上下文窗口使用情况的可视化方式：

![上下文窗口进度条](https://storage.googleapis.com/cline_public_images/docs/assets/image%20\(1\)%20\(1\).png)

上下文窗口使用情况的可视化表示

### 读取进度条

* ↑ 显示输入令牌（您发送给 LLM 的内容）
* ↓ 显示输出令牌（LLM 生成的内容）
* 进度条可视化您已使用的上下文窗口百分比
* 总数显示您模型的最大容量（例如，Claude Sonnet 4 为 1M）

### 何时观察进度条

* 在长编程会话期间
* 处理多个文件时
* 开始复杂任务之前
* 当 Cline 似乎失去上下文时

**提示**：通过[自动压缩](https://cat.mintlify.site/features/auto-compact.md)，Cline 现在可以自动处理长对话。当与[焦点链](https://cat.mintlify.site/features/focus-chain.md)结合时，您可以处理跨越多个上下文窗口的复杂项目而不会丢失进度。

## 自动上下文管理

Cline 包含智能功能来自动管理上下文：

### 您应该保持开启的默认设置

**焦点链** - 在 v3.25 中默认启用。Cline 在任务开始时生成待办事项列表并将其保持在上下文中，这样线程不会偏离。您可以编辑 markdown 来添加或重新排序步骤，Cline 会适应。[了解更多关于焦点链](https://cat.mintlify.site/features/focus-chain.md)。

**自动压缩** - 始终开启。当上下文窗口接近其限制时，Cline 创建全面总结，替换臃肿的历史，并从停止的地方继续。决策、代码更改和状态都得到保留。[了解更多关于自动压缩](https://cat.mintlify.site/features/auto-compact.md)。

## 高级上下文工具

当您需要更多上下文管理控制时：

### 深度规划（`/deep-planning`）

用于重大功能、重构或集成。Cline 调查您的代码库，提出有针对性的问题，然后编写 `implementation_plan.md`。它创建一个具有精炼、高价值上下文的新任务。[了解更多关于深度规划](https://cat.mintlify.site/features/slash-commands/deep-planning.md)。

### 新任务（`/newtask`）

在自然过渡点，将重要内容打包到新任务中。研究后实施的清洁状态，或队友之间的清晰移交。[了解更多关于新任务](https://cat.mintlify.site/features/slash-commands/new-task.md)。

### Smol（`/smol`）

就地压缩对话以保持势头。在调试或探索性工作中理想，当您不想打破流程时。[了解更多关于 Smol](https://cat.mintlify.site/features/slash-commands/smol.md)。

### 内存库 + .clinerules

用于非平凡项目。内存库将项目知识作为 Markdown 捕获在您的存储库中。`.clinerules` 是版本控制的指令，使 Cline 的行为与您的团队保持一致。[了解更多关于内存库](https://cat.mintlify.site/prompting/cline-memory-bank.md)和[Cline 规则](https://cat.mintlify.site/features/cline-rules.md)。

## 使用上下文文件

上下文文件帮助跨会话维护理解。它们作为专门设计来帮助 AI 助手理解您项目的文档。

#### 上下文文件的方法

1. **常青项目上下文（内存库）**
   * 与您的项目一起演变的活文档
   * 随着架构和模式出现而更新
   * 示例：内存库模式维护如 `techContext.md` 和 `systemPatterns.md` 的文件
   * 对长期项目和团队有用

2. **任务特定上下文**

   * 为特定实施任务创建
   * 记录需求、约束和决策
   * 示例：

     ```markdown
     # auth-system-implementation.md

     ## 需求

     -   OAuth2 实施
     -   支持 Google 和 GitHub
     -   认证端点的速率限制

     ## 技术决策

     -   使用 Passport.js 进行提供商集成
     -   JWT 用于会话管理
     -   Redis 用于速率限制
     ```

3. **知识转移文档**
   * 切换到计划模式，要求 Cline 记录您到目前为止完成的所有工作，以及剩余步骤，在 markdown 文件中。
   * 复制 markdown 文件的内容。
   * 使用该内容作为上下文开始新任务。

#### 有效使用上下文文件

1. **结构和格式**
   * 使用清晰、一致的组织
   * 包含相关示例
   * 链接相关概念
   * 保持信息聚焦
2. **维护**
   * 重大更改后更新
   * 版本控制您的上下文文件
   * 删除过时信息
   * 记录关键决策

## 实用技巧

1. **开始新项目**
   * 让 Cline 探索代码库
   * 回答关于结构和模式的问题
   * 考虑设置基本上下文文件
   * 记录关键设计决策
2. **持续开发**
   * 使用重大更改更新上下文文件
   * 分享相关文档
   * 对复杂讨论使用计划模式
   * 在需要时开始新会话
3. **团队项目**
   * 分享常见上下文文件（考虑在项目根目录中使用[.clinerules](https://cat.mintlify.site/features/cline-rules.md)文件）
   * 记录架构决策
   * 维护一致的模式
   * 保持文档最新

## 额外上下文技巧

* 您可以 @ 链接并将网页上下文添加到 Cline（文档、博客等）
* 利用 MCP 服务器从外部知识库拉取上下文
* 屏幕截图可以用作支持图像输入的模型的上下文

## 底线

Cline 已经为您做了很多上下文工作——[焦点链](https://cat.mintlify.site/features/focus-chain.md)、[自动压缩](https://cat.mintlify.site/features/auto-compact.md)和规划流程旨在跨长时间保持线程完整。目标是帮助 Cline 跨会话保持对您项目的一致理解。

记住：目标是在每一步都只保持重要内容在视野中。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.