PR 页面可供你详细评审 PR。它将 PR 摘要、代码更改、评论、检查和合并操作集中在一处,让你能够从了解更改到采取相应操作。
可在 PR 页面上执行的操作¶
- 在请求头中查看 PR 标题、状态和评审操作
- 当你的分支属于某个分支栈时,在相关 PR 之间切换
- 阅读或更新 PR 描述
- 跟进 PR 级的讨论和评审活动
- 查看审阅人、CI 状态、标签、负责人和关联任务
- 在修改的文件之间跳转、比较版本,并查看完整 diff
- 添加行内评论、建议修改,或提交完整评审
- 通过代码导览,以叙述方式了解更改内容
- 直接在代码中查看 Bugbot 发现,并一键应用建议修复
- 在侧边栏中打开 Cursor Agent,让它解释代码、总结 diff、起草反馈,或直接将代码更新提交到分支
浏览页面¶
请求头和概览¶
请求头汇集了常用操作。你可以在此发起评审,在拥有权限时合并或发布,打开评论,以及启动 Cursor Agent。如果 PR 附带部署预览,也会显示在这里。
请求头下方的概览区域会在你查看代码前提供上下文:
- 分支栈会在你处理分支栈时显示相关 PR
- 描述可让你查看或更新 PR 摘要
- 讨论或对话会根据工作区布局显示 PR 级评论和评审活动
- 信息会在配置后显示检查、审阅人、标签、负责人,以及来自 Linear 或 Jira 等工具的关联任务
文件和 diff¶
文件树可让你直接跳转到任意修改的文件。你还可以切换 diff 版本,比较不同的提交或范围,并在评审过程中将文件标记为已查看。
根据你的设置,评论可以内联显示在 diff 中,也可以显示在浮动评审面板中。无论采用哪种方式,文件树、线程列表和代码视图都会保持同步,方便你在文件和对话之间切换。
代码导览¶
代码导览将 PR 转化为对所提更改的引导式浏览。无需在描述和零散文件之间来回跳转,您可以按清晰的顺序浏览代码,并通过叙事获得完整上下文。
Cursor Review 会汇集 PR 中的所有内容来生成导览。描述、对话、分支栈和代码本身整合为结构化的内容,让说明与实现并列呈现。叙事内容与 diff 并排显示,让您在评审时保持连贯的思路。
使用代码导览可以:
- 快速了解大型或不熟悉的更改,无需反复回看
- 按文件逐一沿着作者在 diff 中设计的路径浏览
- 当 PR 涉及多个文件或属于分支栈时,始终掌握整体脉络
Bugbot 评审¶
Bugbot 会评审每个 PR,并标记缺陷、安全问题和代码质量问题。发现项会以行内评论的形式显示在 PR 页面上,方便你结合相关代码查看。
对于每个发现项,你可以:
- 阅读说明和建议修复方案
- 点击 Fix in Cursor,在本地 Cursor IDE 中打开该问题
- 点击 Fix in Web,在 cursor.com/agents 中打开该问题
- 让 Cursor Agent 直接在 PR 页面应用修复
Bugbot 会在每次 PR 更新时自动运行。你也可以在 PR 中评论 cursor review 或 bugbot run 来手动触发。启用 Autofix 后,Bugbot 会启动云端代理,将修复推送到现有分支或新分支,然后在 PR 中评论结果。
有关设置、规则、effort 级别和 Autofix 配置,请参阅 Bugbot。
提供反馈¶
将鼠标悬停在行号上即可添加评论。点击单行可对该行评论,或选择一个范围,一次对多行评论。
在行操作菜单中,您可以:
- 添加评论
- 建议更改
- 复制所选代码
- 复制所选行的深层链接
- 将所选内容发送给 Cursor Agent
准备完成后,使用 审查更改 来批准、请求更改或留下摘要评论。
在 PR 中使用 Cursor Agent¶
需要理解、回复或更新 diff 时,可从右侧边栏打开 Cursor Agent。智能体会读取 PR diff、CI 失败信息和审阅人评论,并结合完整的 PR 上下文采取相应操作。
在 PR 页面更新代码¶
如果您是作者,无需离开评审页面,即可让 Cursor Agent 修改代码。用自然语言描述所需更改,智能体会编辑代码、按需运行脚本和测试,并将更改直接提交到分支。新提交会像其他提交一样显示在 PR 中。
可让智能体执行的常见操作:
- 应用 Bugbot 发现项中的建议修复
- 处理审阅人评论或更改请求
- 解决 CI 失败
- 重构函数,或在整个 diff 中重命名符号
- 为更改添加或更新测试
提问并起草反馈¶
作者和审阅人都可以使用 Cursor Agent 阅读 diff,而不会对其进行修改。您可以让 Cursor:
- 解释某项更改的原因
- 总结 PR 中风险较高的部分
- 起草评审评论
- 将选中的代码区域转为智能体提示词
- 运行脚本或执行测试,深入分析某项更改
在 Cursor 和 PR 页面之间延续线程¶
您可以在 Cursor 中发起智能体线程,然后在 PR 页面继续;也可以在 PR 页面发起,再在 IDE 中继续,完整保留历史记录和上下文。这样,您可以在 PR 创建前启动云端代理,并在评审中完成对话;也可以先在评审中开始,再切换到 IDE 进行更深入的本地工作。