Agents Window
基于 Cursor 官方 Agents Window 文档解释 agent-first 窗口、多工作区、并行 Agent、diff、cloud/local handoff 和 worktrees。
Agents Window 是 Cursor 的 agent-first interface。官方文档把它定义成一个统一工作区：你可以跨 repo 和环境使用 Agent，包括 local、cloud、remote SSH 等场景；也可以在需要时回到经典编辑器窗口。
阅读目标：读完本章，你应该能判断什么时候用 Agents Window，什么时候回到 Editor，并能为并行 Agent 设置工作区、diff、worktree 和验收边界。
1. 它解决什么问题
Agents Window 的核心不是“多开几个聊天框”，而是把多个 Agent 任务从编辑器侧栏提升到一个更适合管理并行工作的界面。
flowchart TD
Work["多个真实任务"] --> AgentsWindow["Agents Window"]
AgentsWindow --> Local["Local workspace"]
AgentsWindow --> Cloud["Cloud agents"]
AgentsWindow --> SSH["Remote SSH"]
AgentsWindow --> Diff["Diffs / commits / PRs"]
AgentsWindow --> Worktrees["Isolated worktrees"]
Diff --> Review["Review before merge"]
Worktrees --> Isolation["每个任务独立文件和变更"]如果你主要在 Cursor 里让 Agent 写大部分代码，Agents Window 会让你站在更高一层管理任务：看哪些 Agent 正在跑、哪些变更需要审查、哪些任务应该隔离到 worktree。
2. 打开与切回 Editor
官方文档给出两个命令入口。
| 目标 | 操作 |
|---|---|
| 打开 Agents Window | 在 editor 中按 Cmd+Shift+P，运行 Open Agents Window |
| 切回经典编辑器 | 按 Cmd+Shift+P，运行 Open Editor Window |
| 在 Agents Window 内找文件 | Cmd+P 搜索文件 |
| 在 Agents Window 内全局搜索 | Cmd+Shift+F 搜索所有文件 |
官方也明确说明：你可以随时切回 editor，或者让两个窗口同时打开。实操上，如果你需要密集看很多文件、拆分屏幕、使用 VS Code extensions，editor 仍然更合适。
3. Agents Window 独有能力
官方列出这些只在 Agents Window 中可用的能力。
| 能力 | 官方含义 | 项目里怎么用 |
|---|---|---|
| Multi-workspace | 从一个地方跨项目使用 agents | 同时跟踪多个 repo 的小任务，但不要让同一个 Agent 跨仓库乱改 |
| New diffs view | 在 Cursor 内审查、提交变更并管理 PR | 把 Agent 的自然语言总结降级为参考，最终看 diff |
| Parallel agents | 在 cloud 中运行很多并行 agents，并从 phone、web、Slack、GitHub、Linear 协作 | 适合拆成多个互不冲突的任务 |
| Local/cloud handoff | 在 cloud 和 local 之间移动 agent | 需要本地快速迭代时拉回 local，长任务再交回 cloud |
| Worktrees | 在隔离 Git checkout（git worktree，把同一仓库 checkout 到独立目录）中运行 agents | 每个任务独立文件和变更，减少并行冲突 |
Parallel agents 不是“让多个 Agent 改同一块代码”。真正安全的并行，是每个任务有独立目标、独立文件范围、独立验证方式，必要时使用 worktrees 隔离。
4. 怎么选 Agents Window 或 Editor
官方判断很直接。
| 你正在做什么 | 更适合用什么 |
|---|---|
| 管理很多 Agent 并行任务 | Agents Window |
| 让 Agent 在 cloud 中持续工作 | Agents Window |
| 需要 diff、commit、PR 管理不离开 Cursor | Agents Window |
| 主要自己写代码，只偶尔问 Agent | Editor |
| 依赖 VS Code extensions、分屏和传统 IDE 操作 | Editor |
| 需要同时打开很多文件做人工判断 | Editor |
两个界面不是互斥关系。商业项目里更常见的做法是：Agents Window 负责并行编排和交付状态，Editor 负责高密度人工阅读、精修和疑难判断。
5. 并行 Agent 管理清单
每开一个 Agent 前，先写清楚五件事：
- 任务目标：它要完成什么，什么算完成。
- 文件范围：允许看哪里，允许改哪里。
- 工具范围：是否能跑命令、开浏览器、发起 web search。
- 验收证据：测试、lint、build、截图、日志、diff 或 PR。
- 冲突边界：是否和其他 Agent 改同一目录；如果会冲突，就先拆任务或用 worktree。
深读：Agents Window 为什么要和 worktrees 一起理解
当一个 Agent 只做单线程小改动时，普通 workspace 也能承受。问题出现在并行：两个 Agent 同时改相同文件，会让 diff 审查、测试归因和回退都变复杂。
Cursor 官方把 worktrees 放进 Agents Window 独有能力列表里，原因就在这里：并行任务最好有隔离 checkout。这样每个 Agent 的文件、变更、验证和提交路径都能单独审查。
6. Enterprise rollout 边界
官方文档记录：Agents Window 随 Cursor 3 在 2026-04-02 generally available。发布后的前两周，Enterprise Admins 可以在 Team settings 中控制给全团队或特定用户开放；之后默认所有用户可访问。
这类 rollout 信息有明显时效性。团队上线前仍要检查当前 Cursor Team settings、权限策略和内部使用规范，不要只依赖教程里的历史窗口描述。
本章自检
完成本章后，用这 3 个问题检查自己是否真正理解：
- Agents Window 相比 Editor 的主要优势是什么？
- 为什么并行 Agent 最好搭配 worktrees 或明确文件边界？
- 什么时候应该从 Agents Window 切回经典 Editor？
通过标准：你能把一个多任务需求拆成多个互不冲突的 Agent 任务，并说清每个任务的 diff、验证和回退证据。
官方来源
- Cursor Agents Window —— 官方说明 Agents Window、打开方式、独有能力、Editor 对比和 Enterprise rollout。
- Cursor Worktrees —— 官方说明通过 isolated Git checkouts 运行 agents。