Appearance
Review 面板是 Codex App 里查看和管理改动的核心工具。它展示 Git 仓库当前的 diff（不只是 Codex 的修改），支持内联注释直接对特定行给反馈，以及按 hunk/文件粒度 Stage 或 Revert 改动。只有 Git 仓库项目才有 Review 面板。
Codex App Review 面板
Review 面板帮你了解 Codex 改了什么、给出有针对性的反馈，并决定保留哪些改动。
前提：项目必须在 Git 仓库里。如果还不是 Git 仓库，Review 面板会提示你创建一个。
显示的内容范围
Review 面板反映的是你 Git 仓库的实际状态，不只是 Codex 编辑的部分。这意味着它会显示：
- Codex 做的改动
- 你自己做的改动
- 仓库里所有其他未提交的改动
默认聚焦未提交的改动。也可以切换范围：
| 范围 | 含义 |
|---|---|
| All branch changes | 与基础分支的 diff（PR 前全量改动） |
| Last turn changes | 仅最近一轮 Assistant 的改动 |
本地工作时还可以在 Unstaged 和 Staged 之间切换。
导航操作
- 点击文件名：在选定编辑器中打开该文件（编辑器可在设置里配置）
- 点击文件名背景区域：展开/折叠 diff
Cmd+ 点击某一行：直接在选定编辑器中打开该行
内联注释
内联注释可以把反馈精确绑定到 diff 中的某一行，通常是引导 Codex 做出正确修改最快的方式。
操作步骤：
- 打开 Review 面板
- 把鼠标悬停在要注释的行上
- 点击出现的 + 按钮
- 写下反馈，提交
- 所有注释写完后，给线程发一条消息
因为注释绑定在具体代码行上，Codex 通常能比收到通用指令时更精确地响应。
内联注释被当作 Review 引导。留完注释后，发一条明确意图的跟进消息，例如："处理这些内联注释，保持改动范围最小"。
Code Review 结果展示
使用 /review 运行代码审查时，结果会直接内联显示在 Review 面板里。
Stage 和 Revert
Review 面板内置 Git 操作，方便你在提交前整理 diff。
可以在多个粒度上 Stage、Unstage 或 Revert：
| 粒度 | 操作 |
|---|---|
| 整个 diff | 使用 Review 头部的操作按钮（"Stage all"或"Revert all"） |
| 单个文件 | Stage、Unstage 或 Revert 某一个文件 |
| 单个 hunk | Stage、Unstage 或 Revert 某一段改动 |
Stage 用于接受部分工作；Revert 用于丢弃不需要的部分。
部分暂存状态
Git 可以在同一个文件里同时有 staged 和 unstaged 的改动。这种情况下，面板可能看起来像"同一个文件显示了两次"——分别出现在 staged 和 unstaged 视图中。这是正常的 Git 行为。
常见问题
Q: Review 面板没有显示，怎么回事？
A: Review 面板只在 Git 仓库项目中可用。如果项目不在 Git 仓库里，面板会提示你用 git init 初始化，或者使用项目文件夹中已有的 Git 仓库。
Q: 内联注释和直接在对话里说有什么区别？
A: 内联注释绑定到具体代码行，Codex 能精确定位要修改的位置，减少沟通成本。对话里的一般指令则依赖 Codex 从上下文推断修改位置，适合范围更广的重构指令。
Q: /review 和手动添加内联注释有什么区别？
A: /review 启动一个专用 Reviewer Agent，以只读模式扫描代码，输出格式化的审查意见，这些意见会自动显示为内联注释。手动添加注释是你自己主动标记需要 Codex 修改的地方，两者可以结合使用。