评审面板能帮助你理解 Codex 改了什么、给出有针对性的反馈,并决定哪些内容要保留。
它只适用于位于 Git 仓库中的项目。如果你的项目还不是 Git 仓库,评审面板会提示你先创建一个。
它展示哪些改动
评审面板反映的是你的 Git 仓库状态,而不只是 Codex 编辑过的内容。
这意味着它会显示:
- Codex 做出的改动
- 你自己做出的改动
- 仓库中其他所有尚未提交的改动
默认情况下,评审面板聚焦于 Uncommitted changes(未提交的改动)。你也可以把范围切换到:
- All branch changes(全部分支改动):与基线分支比较差异
- Last turn changes(最近一次回合改动):只看最近一次助手回合产生的改动
在本地工作时,你还可以在 Unstaged(未暂存) 和 Staged(已暂存) 之间切换。
浏览评审面板
- 点击文件名,通常会在你选定的编辑器中打开该文件。默认编辑器可在设置中配置。
- 点击文件名所在的背景区域,会展开或折叠该文件的差异。
- 按住
Cmd再点击某一行,会在你选定的编辑器中打开对应代码行。 - 如果你对某部分改动满意,可以直接暂存或还原文件。
通过行内评论给反馈
行内评论允许你把反馈直接挂到具体差异中的代码行上。这通常是把 Codex 引导到正确修复方向的最快方式。
要添加一条行内评论:
- 打开评审面板。
- 将鼠标悬停到你想评论的代码行上。
- 点击出现的 + 按钮。
- 写下反馈并提交。
- 当所有评论都写完后,再回到线程里发送一条消息。
由于评论锚定在具体代码行上,Codex 通常能比面对一条泛泛指令时给出更精确的响应。
行内评论会被视作评审指导。评论完成后,再发送一条后续消息,明确你的意图,例如:“处理这些行内评论,并保持变更范围最小。”
代码评审结果
如果你使用 /review 运行代码评审,评论会直接以内联形式显示在评审面板中。


暂存和还原文件
评审面板内置了 Git 操作,让你可以在提交前重新整理差异。
你可以在多个层级执行暂存、取消暂存或还原:
- 整体差异:使用评审面板头部的操作按钮,例如 Stage all(全部暂存) 或 Revert all(全部还原)
- 按文件:对单个文件执行暂存、取消暂存或还原
- 按代码块:对单个代码块执行暂存、取消暂存或还原
当你只想接受一部分工作时,使用暂存;当你想丢弃某些改动时,使用还原。
部分暂存状态
Git 允许同一个文件同时存在已暂存和未暂存的改动。因此在这种情况下,你可能会感觉面板像是在“已暂存”和“未暂存”视图中把同一个文件显示了两次。这只是 Git 的正常行为。