检查差异、处理 PR 反馈、暂存文件、提交和推送
审查页面是 Codex 应用中用于查看和管理代码变更的核心界面。你可以在这里检查 Codex 所做的所有更改、逐行审查差异、添加行内评论,以及暂存或回退特定的修改。
查看变更内容(What Changes)
Section titled “查看变更内容(What Changes)”审查页面会展示当前线程中所有已修改、新增和删除的文件。每个文件旁边会显示变更统计信息——例如添加和删除的行数。你可以点击任意文件来展开其完整差异视图。

变更按以下类别进行分组:
- 已暂存(Staged):已标记为准备提交的变更
- 未暂存(Unstaged):尚未标记的变更
- 未跟踪文件(Untracked):尚未被 Git 跟踪的新文件
导航变更(Navigating)
Section titled “导航变更(Navigating)”Codex 提供了多种方式来浏览和定位代码变更:
- 文件列表导航:在左侧文件列表中点击文件即可跳转到该文件的差异视图
- 差异内跳转:在差异视图中,可以使用键盘或鼠标滚动浏览每个变更块(hunk)
- 跳转到源文件:点击文件名或使用「在编辑器中打开」可在你的 IDE 中直接打开对应的源文件
- 搜索过滤:当变更文件较多时,可以使用搜索框按文件名快速筛选
行内评论(Inline Comments)
Section titled “行内评论(Inline Comments)”你可以在差异视图的任意行上添加行内评论(inline comments)。这对于标记需要注意的代码片段、提出问题或给出反馈非常有用。
要添加行内评论:
- 在差异视图中,将鼠标悬停在目标代码行上
- 点击出现的 + 按钮
- 输入你的评论内容
- 按 Enter 或点击提交
Codex 也可以生成行内评论。当 Codex 在审查模式下运行时,它会使用 ::code-comment{...} 指令来标记发现的问题,包括优先级、置信度和具体的代码位置。
代码审查结果(Code Review Results)
Section titled “代码审查结果(Code Review Results)”当 Codex 完成代码审查后,审查结果会展示在审查页面中。结果包括:
- 发现的问题:按优先级(P0–P3)和置信度分类
- 整体评估:对代码变更质量的总体判断
- 具体建议:针对每个发现问题的改进建议
- 文件级摘要:每个受影响文件的审查摘要
你可以逐条确认、驳回或要求 Codex 对具体问题进行更深入的分析。
PR 审查(PR Reviews)
Section titled “PR 审查(PR Reviews)”审查页面与 GitHub Pull Request 深度集成:
- 查看 PR 详情:输入 PR 编号即可拉取该 PR 的完整信息、差异和评论线程
- 对比基准分支:Codex 可以自动检测当前分支和基准分支之间的所有差异
- PR 检查状态:查看该 PR 的 CI 检查状态、审查状态和合并冲突情况
- 回复审查评论:直接在审查页面中回复 GitHub 上的审查评论
- 更新现有 PR:Codex 可以根据审查反馈自动更新 PR 中的代码
你也可以在 GitHub PR 评论中通过 @codex review 来触发 Codex 对该 PR 的自动审查。
暂存与回退(Staging / Reverting)
Section titled “暂存与回退(Staging / Reverting)”审查页面提供了灵活的暂存和回退功能,让你可以精确控制哪些变更被提交:
- 暂存单个文件:点击文件名旁的复选框即可暂存该文件的所有变更
- 暂存部分变更(Hunk):在差异视图中,可以只暂存特定的变更块
- 暂存特定行:选中差异视图中的特定代码行进行暂存
- 全部暂存:使用「暂存全部」按钮一次性暂存所有变更
- 回退未暂存的变更:将文件恢复到修改前的状态
- 回退已暂存的变更:先从暂存区移除,再进行回退
- 只回退特定变更块:在差异视图中可以只回退选中的变更块
- 清理未跟踪文件:删除未被 Git 跟踪的新文件
完成审查和暂存后,你可以:
- 输入提交信息
- 选择提交范围(仅已暂存的变更或所有变更)
- 选择是否在提交后推送到远程仓库
Codex 也可以根据变更内容自动生成提交信息。