进阶
审阅改动与 Git 检查点
面向开发者:用 Git 检查点保护代码,在桌面应用审阅面板里查看、暂存、撤销改动和留行内评论,以及 CLI 里的 /diff、/review 与常用快捷键。
这一篇是改坏了怎么办的进阶版,适合已经会用 Git 的读者。
Git 检查点
官方建议每次任务前后都提交一次。Codex 改得不满意时,用 Git 一下就能回到原样。
cd ~/code/my-project
git add -A && git commit -m "checkpoint: before codex"项目还不是 Git 仓库的话,先 git init。桌面应用的审阅面板和 /review 都依赖 Git;项目不是 Git 仓库时,应用会提示你先创建一个。
审阅改动
审阅面板显示的是整个 Git 仓库的状态,所以你自己改的、Codex 改的、其他未提交的改动都会出现在里面:
| 视图 | 显示内容 |
|---|---|
| Unstaged | 未暂存的改动(默认) |
| Staged | 已暂存的改动 |
| Commit | 某个提交的改动 |
| Branch | 当前分支相对基础分支的差异 |
| Last turn | 只看 Codex 最近一轮做的改动 |
- 点文件名通常会在你设置的默认编辑器里打开这个文件;
- 点文件名所在的背景区域可以展开或收起差异;
- 按住 Command 点某一行,可以在编辑器里直接打开那一行。
暂存与撤销(桌面应用)
审阅面板里自带 Git 操作,可以在提交前挑选要保留的改动:
| 范围 | 操作 |
|---|---|
| 全部改动 | 面板顶部的 Stage all、Revert all 等按钮 |
| 单个文件 | 暂存、取消暂存或撤销这个文件 |
| 单段改动(hunk) | 暂存、取消暂存或撤销这一段 |
想保留部分改动就用暂存,不想要的就撤销。同一个文件可能同时出现在 Staged 和 Unstaged 里,这是 Git 的正常行为。
行内评论(桌面应用)
想让 Codex 精确地改某几行时,行内评论最快:
- 打开审阅面板;
- 鼠标移到要评论的那一行上;
- 点出现的 + 按钮;
- 写下你的意见并提交;
- 评论完后,回到对话里发一条消息说明意图,例如:
按行内评论修改,范围尽量小。让 Codex 审查改动
在输入框里输入 /review,选择 Review against a base branch 或 Review uncommitted changes。桌面应用里审查结果会以行内评论的形式出现在审阅面板中;想让审查单独开一个对话,在 Settings > General > Code review 里选择 Detached。
更多审查方式(包括 GitHub PR 审查)见典型工作流和云端任务与 GitHub。
CLI 交互界面的常用操作
| 操作 | 作用 |
|---|---|
输入 @ | 搜索项目里的文件,把路径插入提示词 |
输入 / | 打开斜杠命令菜单 |
行首输入 ! | 直接运行一条本地 shell 命令(仍受当前沙箱和审批设置约束) |
| Codex 工作时按 Enter | 把新消息插入当前这一轮 |
| Codex 工作时按 Tab | 把消息排队到下一轮 |
| 输入框为空时连按两次 Esc | 编辑上一条消息,从那里分叉出新对话 |
| Ctrl+R | 搜索历史提示词 |
| Ctrl+O | 复制 Codex 最近一次的完整回复 |
Ctrl+C 或 /exit | 退出 |
CLI 里附加截图:
codex -i screenshot.png "这个页面的布局错位了,帮我找出原因"