跳转到内容

审查与提交改动

Changes(改动)列出已暂存、未暂存、未跟踪和有冲突的文件,可以列表或树形显示。未跟踪文件与未暂存文件位于同一棵树中,每个文件都带有表示其类型的图标和状态字母。标签页上会显示改动的文件数,有冲突待处理时显示为红色。

  • 可按搜索、状态(新增、修改、删除、重命名、未跟踪、冲突)、图片以及All / Unstaged / Staged筛选;各项计数会随其他筛选条件变化。
  • 将指针悬停在文件、文件夹或分组行上,或用键盘聚焦时,会出现Stage、Unstage和Discard,作用于当前显示的文件。
  • 未跟踪文件或文件夹的右键菜单可以将其添加到根目录的.gitignore中,作为工作区文件里的一行,供你审查。
  • 工作树根目录下的.ffignore使用.gitignore语法,列出改动在预期之内的已跟踪文件,例如白标(white-label)构建会改写的文件。它们的未暂存改动不会出现在列表中,除非在状态筛选菜单中选择Show .ffignore files。

选中文件即可查看其差异,暂存区、工作区和提交中的改动(包括重命名)都能显示正确的修改前后版本。

  • 语法高亮支持35种语言,按文件名、扩展名或#!行识别。只要Git能读取,每一侧都会基于整个文件着色,因此位于注释或字符串内部的代码块也能正确显示。
  • 变化的词:删除的行会与其后新增的行配对,每一对中变化的词会以更深的底色标出。
  • 差异标题栏中的Side by side会让删除的行与新增的行左右相对。窗格宽度小于800 px时,差异保持合并(unified)视图。
  • 空白:空白按钮会隐藏仅涉及空白的改动(git diff -w)。新增行末尾残留的空白会标为红色,制表符按工作树的.editorconfig为该文件设定的宽度对齐。
  • 代码块标题会写明代码块所在的方法、函数、类型、Markdown标题或YAML键。标题上的按钮会在每个代码块周围多显示20行,Whole file则显示整个文件。
  • 折叠:锁文件、生成的文件和超过3,000行的差异会先收起,点击Load diff后才显示。Wrap lines会让长行自动换行,而不是横向滚动。
  • 导航:F7和Shift+F7(在差异中为⌥↓和⌥↑)可跳到下一个或上一个代码块,越过最后一个时会跳到下一个文件。右侧边缘的标记显示改动所在的位置。

右键点击某一行的行号会提供Line history…(行历史):在差异上方显示最后修改这一行的人,以及此前修改过它的每个提交,跟随重命名,每次显示20个。

  • 在列表中暂存或取消暂存整个文件。
  • 在已修改文件的差异中,点击代码块标题上的Stage hunk(或Unstage hunk)即可暂存该代码块。点击某个已改动行的行号即可选中它,再通过差异上方横条中的Stage lines暂存。
  • 在未暂存的差异中,Discard hunk和Discard lines会在询问后把这些行恢复为暂存区中的版本,并先创建恢复副本。
  • 每项操作都会先重新检查差异;如果文件已经变化,则不做任何改动。
  • 暂存、取消暂存或丢弃正在审查的文件后,会自动跳到下一个文件。

暂存和取消暂存都通过改动队列(change queue)进行:文件会立即移动,并以淡化样式显示,直到Git处理完成,因此你可以一个接一个地暂存文件而无需等待。队列条目按顺序逐个执行。被锁定的index.lock会在几秒内重试——ffgit从不删除它——失败时文件会被移回原处。文件列表工具栏中的Change queue菜单会显示每个条目,并提供Cancel、Retry和Dismiss。

提交编辑器包含摘要、可选的描述和已暂存文件数。修订提交(amend)需要明确选择。提交失败时会保留你的草稿,之后输入的内容也会保留。钩子和签名完全按照Git中的配置运行。点击标签栏中的按钮,可以把提交面板收起为文件列表下方的一行;再次点击该按钮、点击这一行或按⌘Enter即可重新显示。

摘要旁边的按钮会让你的智能体根据已暂存的改动起草完整的提交信息,包括摘要和描述。可以在按钮旁边的菜单或Coding agents设置中选择Claude Code或Codex。它只运行一次且只读(Plan模式、只读沙箱、不保留会话),使用ffgit的提示词,该设置对话框会显示提示词并允许编辑。结果只会填入输入框;再次点击可停止,在项目中首次使用时会先询问。起草的提交信息不带Claude Code的Co-Authored-By和Generated with Claude Code行,除非开启了Agent’s co-author line in commits。

提交前,ffgit会标记需要留意的已暂存文件:

  • 超过大小限制的文件(默认50 MiB,可在Cleanup › Suggestions中设置);
  • 按Build output in Git规则判定的构建产物;
  • 按文件名判定的疑似机密文件(.env、*.pem、*.p8、*.p12、id_ed25519、*private-key*等)——ffgit不会读取文件内容;
  • .ffignore中列出的文件。

Commit和Amend会一次性列出这些文件及原因,并提供Commit anyway(仍然提交)或Unstage them(取消暂存这些文件)。只有点击后者才会取消暂存,且只针对这些文件。

在Changes的差异中,点击某一行的**+**即可留下备注;图片审查可以在改动图片的某个区域(按图片自身像素)添加备注(参见图片审查)。文件变化时,备注会跟随它所在的行(Moved from line N),否则会标为Anchor needs review或Outdated。**Review notes (N)**会列出这些备注,供你解决、编辑或删除;点击某条备注会在对应的行打开其文件。

  • Send to chat会把工作树中未解决的备注作为一条消息发送到正在运行的聊天,按文件和行组织,并附上图片区域的裁剪图。横条会一直跟踪这批备注,直到智能体接收。
  • *Copy package…*会将未解决的备注复制为Markdown,*Export…*会将其连同JSON清单写入文件夹。
  • 每种方式都会先按发出时的样子显示这批备注,你可以取消勾选某条备注,留待以后处理。

退出应用后备注仍会保留,连同其中的图片加密保存在设置旁边。

历史、分支、冲突和工作树请参阅历史与分支。