代码审查面板(Review Pane)
Review 面板让你可以在 Codex App 内直接审查、理解和迭代代码改动,无需切换到外部 Git 工具。
前提条件
Review 功能需要项目位于 Git 仓库中。没有版本控制的项目会提示初始化 Git。
查看范围
默认显示"未提交的改动",也可切换查看范围:
| 范围 | 说明 |
|---|---|
| 未暂存/已暂存的改动 | 当前本地工作内容 |
| 所有分支改动 | 与基础分支的完整对比 |
| 最近一轮改动 | 仅显示 Codex 上一轮操作的改动 |
提示
查看 Codex 做了什么时,使用"最近一轮改动"视图更聚焦,不受其他未提交内容干扰。
显示内容反映仓库真实状态,包括 Codex 的修改、手动编辑和其他未提交内容。
文件操作
| 操作 | 方式 |
|---|---|
| 在编辑器中打开文件 | 点击文件名 |
| 展开/折叠 Diff | 点击背景区域 |
| 在编辑器中打开特定行 | Cmd+点击行号 |
| 暂存已接受的改动 | 点击 Stage 按钮 |
| 撤销不需要的改动 | 点击 Revert 按钮 |
行内代码注释
直接在 Diff 的特定代码行上添加反馈:
- 将鼠标悬停在目标行
- 点击出现的 "+" 按钮
- 输入反馈内容并提交
- 发送后续指令,明确指出修改意图
注释会锚定到具体代码行,让 Codex 的响应比通用指令更精准。
自动化代码审查
在线程输入框中运行 /review 命令,Codex 会自动生成审查注释,直接显示在 Review 面板的对应代码行旁。
Git 操作粒度
Review 面板支持三个粒度的 Git 操作:
| 粒度 | 说明 |
|---|---|
| Diff 级别 | 一次暂存/撤销所有改动 |
| 文件级别 | 按文件单独管理 |
| Hunk 级别 | 按代码块(Hunk)精细控制 |
备注
部分暂存的文件(同时包含已暂存和未暂存改动)会分别显示在不同区域,与标准 Git 行为一致。