上下文管理

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

快速参考

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

理解上下文和上下文窗口

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

上下文如何构建

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

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

关键点：Cline 不是被动的——它积极寻求理解您的项目。您可以让它探索或引导其焦点，特别是在计划模式中。

上下文和上下文窗口

将上下文想象成您和 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 通过进度条提供监控上下文窗口使用情况的可视化方式：

读取进度条

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

何时观察进度条

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

提示：通过自动压缩，Cline 现在可以自动处理长对话。当与焦点链结合时，您可以处理跨越多个上下文窗口的复杂项目而不会丢失进度。

自动上下文管理

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

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

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

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

高级上下文工具

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

深度规划（/deep-planning）

用于重大功能、重构或集成。Cline 调查您的代码库，提出有针对性的问题，然后编写 implementation_plan.md。它创建一个具有精炼、高价值上下文的新任务。了解更多关于深度规划。

新任务（/newtask）

在自然过渡点，将重要内容打包到新任务中。研究后实施的清洁状态，或队友之间的清晰移交。了解更多关于新任务。

Smol（/smol）

就地压缩对话以保持势头。在调试或探索性工作中理想，当您不想打破流程时。了解更多关于 Smol。

内存库 + .clinerules

用于非平凡项目。内存库将项目知识作为 Markdown 捕获在您的存储库中。.clinerules 是版本控制的指令，使 Cline 的行为与您的团队保持一致。了解更多关于内存库和Cline 规则。

使用上下文文件

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

上下文文件的方法

1. 常青项目上下文（内存库）

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

2. 任务特定上下文

   • 为特定实施任务创建

   • 记录需求、约束和决策

   • 示例：

     # auth-system-implementation.md
     
     ## 需求
     
     -   OAuth2 实施
     -   支持 Google 和 GitHub
     -   认证端点的速率限制
     
     ## 技术决策
     
     -   使用 Passport.js 进行提供商集成
     -   JWT 用于会话管理
     -   Redis 用于速率限制
     

3. 知识转移文档

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

有效使用上下文文件

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

实用技巧

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

额外上下文技巧

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

底线

Cline 已经为您做了很多上下文工作——焦点链、自动压缩和规划流程旨在跨长时间保持线程完整。目标是帮助 Cline 跨会话保持对您项目的一致理解。

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