核心能力一览

Agents Window vs 传统 IDE 模式

前置条件

打开 Agents Window

有两种方式打开 Agents Window：

方式一：命令面板

# macOS
Cmd + Shift + P → 输入 "Agents Window" → 回车

# Windows / Linux
Ctrl + Shift + P → 输入 "Agents Window" → 回车

方式二：菜单切换

在 Cursor 顶部菜单栏中，点击 View → Agents Window 直接切换。

第一个 Agent 任务

打开 Agents Window 后，按照以下步骤创建你的第一个 Agent 任务：

1. 在主界面的输入框中输入你的需求描述
2. Agent 会自动搜索你的代码库，理解项目上下文
3. Agent 开始编辑代码、运行命令、迭代修复错误
4. 在 Diff 视图中审查 Agent 的变更
5. 确认无误后，提交代码或创建 PR

# 示例提示词
"给登录页面添加 Google OAuth 支持，使用 next-auth 库，
并添加对应的单元测试。"

整体布局

Agents Window 的界面分为以下几个核心区域：

Agent 侧边栏详解

Agent 侧边栏是 Agents Window 的核心导航区域，提供以下功能：

• •Agent 搜索 — 快速搜索已有的 Agent 对话
• •新建 Agent — 一键启动新的 Agent 任务
• •状态指示 — 实时显示每个 Agent 的运行状态（运行中 / 等待输入 / 已完成）
• •环境标签 — 区分本地 / 云端 / Worktree Agent
• •跨平台汇聚 — 汇聚来自桌面端、移动端、GitHub、Slack 等各渠道发起的 Agent

集成浏览器

Agents Window 内置了浏览器，可以直接打开和浏览本地网站（如 localhost:3000），并且支持与 Agent 互动：

• •在浏览器中查看 Agent 修改的实时效果
• •结合 Design Mode 直接标注 UI 问题
• •自动截图作为上下文发送给 Agent
• •截图点击坐标定位作为 Agent 的备用交互方式

使用方式

创建新 Tab：

# 在 Agents Window 中
# 点击 "+" 按钮创建新的 Agent Tab
# 或使用快捷键
Cmd + T          # 新建 Agent Tab
Cmd + W          # 关闭当前 Tab
Cmd + Shift + ]  # 切换到下一个 Tab
Cmd + Shift + [  # 切换到上一个 Tab

分屏布局：

• •拖拽 Tab 到编辑器的左侧/右侧可以创建并排视图
• •拖拽到上方/下方可以创建上下分屏视图
• •组合以上操作可以创建 2×2 网格视图

典型多 Agent 并行场景

# Agent 1: 前端
"实现用户资料页面的 React 组件"

# Agent 2: 后端
"创建用户资料的 REST API 端点"

# Agent 1: 实现功能
"添加购物车功能"

# Agent 2: 编写测试
"为购物车模块编写集成测试"

# Agent 1: 认证模块
"将 auth 迁移到 JWT"

# Agent 2: 数据库层
"将 ORM 从 Sequelize 迁移到 Prisma"

快捷键

使用流程

1. 启动 Design Mode：按 ⌘ + Shift + D 进入标注模式，浏览器会显示可交互的叠加层
2. 选择目标元素：鼠标悬停时会高亮 DOM 元素，点击选中它。也可以用 Shift + 拖拽 框选一个区域
3. 添加到 Agent 对话：选中后按 ⌘ + L 将元素截图 + 选择器信息添加到当前 Agent 对话
4. 描述修改需求：在对话中输入具体的修改指令，例如"将这个按钮改为圆角，背景色改为品牌蓝"
5. Agent 执行修改：Agent 会精确定位到对应组件，修改代码并实时预览效果

典型使用场景

使用方式

在 Agent 对话中使用 /worktree 命令启动隔离模式：

# 在 Agent 对话输入框中
/worktree 将支付模块从 Stripe v2 迁移到 v3 API

Agent 会自动完成以下步骤：

1. 创建一个新的 Git Worktree（独立的工作目录）
2. 在新的分支上进行所有修改
3. 完成后提示你审查变更
4. 你可以选择合并到主分支或继续迭代

为什么需要 Worktree？

使用方式

# 在 Agent 对话输入框中
/best-of-n 实现一个高性能的 LRU Cache，支持 TTL 过期

执行后，Cursor 会：

1. 同时将提示发送给多个 AI 模型（或同一模型多次运行）
2. 每个 Agent 在独立 Worktree 中执行任务
3. 结果以并排视图展示，方便逐一对比
4. 选择最满意的方案，Cursor 自动应用对应的代码变更

适用场景

• ✓算法实现 — 不同模型可能采用不同数据结构和算法策略
• ✓架构设计 — 对比不同的系统设计方案
• ✓CSS 布局 — 对比 Flexbox、Grid、传统布局的实现效果
• ✓性能优化 — 多种优化策略对比测试结果
• ✓重构方案 — 不同的代码组织方式对比

工作原理

启动方式

# 方式一：快捷键触发后台 Agent
Ctrl + E    # 切换到 Background Agent 模式

# 方式二：在 Agent 侧边栏
# 点击 Background Agent Tab → 新建

# 方式三：从现有对话迁移
# 在本地 Agent 对话中，点击 "Move to Cloud" 按钮

配置开发环境

Background Agent 运行在云端，可能需要你的开发环境密钥（如数据库连接串、API Key 等）：

# 在 Background Agent 设置中配置 Secrets
# 所有密钥均使用 KMS 加密存储，运行时注入到 Agent 环境中

DATABASE_URL=postgresql://...
API_KEY=sk-...
STRIPE_SECRET=whsec_...

监控与管理

• •实时状态 — 在 Agent 侧边栏查看每个 Background Agent 的运行进度
• •进入机器 — 点击 Agent 可以"进入"其运行环境，查看详细日志和文件变更
• •结果预览 — Agent 完成后提供 Demo 截图和变更摘要供你审查
• •自动推送 — 代码变更自动推送到 GitHub 分支，方便 Code Review

Local → Cloud 切换

当你需要让一个长时间运行的任务在后台继续执行时：

1. 在本地 Agent 对话中，点击 "Move to Cloud" 按钮
2. Agent 的上下文和任务会无缝迁移到云端环境
3. Agent 在云端继续工作，你可以关闭 Cursor 或切换到其他任务
4. 完成后，你会收到通知

Cloud → Local 切换

当你需要本地测试或手动调整 Agent 的工作成果时：

1. 在云端 Agent 的状态面板中，点击 "Move to Local"
2. Agent 的代码变更和上下文拉取到本地
3. 你可以在本地 IDE 中继续编辑和测试
4. 使用 Composer 2 (Cursor 的前沿编码模型) 进行精细调整

多入口触发

Cloud Agent 不仅可以从 Cursor 桌面端发起，还支持多种触发方式：

跨仓库 Agent 协作

Agents Window 的多仓库布局允许你在一个界面中管理多个代码仓库的 Agent 任务。这对于微服务架构、Monorepo 或前后端分离的项目尤其有用。

# Repo: user-service
"添加邮件验证端点"

# Repo: notification-service
"添加邮件发送功能"

# Repo: frontend
"在注册流程中集成邮件验证"

# Repo: sdk
"添加新的 API 方法 getAnalytics"

# Repo: docs
"为 getAnalytics 方法编写文档"

# Repo: infra
"添加 Redis 集群的 Terraform 配置"

# Repo: backend
"将缓存层从内存迁移到 Redis"

Rules — 定义 Agent 行为规范

通过 .cursor/rules/ 目录下的 Markdown 文件，你可以为 Agent 设定持久化的行为规则。这些规则会在每次对话中自动加载。

# .cursor/rules/coding-standards.md

## 代码规范
- 使用 TypeScript strict 模式
- 所有组件必须有 Props 类型定义
- 使用 pnpm 而不是 npm
- 提交信息遵循 Conventional Commits 规范

## 测试要求
- 新功能必须包含单元测试
- 测试覆盖率不低于 80%
- 使用 Vitest 而非 Jest

## 禁止事项
- 不要使用 any 类型
- 不要使用 console.log（用 logger 替代）
- 不要直接修改 state（使用 immer）

Skills — 赋予 Agent 新能力

Skills 通过 SKILL.md 文件定义，为 Agent 提供动态加载的专业能力：

# SKILL.md — 数据库迁移

## 触发条件
当用户要求修改数据库 schema 时

## 执行步骤
1. 使用 prisma migrate dev 创建迁移文件
2. 检查迁移的 SQL 是否安全（无 DROP TABLE 等）
3. 运行迁移并验证 seed 数据
4. 更新对应的 TypeScript 类型定义

先规划，再执行

研究表明，有经验的开发者在动手之前会先进行规划。Cursor 的 Plan Mode 让 Agent 先研究你的代码库、提出澄清问题、制定详细的实施计划，然后再开始编码。

# 按 Shift + Tab 切换到 Plan Mode
Shift + Tab    # 在 Plan Mode 和 Normal Mode 之间切换

Plan Mode 工作流

1. 输入任务：描述你想要完成的功能或修改
2. Agent 研究：Agent 自动搜索代码库，理解相关模块的结构和依赖关系
3. 提出问题：Agent 可能会提出澄清问题（例如"应该使用哪种认证方案？"）
4. 制定计划：Agent 输出详细的分步实施计划，包括需要修改的文件和预期的变更
5. 确认执行：你审查计划后，确认开始执行，Agent 按计划逐步实现

重新设计的 Diff 界面

Cursor 3.0 重新设计了 Diff 界面，让你更快地审查和编辑 Agent 的变更：

• •实时 Diff 视图 — Agent 工作时实时显示代码变更
• •一键暂停 — 发现方向不对时，立即停止 Agent 并回滚变更
• •Review → Find Issues — 点击 Review 按钮触发专门的代码审查分析
• •Bugbot — 推送到 GitHub 后，Bugbot 自动对 PR 进行高级问题检测

端到端 PR 流程

# 1. Agent 完成编码
# 2. 在 Diff 视图中审查变更
# 3. 直接在 Agents Window 中管理 Git 操作：

# Stage 暂存变更
git add .

# Commit 提交
git commit -m "feat: add Google OAuth support"

# 创建 PR
# Agents Window 内置了 PR 管理界面
# 可以直接创建 PR、设置标签、指定 Reviewer

Cursor Marketplace

Cursor 拥有数百个插件，为 Agent 提供额外能力。插件通过以下机制扩展 Agent：

企业私有市场

Business 和 Enterprise 计划支持建立 私有插件市场，团队可以发布和共享内部插件，确保 Agent 遵循公司的工具链和流程规范。

1. 先规划，再编码

使用 Plan Mode（Shift + Tab）让 Agent 先研究代码库、提出问题、制定计划，然后再开始实现。清晰的规划让 Agent 有明确的目标，减少返工。

# 好的提示词
"分析当前的认证模块，制定一个将 session 认证迁移到 JWT 的计划，
需要考虑向后兼容和灰度发布策略。"

# 不太好的提示词
"改成 JWT"

2. 管理上下文

让 Agent 自主搜索和发现上下文，而不是手动标注每个文件：

• ✓切换到新任务时，开启新对话（避免上下文污染）
• ✓使用 @Past Chats 引用之前的对话，而非复制粘贴
• ✓信任 Agent 的搜索能力，它有强大的代码库搜索工具
• ✗不要在单个对话中处理多个不相关的任务

3. 测试驱动开发 (TDD)

让 Agent 先写测试，再写实现代码。Agent 在有明确测试目标时表现最佳：

# TDD 工作流
1. 告诉 Agent 预期的输入输出
2. Agent 先编写失败的测试用例
3. 确认测试逻辑正确
4. Agent 编写代码使测试通过
5. Agent 自动迭代直到所有测试通过

4. 及时审查，果断干预

通过 Diff 视图实时观察 Agent 的工作，如果发现方向偏离，立即停止并给出修正指令。让 Agent 在错误的方向上走太远会浪费时间。完成后使用 Review → Find Issues 做一次全面的代码审查。

5. 善用并行能力

Agents Window 的核心优势是并行。将大任务拆解为独立的子任务，分配给不同的 Agent 并行执行：

6. 利用图片和截图

Agent 支持多模态输入。在提示中直接粘贴截图、设计稿、报错截图等，比纯文字描述更精准：

• •UI 设计稿 → Agent 实现像素级还原
• •报错截图 → Agent 快速定位和修复 Bug
• •竞品截图 → Agent 参考实现类似功能

Agents Window 快捷键

常用斜杠命令

Agents Window 和传统 IDE 可以同时使用吗？

可以。你可以同时打开 Agents Window 和传统 IDE 模式，两者并行运行。随时通过 Cmd + Shift + P 在两者之间切换，不会丢失任何工作进度。

Background Agent 运行时可以关闭 Cursor 吗？

可以。Background Agent 运行在云端的独立机器上，不依赖你本地的 Cursor 进程。关闭 Cursor、重启电脑甚至断网都不会影响 Agent 的运行。完成后你会收到通知。

Background Agent 的密钥安全吗？

是的。所有密钥使用 KMS (Key Management Service) 加密后存储在数据库中（encrypted-at-rest），仅在 Agent 运行时解密并注入环境变量。Cursor 团队不会以明文形式访问你的密钥。

多个 Agent 修改同一个文件怎么办？

建议使用 /worktree 命令让 Agent 在独立 Worktree 中工作。每个 Worktree 是一个独立的 Git 工作目录，Agent 之间完全隔离。合并时按正常的 Git 合并流程处理即可。

Agents Window 支持哪些触发来源？

Agents Window 汇聚所有来源的 Agent，包括：Cursor 桌面端、移动端（cursor.com/agents）、Slack 集成、GitHub Issue/PR 触发、Linear 集成。所有 Agent 在统一的侧边栏中管理。

需要哪个订阅计划才能使用？

Agents Window 界面在所有计划中可用。但 Background Agent (Cloud Agent) 功能需要 Pro 及以上计划。部分高级功能（如私有插件市场）需要 Business 或 Enterprise 计划。

/worktree 和 /best-of-n 在哪里可用？

这两个命令主要在 Agents Window 中使用。旧版 Editor 中的 Worktree 和 Best-of-N 选择器已被弃用，取而代之的是这两个显式命令，让你对何时进入隔离模式有更精确的控制。