跳过主要内容
快速参考
  • 上下文 = Cline了解到的关于您项目的所有信息
  • 上下文窗口 = Cline一次可以处理的最大信息量(因模型而异)
  • Token = 文本测量单位(约等于3/4个英文单词)
  • 自动管理 = Cline通过焦点链和自动压缩自动处理上下文

什么是上下文管理?

上下文管理是Cline在整个对话过程中保持对您项目理解的方式。将其视为您与Cline之间的共享内存——包含代码、决策、需求和进度。
Context visualization showing the relationship between total context and context window

上下文就像一个共享的工作空间,Cline在此基础上构建对您项目的理解

上下文的三个层次

  1. 即时上下文 - 当前对话和活动文件
  2. 项目上下文 - 您的代码库、结构和模式
  3. 持久上下文 - 记忆库、.clinerules 和文档

理解上下文窗口

每个AI模型都有一个上下文窗口——它在单次对话中可以处理的最大信息量。这是用token来衡量的

按模型的Token限制

模型上下文窗口有效限制*最适合
Claude 3.5 Sonnet200,000 token150,000 token复杂任务,大型代码库
Claude 3.5 Haiku200,000 token150,000 token更快的响应,更简单的任务
GPT-4o128,000 token100,000 token通用开发
Gemini 2.0 Flash1,000,000+ token400,000 token超大上下文
DeepSeek v364,000 token50,000 token高性价比编码
Qwen 2.5 Coder128,000 token100,000 token专业编码任务
*有效限制约为最大值的75-80%,以实现最佳性能
Token计算简化
  • 1 token ≈ 3/4个英文单词
  • 100 token ≈ 75个单词 ≈ 3-5行代码
  • 10,000 token ≈ 7,500个单词 ≈ ~15页文本
  • 一个典型的源文件:500-2,000 token

Cline如何构建上下文

构建有效的上下文是使Cline真正有用的原因。当您开始一项任务时,Cline不会被动地等待信息——他会主动收集关于您项目的上下文,在需要时提出澄清问题,并实时适应正在发生的事情。这种自动发现、用户引导和动态适应的结合确保Cline始终拥有正确的信息来有效地解决您的问题。

1. 自动上下文收集

当您开始一项任务时,Cline会主动 Cline自动发现的内容
  • 项目结构和文件组织
  • 导入关系和依赖项
  • 代码模式和约定
  • 配置文件和设置
  • 近期更改和git历史记录(使用@git时)

2. 用户引导的上下文

虽然自动发现处理了大部分工作,但您可以控制Cline关注的重点。您提供的上下文越具体和相关,Cline就越能理解您的需求并提供准确的解决方案。 您可以通过以下方式增强上下文:
  • @提及 文件、文件夹或URL
  • 以自然语言提供需求
  • 分享截图以提供UI上下文
  • 通过.clinerules或记忆库添加文档
  • 当Cline需要澄清时回答问题

3. 动态上下文适应

Cline在整个对话过程中动态调整上下文。它会考虑您的请求的复杂性、可用的上下文窗口空间、当前任务进度、错误消息和反馈,以及对话期间做出的先前决策,以确定在每个步骤中最重要y的信息。

上下文窗口进度条

实时监控您的上下文使用情况
Context window progress bar showing token usage

上下文窗口栏显示输入/输出token使用情况

理解指示器

  • ⬆️ 输入Token: 发送给模型的信息(您的消息 + 上下文)
  • ⬇️ 输出Token: 模型的响应和生成的代码
  • ➡️ 缓存Token: 重复使用的先前处理的token(降低成本并提高速度)
  • 进度条: 使用情况的视觉表示
  • 百分比: 占总容量的当前使用量

自动上下文管理功能

Cline包含智能系统,为您处理上下文

焦点链(默认:开启)

焦点链通过自动待办事项列表保持任务连续性。当您开始一项任务时,Cline会生成可操作的步骤,并随着工作的进展进行更新。这使得即使在自动压缩运行后,关键上下文仍然可见,让您无需滚动浏览整个对话即可跟踪进度。 了解更多 →

自动压缩(始终开启)

当上下文使用率达到80%左右时,自动压缩会自动创建对话的全面摘要。这保留了所有决策和代码更改,同时腾出空间继续工作。当这种情况发生时,您会看到一条消息。任务会无缝继续——您无需进行任何操作。 了解更多 →

上下文截断系统

如果您的对话在自动压缩运行前接近模型的上下文窗口限制,Cline的上下文管理器会自动截断对话中较旧的部分以防止错误。 系统会优先考虑最重要y的内容:
  • 您的原始任务描述保留不变
  • 最近的工具执行及其结果保持完整
  • 当前代码状态和活动错误得到保留
  • 用户与助手消息的逻辑流程得以维持
首先被删除的内容
  • 任务早期多余的对话历史记录
  • 不再相关的已完成工具输出
  • 中间的调试步骤
  • 已完成其目的的冗长解释
这会自动发生。您将继续工作而不中断,并且Cline会保持足够的上下文来有效地继续解决您的问题。

最佳实践

  • 具体明确 - 清晰的目标有助于Cline理解您的需求
  • 策略性地使用@提及 - 引用特定文件而不是整个文件夹
  • 监控进度条 - 黄色/红色表示考虑使用/smol/newtask
  • 信任自动管理 - 焦点链和自动压缩会自动处理复杂性
  • 使用记忆库 - 记录持久的模式和约定

后续步骤