> ## 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 中的任务管理增强功能，提供自动待办事项列表管理和任务过程中的实时进度跟踪。

![专注链待办事项列表管理与实时进度跟踪](https://storage.googleapis.com/cline_public_images/docs/assets/2dos.gif)

这使 Cline 能够处理长期任务，无缝管理发送给 LLM 的上下文，并在多次上下文窗口重置中保持 Cline 的跟踪。

> [!TIP]
>
> 专注链与 Cline 的[深度规划斜杠命令](https://cat.mintlify.site/features/slash-commands/deep-planning.md)配合得特别好，为通过[规划过程](https://cat.mintlify.site/features/plan-and-act.md)创建的实施任务提供无缝的进度跟踪。

## 主要功能

### 自动待办事项列表生成

Cline 分析你的任务并自动创建全面的待办事项列表，包括：

* 以 markdown 检查清单格式的清晰、可操作项目
* 将复杂任务逻辑分解为可管理的步骤
* 随着工作进展的实时更新

### 用户可编辑的待办事项列表

待办事项列表存储为可编辑的 markdown 文件：

* 通过你喜欢的 markdown 编辑器直接编辑
* 自动检测你所做的更改
* 无缝集成回 Cline 的工作流程
* 通过任务标题中的编辑按钮快速访问

### 可视化进度跟踪

任务标题显示清晰的进度指示器：

* **步骤计数器**显示当前进度（例如，"3/8"）
* **已完成项目**用复选标记清楚标记
* **当前工作**用指示器突出显示
* **可展开视图**查看完整的待办事项列表

### 智能提醒系统

可配置的提醒确保待办事项列表保持最新：

* 默认每 6 条消息提醒一次（可自定义 1-100）
* 从计划模式切换到执行模式时自动提示
* 手动编辑待办事项列表时用户触发的更新

## 入门指南

**1. 打开 Cline 设置**

* 点击 Cline 侧边栏中的齿轮图标
* 导航到"功能"部分

**2. 启用专注链**

* 勾选"启用专注链"
* 可选择调整"提醒 Cline 间隔"（默认：6 条消息）

**3. 开始新任务**

* 开始新任务
* Cline 将自动开始创建和管理待办事项列表

| 设置 | 默认值 | 范围 | 描述 |
| - | - | - | - |
| 启用专注链 | 禁用 | 开/关 | 启用增强的任务进度跟踪 |
| 提醒 Cline 间隔 | 6 | 1-100 条消息 | Cline 更新待办事项列表的频率 |

## 使用示例

#### 1. 任务启动

当你在启用专注链的情况下开始新任务时：

```markdown 用户请求
用户："为我的 React 应用创建用户认证系统"

Cline：[分析请求并创建待办事项列表]
```

#### 2. 创建的待办事项列表

Cline 为任务创建全面的计划，存储在 markdown 文件中：

```markdown 创建的待办事项列表
- [ ] 设置项目结构
- [ ] 安装认证依赖项
- [ ] 创建用户注册组件
- [ ] 实现登录功能
- [ ] 添加密码验证
- [ ] 设置用户数据库模式
- [ ] 编写认证测试
- [ ] 部署到演示环境
```

#### 3. 进度跟踪

随着 Cline 的工作，任务标题显示实时进度：

```markdown 待办事项列表标题
[3/8] 实现登录功能     ⌄
```

点击展开查看完整列表：

```markdown 完整待办事项列表
✓ 设置项目结构
✓ 安装认证依赖项
✓ 创建用户注册组件
○ 实现登录功能  ← 当前工作
○ 添加密码验证
○ 设置用户数据库模式
○ 编写认证测试
○ 部署到演示环境
```

#### 4. 用户编辑

需要调整待办事项列表？没问题。

**1. 打开待办事项列表**

点击展开的待办事项视图中的编辑按钮

**2. 编辑 markdown 文件**

一个 markdown 文件在你的编辑器中打开：

```markdown 编辑待办事项列表
# 任务 abc123 的专注链待办事项列表

<!-- 编辑此 markdown 文件以更新你的专注链待办事项列表 -->
<!-- 使用 - [ ] 表示未完成项目，- [x] 表示已完成项目 -->

- [x] 设置项目结构
- [x] 安装认证依赖项（例如，Firebase Auth）
- [x] 创建用户注册组件
- [ ] 实现登录功能
- [ ] 添加密码重置功能
- [ ] 设置受保护的路由
- [ ] 实现登出功能
- [ ] 添加用户资料页面
- [ ] 编写认证测试
- [ ] 部署到演示环境

<!-- 保存此文件以更新任务的待办事项列表 -->
```

**3. 进行更改**

根据需要添加、删除或重新排序项目

**4. 保存文件**

Cline 自动检测并使用你的更新

## 文件结构

### 待办事项列表存储

待办事项列表作为 markdown 文件存储在你的任务目录中：

```markdown
<VSCode 全局存储>/
  tasks/
    <taskId>/
      focus_chain_taskid_<taskId>.md
      ... 其他任务文件
```

### Markdown 格式

待办事项文件使用标准的 markdown 检查清单语法：

```markdown 待办事项语法示例
# 任务 abc123 的专注链待办事项列表

<!-- 编辑此 markdown 文件以更新你的专注链待办事项列表 -->
<!-- 使用格式：- [ ] 表示未完成项目，- [x] 表示已完成项目 -->

- [x] 设置项目结构
- [x] 安装认证依赖项
- [ ] 创建用户注册组件
- [ ] 实现登录功能
- [ ] 添加密码验证
- [ ] 设置用户数据库模式
- [ ] 编写认证测试
- [ ] 部署到演示环境

<!-- 保存此文件，待办事项列表将在任务中更新 -->
```

## 与计划/执行模式的集成

专注链与 Cline 的[计划/执行模式](https://cat.mintlify.site/features/plan-and-act.md)无缝配合：

* **计划模式**：为呈现具体步骤提供可选的待办事项列表
* **执行模式**：从计划模式切换时自动创建待办事项

> [!TIP]
>
> 对于复杂项目，从计划模式开始讨论并完善你的方法，然后切换到执行模式进行实施。

## 最佳实践

### 有效待办事项列表

1. **从清晰的请求开始**
   * 提供详细的初始任务描述
   * 包括具体要求和约束
   * 提及任何首选技术或方法

2. **审查生成的列表**
   * 检查 Cline 的分解是否符合你的期望
   * 验证是否包含所有重要步骤
   * 确保顺序对你的项目有意义

3. **根据需要编辑**
   * 添加你识别的缺失步骤
   * 删除不必要的项目
   * 重新排序步骤以获得更好的工作流程
   * 为一般项目添加更具体的细节

### 复杂项目

1. **首先使用计划模式**
   * 在实施前讨论方法
   * 通过对话完善需求
   * 准备好开始工作时切换到执行模式

2. **分解大任务**
   * 将复杂项目拆分为更小、可管理的任务
   * 为不同组件创建单独的待办事项列表
   * 一次专注于一个主要领域

3. **定期审查**
   * 在长任务期间定期检查进度
   * 随着需求发展更新待办事项列表
   * 通过编辑将更改传达给 Cline

## 故障排除

遇到问题？尝试这些快速修复：

* **待办事项列表未更新？**
  * 检查设置中是否启用了专注链
  * 专注链可能无法与较小、能力较弱的模型很好地配合工作
  * 确保任务目录中的文件权限正确

* **无法编辑待办事项文件？**
  * 验证你的编辑器支持 markdown
  * 检查 VSCode 是否对目录具有写权限

* **进度不显示？**
  * 确保待办事项使用正确的语法（`- [ ]` 和 `- [x]`）
  * 验证 markdown 文件格式正确

仍然遇到问题？在 Cline 中使用 [/reportbug](https://cat.mintlify.site/features/slash-commands/report-bug.md) 命令获取帮助。

专注链将 Cline 变成你的个人项目经理，让你保持在正轨上并保持任务有序。在下次项目中试用一下！


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