如何使用 Cursor Agent 模式：开仓库任务并审 diff
打开 Agent 面板，下一件有边界的仓库任务，然后自己读完 diff 再决定留不留。
仓库已经在 Cursor 里打开。你要模型动手，但不想对着一堆没读过的 diff 点接受。官方把这条路叫 Agent 模式：开一个对话，下一件仓库任务，再读它碰过的每个文件。
可检索的做法是 如何使用 Cursor Agent 模式：打开 Agent 面板，避开只读的 Ask，写成一条有边界的任务，然后在 diff 视图里决定留哪些。下面的快捷键和审查步骤以 cursor.com/help/ai-features/agent 为准。
先选会改文件的模式
Agent 会写
它会搜目录、改多个文件、跑 shell，出错时也能停下来修。结果是一份你要自己审的补丁，再用它。
Ask 只读
Ask 回答问题，不改文件。面板停在 Ask 时，你只会得到说明和空 diff。Shift+Tab 循环模式，面板下拉框效果相同。
| 模式 | 什么时候用 | 会改文件吗 |
|---|---|---|
| Agent | 功能、重构、缺陷，且你准备审 diff | 会 |
| Ask | 只想弄清目录和调用关系 | 不会 |
| Plan | 跨很多文件，要先认可方案 | 你批准方案之后 |
| Debug | 需要运行时证据的难 bug | 会 |
一遍走完：启动、下任务、审 diff
- 01打开 Agent 面板
在已经是 git 仓库的文件夹里按 ⌘I（Mac）或 Ctrl+I（Windows / Linux）。确认模式是 Agent。上一线程若是另一件事，开新对话。官方写明：各模式上下文分开，换任务时新开更干净。
- 02只下一件有边界的仓库任务
写清结果、目录或文件、以及怎样算做成。例如：在 src/auth/session.ts 补空值判断，并跑现有单测。不要把五件无关的活写进同一条。官方示例也是一条具体请求。
- 03看 diff 视图
回车后 Agent 先探目录，再边做边落盘。文件出现在 diff 里。它走出你点名的目录就按 Stop。跟进可以排队，等当前轮结束再跑。
- 04审完再留或拒绝
读新增和删除。拒绝不想要的块。把鼠标放到更早的消息上，用 Restore Checkpoint 回滚那之后的文件改动——对话还在。测试要自己跑，不要把 Agent 日志里的一行绿当成验收。
在 src/auth/session.ts 加守卫：缺少 user id
时返回 401。不要改 billing 目录。跑现有的
session 单测，失败就停。第一次任务常在哪里断
- 面板停在 Ask
- 文件不会变。用 Shift+Tab 或模式下拉切到 Agent，再发同一条提示。
- 提示里没有边界
- Agent 会搜得很宽。写明目录、测试、以及不许改的路径。
- 整叠 diff 一次接受
- 拒绝多余文件。看删除行。方向错了就回检查点，不要在坏补丁上叠第二次重写。
一件任务，一个对话，然后读 diff。接受按钮不是审查。
Cloud Agent 是另一扇门
cursor.com/agents 能在浏览器里跑 Cloud Agent。本指南的桌面回路仍然成立：审查是你的。两条路都不要合并没读过的 diff。
两个人要先对齐一次重构再合入，把文件清单和风险块摊在同一页即可。用 oakmeet 开一间会过期的房：浏览器、空间码、不用注册。房间边界见 八人、大约一小时。
Agent 和以前的 Composer、Chat 是一回事吗？
当前帮助把能改文件、能跑命令的助手叫 Agent。旧界面文案写过 Composer。若你的版本仍显示 Composer，选允许改文件的模式，不要停在只读的 Ask / Chat。
一定要登录、一定要付费吗？
需要登录。Agent 用量跟你的 Cursor 套餐和模型额度走。现行套餐看 cursor.com/docs。本页不售卖套餐。
已经接受的 diff 还能撤吗？
在更早的一条 Agent 消息上用 Restore Checkpoint，可撤回那之后的文件改动。已经进 git 的，仍可用 git checkout / git restore。回滚不会清空对话。
该先用 Plan 吗？
官方对照表写：跨很多文件的大改，先走 Plan，你批准方案后它才改。边界清楚的单件仓库任务，按本教程走 Agent 即可。