使用指南
审查、预览与终端
用 diff 审查改动、提交推送,在内嵌浏览器里看运行效果,直接编辑文件,开内置终端。
右栏是你核对结果、动手干预的地方,四个 Tab:审查、浏览器、文件、终端。⌘ + . 切换右栏显隐。
审查
展示当前工作区相对 HEAD 的改动,包含未跟踪的新文件。它是基于本机 Git 计算的,不需要你先提交。
- 左侧文件树按目录顺序排列,标注新增、删除、修改状态。
- 右侧是行级着色 diff,
⌘ + \在统一视图与拆分视图之间切换。 J/K在改动块之间上下浏览,⌘ + E用外部编辑器打开当前文件。- 助手每完成一轮,diff 会自动重新拉取,始终反映最新状态。
- 文件很多或差异很大时会自动切到单文件模式:一次只完整渲染当前文件,靠文件树切换,避免卡顿。
从回答直达改动文件
每轮回答末尾会列出这一轮改动的文件。点击任意一个,直接切到「审查」并定位到它。卡片上还有两个按钮:
- 撤销 —— 一键还原本轮对这些文件的改动。
- 审核 —— 跳到审查面板查看更改。
非 Git 项目没有版本历史可回退,「撤销」会明确提示无法撤销。
行内评论
在拆分与对比视图里,左右两侧都可以悬停发起行内评论。写下的评论会作为下一轮的输入自动带给助手 —— 相当于在代码上直接指出问题,不用再回对话框描述「第几行那个变量」。
暂存、提交与推送
审查面板可以按文件暂存 / 取消暂存 / 还原,顶栏的「提交」打开提交面板:
- 分别列出已暂存与未暂存的改动。
- 可以提交到当前分支,也可以提交到新分支。
- 提交并推送一步到位(
⌘ + Enter)。
装了 GitHub CLI(gh) 并登录后,还能直接创建拉取请求(需要仓库有 origin 远端,且当前不在默认分支上)。
代码审查(/review)
在输入框敲 /review 让助手做一次代码审查:
| 写法 | 审查范围 |
|---|---|
/review | 未提交的改动 |
/review staged | 已暂存的改动 |
/review <分支或 ref> | 与指定分支 / 提交的差异 |
审查面板顶栏也有「审查」按钮,按当前所选范围发起。结论按 P0 到 P3 分级展示,点击可在右栏打开对应文件,也可以一键交给助手修复。改动范围过大时会先征求你确认再开跑。
/review 需要一个可扫描的工作区,普通对话(没绑项目)里不可用。浏览器
在应用里直接看到项目跑起来是什么样:
- 前端项目:自动探测
dev/start/serve脚本,启动本地开发服务,解析出地址内嵌进来。⌘ + 1直接启动并切过去。 - 静态页面:纯 HTML 直接渲染。
- 普通对话生成单文件网页或前端页面时,回答结束会自动打开预览。
- 框选标注:可以在预览区框选、标注,直接连同截图发给助手 —— 「这块样式不对」比打字描述快得多。
文件
打开任意文件查看,可以直接编辑并自动保存,带语法高亮。适合你想亲手改一行、而不是绕一圈让助手改的场景。
终端
右栏内置命令行(⌘ + 3),跟你平时用的终端一样。助手自己跑命令时,输出也会内联显示在对话里,两条路都看得见。
助手在终端里跑命令同样受权限模式约束。
「改完 → 看 diff → 跑起来看效果 → 行内指出问题」,这就是一个顺手的迭代循环。