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。