本文为非官方中文翻译，内容以 OpenAI 官方英文文档为准。
官方来源：https://developers.openai.com/codex/app/review
Review
在应用内使用 Codex 审查并迭代修改
审查面板可帮助你了解 Codex 改了什么、提供有针对性的反馈，并决定保留哪些内容。
它仅适用于位于 Git 仓库中的项目。如果你的项目 还不是 Git 仓库，审查面板会提示你创建一个。
它显示哪些变更
审查面板反映的是你的 Git 仓库状态，而不只是 Codex 编辑过的内容。这意味着它会显示：
- Codex 所做的更改
- 你自己所做的更改
- 仓库中任何其他未提交的更改
默认情况下，审查面板会聚焦于 未提交的更改。你也可以 将范围切换为：
- 分支上的所有更改（与你的基线分支进行 diff）
- 上一轮更改（仅最近一次 assistant 轮次）
在本地工作时，你还可以在 Unstaged 和 Staged 更改之间切换。
浏览审查面板
- 点击文件名通常会在你选择的编辑器中打开该文件。你可以在 settings 中选择默认编辑器。
- 点击文件名背景可展开或折叠 diff。
- 按住 Cmd 的同时点击某一行，会在你选择的编辑器中打开该行。
- 如果你对某项更改满意，你可以暂存更改或还原更改中你不喜欢的部分。
用于反馈的行内评论
行内评论可让你将反馈直接附加到 diff 中的特定行上。 这通常是引导 Codex 做出正确修复的最快方式。
要添加行内评论：
- 打开审查面板。
- 将鼠标悬停在你想评论的那一行上。
- 点击出现的 + 按钮。
- 编写你的反馈并提交。
- 完成反馈后，向该线程发送一条消息。
由于评论是针对具体行的，Codex 相比一般性指令 可以更精确地响应。
Codex 会将行内评论视为审查指导。添加评论后，请发送一条 后续消息，明确表达你的意图，例如“处理这些行内评论，并尽量保持范围最小。”
代码审查结果
如果你使用 /review 来运行代码审查，评论会直接
以内联方式显示在审查面板中。
Pull request 审查
当 Codex 对你的仓库具有 GitHub 访问权限，且当前项目位于 pull request 分支上时，Codex 应用可以帮助你无需离开应用就处理 pull request 反馈。侧边栏会显示 pull request 上下文以及 审查者的反馈，审查面板则会在 diff 旁显示评论， 这样你就可以在同一线程中让 Codex 处理问题。
安装 GitHub CLI（gh）并使用 gh auth login 完成认证，这样 Codex
就可以加载 pull request 上下文、审查评论和已更改文件。如果缺少 gh
或未完成认证，侧边栏或审查面板中可能不会显示 pull request 详情。
当你希望将完整的修复流程保留在同一个地方时，可使用以下流程：
- 在 pull request 分支上打开审查面板。
- 查看 pull request 上下文、评论和已更改文件。
- 让 Codex 修复你想处理的具体评论。
- 在审查面板中检查生成的 diff。
- 准备就绪后，将更改暂存、提交并推送到 PR 分支。
有关 GitHub 触发的审查，请参见 Use Codex in GitHub。
暂存和还原文件
审查面板包含 Git 操作，因此你可以在提交之前 整理 diff。
你可以在以下级别暂存、取消暂存或还原更改：
- 整个 diff：使用审查标题中的操作按钮（例如， “Stage all” 或 “Revert all”）
- 按文件：暂存、取消暂存或还原单个文件
- 按代码块：暂存、取消暂存或还原单个 hunk
当你想接受部分工作结果时使用暂存；当你想丢弃它时使用还原。
已暂存与未暂存状态
Git 可以在同一个文件中同时表示已暂存和未暂存的更改。当这种情况 发生时，面板看起来可能像是在已暂存和未暂存视图中“同一个文件显示了两次”。 这是 Git 的正常行为。