# Focus Chain

焦点链是 Cline 中的任务管理增强功能，提供自动待办事项列表管理，并在整个任务中进行实时进度跟踪。

![Focus Chain todo list management with real-time progress tracking](https://storage.googleapis.com/cline_public_images/docs/assets/2dos.gif)

这使 Cline 能够处理长期任务，无缝管理发送给 LLM 的上下文，并在许多上下文窗口重置之间保持 Cline 的轨道。

焦点链与 Cline 的\[深度规划斜杠命令]\(/features/slash-commands/deep-planning)配合得特别好，为通过\[规划过程]\(/features/plan-and-act)创建的实现任务提供无缝的进度跟踪。

### 主要功能

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

Cline 分析你的任务并自动创建一个综合待办事项列表，包括：

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

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

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

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

#### 可视化进度跟踪

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

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

#### 智能提醒系统

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

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

### 开始使用

\- 点击 Cline 侧边栏中的齿轮图标 - 导航到"功能"部分 - 勾选"启用焦点链" - 可选：调整"提醒 Cline 间隔"（默认：6 条消息） - 开始一个新任务 - Cline 将自动开始创建和管理待办事项列表

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

### 使用示例

**1. 任务启动**

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

```markdown
用户："为我的 React 应用创建一个用户身份验证系统"

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

**2. 创建待办事项列表**

Cline 为任务创建综合计划，存储在 Markdown 文件中：

```markdown
- [ ] 设置项目结构
- [ ] 安装身份验证依赖项
- [ ] 创建用户注册组件
- [ ] 实现登录功能
- [ ] 添加密码验证
- [ ] 设置用户数据库架构
- [ ] 编写身份验证测试
- [ ] 部署到暂存环境
```

**3. 进度跟踪**

当 Cline 工作时，任务标题显示实时进度：

```markdown
[3/8] 实现登录功能     ⌄
```

点击展开并查看完整列表：

```markdown
✓ 设置项目结构
✓ 安装身份验证依赖项
✓ 创建用户注册组件
○ 实现登录功能  ← 当前工作
○ 添加密码验证
○ 设置用户数据库架构
○ 编写身份验证测试
○ 部署到暂存环境
```

**4. 用户编辑**

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

点击展开待办事项视图中的编辑按钮 Markdown 文件在你的编辑器中打开：

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

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

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

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

根据需要添加、删除或重新排序项目 Cline 自动检测并使用你的更新

### 文件结构

#### 待办事项列表存储

待办事项列表存储为任务目录中的 Markdown 文件：

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

#### Markdown 格式

待办事项文件使用标准 Markdown 清单语法：

```markdown
# 任务 abc123 的焦点链待办事项列表

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

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

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

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

焦点链与 Cline 的[计划/执行模式](https://github.com/HybridTalentComputing/cline-chinese/blob/main/features/plan-and-act/README.md)无缝配合：

* **计划模式**：可选的待办事项列表，用于展示具体步骤
* **执行模式**：从计划模式切换时自动创建待办事项

对于复杂项目，先在计划模式中讨论和完善你的方法，然后在准备好开始工作时切换到执行模式。

### 最佳实践

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

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

3. **在需要时编辑**
  - 添加你识别出的缺失步骤
  - 删除不必要的项目
  - 为更好的工作流重新排序步骤
  - 为通用项目添加更具体的细节
```

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

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

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

1\. \*\*分享待办事项文件\*\* - 待办事项 Markdown 文件可以与团队成员分享 - 包含在版本控制中以进行项目文档 - 用作项目规划讨论的基础

```
2. **一致的格式**
  - 遵循标准 Markdown 清单格式
  - 保持项目描述清晰且可操作
  - 在待办事项列表中使用一致的术语
```

### 故障排除

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

\- 检查设置中是否启用了焦点链 - 焦点链可能对于较小、能力较弱的模型效果不佳 - 确保任务目录中的文件权限正确 - 验证你的编辑器支持 Markdown - 检查 VSCode 对目录是否有写入权限 - 确保待办事项项目使用正确的语法（\`- \[ ]\` 和 \`- \[x]\`） - 验证 Markdown 文件格式正确

仍然卡住了？在 Cline 中使用 [/reportbug](https://github.com/HybridTalentComputing/cline-chinese/blob/main/features/slash-commands/report-bug/README.md) 命令获取帮助。

### 技术细节（供好奇者参考）

\- 实时文件监视检测待办事项 Markdown 文件的更改 - 文件编辑和 UI 更新之间的自动同步 - 优雅地处理文件创建、修改和删除 - 动态计算已完成与总待办事项项目的数量 - 支持 \`- \[x]\` 和 \`- \[X]\` 完成语法 - Unicode 符号（✓、○）用于增强的可视化显示 - 待办事项列表本地存储在 VSCode 工作区中 - 没有待办事项内容传输到外部服务 - 使用遥测（可在设置中禁用）

焦点链将 Cline 转变为你的个人项目管理器，让你保持正轨，你的任务井井有条。在你的下一个项目中试试看！