使用指南

审查、预览与终端

用 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 → 跑起来看效果 → 行内指出问题」,这就是一个顺手的迭代循环。