快速参考
- 上下文 = Cline了解到的关于您项目的所有信息
- 上下文窗口 = Cline一次可以处理的最大信息量(因模型而异)
- Token = 文本测量单位(约等于3/4个英文单词)
- 自动管理 = Cline通过焦点链和自动压缩自动处理上下文
什么是上下文管理?
上下文管理是Cline在整个对话过程中保持对您项目理解的方式。将其视为您与Cline之间的共享内存——包含代码、决策、需求和进度。.png)
上下文就像一个共享的工作空间,Cline在此基础上构建对您项目的理解
上下文的三个层次
- 即时上下文 - 当前对话和活动文件
- 项目上下文 - 您的代码库、结构和模式
- 持久上下文 - 记忆库、.clinerules 和文档
理解上下文窗口
每个AI模型都有一个上下文窗口——它在单次对话中可以处理的最大信息量。这是用token来衡量的按模型的Token限制
| 模型 | 上下文窗口 | 有效限制* | 最适合 |
|---|---|---|---|
| Claude 3.5 Sonnet | 200,000 token | 150,000 token | 复杂任务,大型代码库 |
| Claude 3.5 Haiku | 200,000 token | 150,000 token | 更快的响应,更简单的任务 |
| GPT-4o | 128,000 token | 100,000 token | 通用开发 |
| Gemini 2.0 Flash | 1,000,000+ token | 400,000 token | 超大上下文 |
| DeepSeek v3 | 64,000 token | 50,000 token | 高性价比编码 |
| Qwen 2.5 Coder | 128,000 token | 100,000 token | 专业编码任务 |
Cline如何构建上下文
构建有效的上下文是使Cline真正有用的原因。当您开始一项任务时,Cline不会被动地等待信息——他会主动收集关于您项目的上下文,在需要时提出澄清问题,并实时适应正在发生的事情。这种自动发现、用户引导和动态适应的结合确保Cline始终拥有正确的信息来有效地解决您的问题。1. 自动上下文收集
当您开始一项任务时,Cline会主动 Cline自动发现的内容- 项目结构和文件组织
- 导入关系和依赖项
- 代码模式和约定
- 配置文件和设置
- 近期更改和git历史记录(使用@git时)
2. 用户引导的上下文
虽然自动发现处理了大部分工作,但您可以控制Cline关注的重点。您提供的上下文越具体和相关,Cline就越能理解您的需求并提供准确的解决方案。 您可以通过以下方式增强上下文:- @提及 文件、文件夹或URL
- 以自然语言提供需求
- 分享截图以提供UI上下文
- 通过.clinerules或记忆库添加文档
- 当Cline需要澄清时回答问题
3. 动态上下文适应
Cline在整个对话过程中动态调整上下文。它会考虑您的请求的复杂性、可用的上下文窗口空间、当前任务进度、错误消息和反馈,以及对话期间做出的先前决策,以确定在每个步骤中最重要y的信息。上下文窗口进度条
实时监控您的上下文使用情况
上下文窗口栏显示输入/输出token使用情况
理解指示器
- ⬆️ 输入Token: 发送给模型的信息(您的消息 + 上下文)
- ⬇️ 输出Token: 模型的响应和生成的代码
- ➡️ 缓存Token: 重复使用的先前处理的token(降低成本并提高速度)
- 进度条: 使用情况的视觉表示
- 百分比: 占总容量的当前使用量
自动上下文管理功能
Cline包含智能系统,为您处理上下文焦点链(默认:开启)
焦点链通过自动待办事项列表保持任务连续性。当您开始一项任务时,Cline会生成可操作的步骤,并随着工作的进展进行更新。这使得即使在自动压缩运行后,关键上下文仍然可见,让您无需滚动浏览整个对话即可跟踪进度。 了解更多 →自动压缩(始终开启)
当上下文使用率达到80%左右时,自动压缩会自动创建对话的全面摘要。这保留了所有决策和代码更改,同时腾出空间继续工作。当这种情况发生时,您会看到一条消息。任务会无缝继续——您无需进行任何操作。 了解更多 →上下文截断系统
如果您的对话在自动压缩运行前接近模型的上下文窗口限制,Cline的上下文管理器会自动截断对话中较旧的部分以防止错误。 系统会优先考虑最重要y的内容:- 您的原始任务描述保留不变
- 最近的工具执行及其结果保持完整
- 当前代码状态和活动错误得到保留
- 用户与助手消息的逻辑流程得以维持
- 任务早期多余的对话历史记录
- 不再相关的已完成工具输出
- 中间的调试步骤
- 已完成其目的的冗长解释
最佳实践
- 具体明确 - 清晰的目标有助于Cline理解您的需求
- 策略性地使用@提及 - 引用特定文件而不是整个文件夹
- 监控进度条 - 黄色/红色表示考虑使用
/smol或/newtask - 信任自动管理 - 焦点链和自动压缩会自动处理复杂性
- 使用记忆库 - 记录持久的模式和约定

