跳到主要内容

在 Cursor 中使用后台代理实现自动化

Cursor Background Agents

Cursor 1.0 引入了后台代理——一项强大的功能，允许 AI 代理在后台运行任务，而不会阻塞你的 IDE。本指南涵盖如何设置、管理和利用后台代理以实现最大生产力。

什么是后台代理？​

后台代理支持：

  • 长时间运行的任务——在你处理其他事务时继续运行
  • 并行处理——多个独立任务同时执行
  • 异步操作——如测试、构建和分析
  • 定时任务——在特定时间运行

前提条件​

  • Cursor 版本 1.0 或更新
  • Pro 或更高套餐（后台代理可能需要付费套餐）
  • 具有可独立运行任务的项目

启动后台代理​

方法 1：上下文菜单​

  1. 打开 Composer（Cmd/Ctrl + I）
  2. 输入你的任务描述
  3. 点击 ... 菜单（更多操作）
  4. 选择 在后台运行

方法 2：命令​

@background 分析整个代码库的安全漏洞并报告发现。

方法 3：键盘快捷键​

  1. 编写你的任务
  2. 按下 Cmd/Ctrl + Shift + B（如果已配置）
  3. 代理在后台启动

后台代理使用场景​

1. 代码库分析​

[后台] 扫描整个代码库并：
1. 查找所有 TODO 注释
2. 识别已弃用的 API 使用
3. 列出没有测试覆盖的文件
4. 检测潜在的内存泄漏
5. 报告代码重复

完成后提供摘要报告。

2. 测试执行​

[后台] 运行完整的测试套件：
1. 执行所有单元测试
2. 运行集成测试
3. 生成覆盖率报告
4. 将结果保存到 test-results/

完成后通知我，并附带通过/失败摘要。

3. 文档生成​

[后台] 生成 API 文档：
1. 扫描 src/ 中的所有公共函数/类
2. 在缺失处创建 JSDoc/docstring
3. 在 docs/api/ 中生成 markdown 文档
4. 创建导航索引

使用 src/utils/helpers.ts 中的现有风格。

4. 大规模代码库重构​

[后台] 重构错误处理：
1. 查找所有 try/catch 块
2. 标准化错误消息
3. 添加结构化错误日志
4. 创建自定义错误类

在整个代码库中应用更改。

管理后台代理​

查看活跃代理​

  1. 打开后台代理面板：

    • 视图 > 外观 > 显示后台代理
    • 或使用侧边栏图标

  2. 查看所有正在运行的代理：

    • 任务描述
    • 开始时间
    • 当前状态
    • 进度指示器

代理状态​

状态描述操作
运行中代理正在积极工作监控进度
已暂停代理被手动暂停恢复或取消
已完成任务成功完成查看结果
失败任务遇到错误查看日志
已取消任务被用户停止如有需要则重启

控制代理​

# 暂停代理
cursor agent:pause <agent-id>

# 恢复代理
cursor agent:resume <agent-id>

# 取消代理
cursor agent:cancel <agent-id>

# 查看代理日志
cursor agent:logs <agent-id>

代理输出和结果​

结果类型​

  1. 文件更改：代理修改了文件

    • 在源代码控制面板中审查
    • 提交前查看差异

  2. 报告：生成的摘要

    • 保存到指定位置
    • 或在通知面板中显示

  3. 通知：状态更新

    • 完成时桌面通知
    • Cursor 图标上的标记

访问结果​

当后台代理完成时：

  1. 出现通知（如果已启用）
  2. 标记显示在 Cursor 的程序坞/任务栏上
  3. 结果面板自动打开
  4. 更改的文件出现在源代码控制中

最佳实践​

任务粒度​

将大型任务拆分为更小的后台代理：

# 良好：具体、独立的任务
[后台] 重构认证模块的错误处理
[后台] 重构支付模块的错误处理
[后台] 重构通知模块的错误处理

# 不太理想：一个庞大的任务
[后台] 重构整个应用中的所有错误处理

资源管理​

限制并发后台代理：

# 推荐的最大并发代理数
- 2-3 个用于 CPU 密集型任务（重构、分析）
- 5+ 个用于 I/O 密集型任务（文档、报告）

检查点​

对于长时间任务，使用检查点：

[后台] 迁移数据库架构：
1. 创建备份
2. 运行迁移脚本
3. 验证数据完整性
4. 生成回滚脚本

每一步后保存进度。
如果中断，从上一个检查点恢复。

监控和日志​

查看代理日志​

  1. 打开后台代理面板
  2. 点击已完成的代理
  3. 查看完整执行日志
  4. 查看时间戳和操作

日志结构​

[2026-06-25 10:00:00] 代理启动："代码库安全扫描"
[2026-06-25 10:00:05] 读取：src/auth/login.ts
[2026-06-25 10:00:10] 读取：src/auth/register.ts
[2026-06-25 10:00:15] 分析完成：发现 3 个漏洞
[2026-06-25 10:00:20] 写入报告：security-report.md
[2026-06-25 10:00:25] 代理成功完成

为后台代理选择模型​

不同模型适合不同的后台任务：

任务类型推荐模型原因
代码分析Claude 3.5 Sonnet全面、准确
重构GPT-4o快速、可靠
文档Gemini 1.5 Pro长上下文
测试Claude 3.5 Sonnet擅长检测边界情况
安全审计Claude 3 Opus深度分析

在设置中配置默认模型：

{
  "backgroundAgents": {
    "defaultModel": "claude-3-5-sonnet",
    "maxConcurrent": 3,
    "autoNotify": true
  }
}

故障排除​

问题解决方案
代理无法启动检查套餐限制；可能需要升级
代理消失检查后台代理面板中的错误
结果未保存在任务描述中指定输出路径
代理挂起取消并重启；可能在等待输入
CPU 占用高减少并发代理；使用更轻量的模型

示例：完整的后台工作流​

# 上午：启动分析
[后台] 分析代码库中的技术债务。
生成一个按优先级排列的重构任务列表。

# 代理运行时，继续编码...

# 代理完成
[通知] "分析完成：发现 12 个重构机会"

# 查看结果
打开：analysis-results/refactoring-tasks.md

# 在后台启动重构
[后台] 实现分析中的前 3 个重构任务。

# 继续其他工作...

# 在方便时审查更改
检查源代码控制面板中的差异

相关资源​