English
主导航

审查

在应用中审查并迭代 Codex 的更改

审查面板可帮助您了解 Codex 的更改内容、提供针对性反馈并决定保留哪些更改。

它仅适用于位于 Git 仓库中的项目。如果您的项目还不是 Git 仓库,审查面板会提示您创建一个。

显示的更改内容

审查面板反映的是 Git 仓库的状态,而不仅仅是 Codex 编辑的内容。这意味着它会显示:

  • Codex 做出的更改
  • 您自己做出的更改
  • 仓库中任何其他未提交的更改

默认情况下,审查面板会聚焦于 未提交的更改。你还可以将作用域切换为:

  • 所有分支更改 (与基础分支的差异)
  • 最近一轮的更改 (仅限最近一次助手响应)

在本地工作时,您还可以在以下选项之间切换 未暂存 and 已暂存 changes.

  • 点击文件名通常会使用您选择的编辑器打开该文件。您可以在以下位置选择默认编辑器: 设置.
  • 点击文件名背景可展开或折叠差异。
  • 按住 Cmd 并点击单行,将在您选择的编辑器中打开该行。
  • 如果您对某项更改感到满意,可以 暂存更改或还原 您不喜欢的更改。

用于反馈的内联评论

内联评论允许您将反馈直接附加到差异中的特定行。这通常是引导 Codex 正确修复的最快方法。

留下内联评论的方法:

  1. 打开审查面板。
  2. 将鼠标悬停在您想要评论的行上。
  3. 点击右上角的 + 出现的按钮。
  4. 写下您的反馈并提交。
  5. 完成反馈后,向话题发送一条消息。

由于评论是针对特定行的,因此 Codex 可以比使用通用指令做出更精确的响应。

Codex 会将内联评论视为审查指导。留下评论后,发送一条明确表达您意图的跟进消息,例如“处理这些内联评论,并尽量将范围缩至最小。”

代码审查结果

如果您使用 /review 运行代码审查后,评论将直接以行内形式显示在审查面板中。

拉取请求审查

当 Codex 拥有您仓库的 GitHub 访问权限,且当前项目位于拉取请求分支上时,Codex 应用可以帮助您在应用内直接处理拉取请求反馈。侧边栏会显示拉取请求的上下文和审查者的反馈,而审查面板会并排显示评论和差异,以便您在同一话题中要求 Codex 处理问题。

安装 GitHub CLI (gh) 并使用 gh auth login 进行身份验证,以便 Codex 可以加载拉取请求上下文、审查评论和已更改的文件。如果 gh 缺失或未通过身份验证,拉取请求详情可能不会显示在侧边栏或审查面板中。

当您希望将完整的修复流程集中在一处时,请使用此流程:

  1. 在拉取请求分支上打开审查面板。
  2. 审查拉取请求上下文、评论和已更改的文件。
  3. 要求 Codex 修复您希望处理的具体评论。
  4. 在审查面板中检查生成的差异。
  5. 准备就绪后,暂存、提交并推送更改到 PR 分支。

For GitHub-triggered reviews, see 在 GitHub 中使用 Codex.

暂存和还原文件

审查面板包含 Git 操作,允许您在提交前调整差异。

您可以在以下层级暂存、取消暂存或还原更改:

  • 整个差异:使用审查标题中的操作按钮(例如“全部暂存”或“全部还原”)
  • 按文件:暂存、取消暂存或还原单个文件
  • 按代码块:暂存、取消暂存或还原单个代码块

当您想接受部分工作时,请使用暂存;当您想放弃某些工作时,请使用还原。

已暂存和未暂存状态

Git 可以在同一个文件中同时表示已暂存和未暂存的更改。发生这种情况时,审查面板看起来可能会像在“已暂存”和“未暂存”视图中显示了“同一个文件两次”。这是正常的 Git 行为。