历史与分支
History
Section titled “History”History(历史)绘制跨分支、标签和远程的拓扑提交图,支持分支筛选、合并连线和分页加载。每个提交占一行,与Fork的画法一致:泳道保持各自的列,默认分支始终在第一列,合并提交的标题淡化显示。
- 标记用于区分本地分支、远程跟踪分支、标签、在其他工作树中检出的分支,以及其他工作树的分离HEAD。将指针移到标记上会高亮它的历史并淡化其余部分。
- 分支和HEAD标记显示为main ↑2 ↓1,表示尚未推送和尚未拉取的提交;这些数字读取自本地引用,不会执行任何获取(fetch)。
- 图上方的一行会显示未提交的改动,或正在进行的合并、变基、拣选(cherry-pick)或还原(revert)。
- 默认分支已包含的分支会淡化显示并排在最后;视图菜单可以显示或隐藏它们。合并提交的折叠箭头可以收起仅由其分支带入的提交。
- Current and main显示HEAD、它的上游和默认分支;视图菜单还可以隐藏远程跟踪分支,或只沿第一父提交显示。
- 可按提交信息、作者、哈希、路径,或新增和删除的文本搜索历史。
- 提交标题栏中的Details会显示完整的提交信息、作者和提交者、共同作者,以及包含该提交的分支和标签。
方向键、Page Up/Down和Home/End可移动选中项;Alt+Up/Down跳到子提交或第一父提交,Enter打开文件,Cmd/Ctrl+C复制哈希。
切换、合并与变基
Section titled “切换、合并与变基”点击分支会查看它的历史;切换分支是单独的、需要确认的操作。双击某一行会询问是否切换到该行上未被其他工作树检出的本地分支,没有的话则切换到该提交。提交菜单与Fork一样,为该提交上的每个分支提供一个子菜单,另有Compare和Copy子菜单。在这里可以对比、创建分支和标签、合并、变基、拣选和还原,以及在GitHub或GitLab上打开该提交。
合并或变基会先说明它将做什么:两侧各有多少个提交,以及它将带入或重放的最新五个提交;是nothing to merge、快进还是合并提交;以及变基会让多少个已推送的提交获得新的ID。
编辑本地历史
Section titled “编辑本地历史”提交菜单中的**Edit history from here…**可以对当前分支上那些没有任何其他分支、标签、远程或工作树拥有的提交进行改写提交信息、重新排序(拖动或使用移动按钮)、压缩(squash)、fixup和拆分(按文件)。
- 审查会展示精确的前后对比,修改过的提交信息会显示为经过仓库的
commit-msg钩子处理后的样子。 - 点击Rewrite之前不会有任何改动,而且分支只会从审查时看到的末端移动。
- 恢复副本会保留旧的提交;可以在Backups中把它们重新创建为一个分支。
- 已推送的提交、合并提交和共享的提交会被拒绝,并说明原因。
拉取、推送与获取
Section titled “拉取、推送与获取”获取、拉取、推送和克隆时,顶栏会显示Git正在做什么以及进度(Pulling from origin/main · Receiving objects 45%)。
- 拉取仅限快进。有本地改动时,它会提供取消、审查、仅获取或Save and pull,后者会在此期间把改动保存在贮藏(stash)中。
- 当分支与其上游出现分叉时,Pull会说明情况(main and origin/main have diverged: 1 commit here, 2 on origin/main),并提供Rebase onto origin/main或Merge origin/main,执行前会创建恢复副本。
- 会与更新后的分支产生冲突的已保存改动,会先在不触碰文件的情况下推算出来;横条会列出它们,*Restore and resolve…*会写出它们的冲突,供你解决。
- GitHub或GitLab配置可以携带SSH密钥或已保存的令牌,仅供该次Git进程使用。
未完成的合并、变基、拣选或还原会在窗口上方显示一个横条:还有冲突时显示Resolve conflicts,冲突全部解决后显示Abort…、Skip commit…和Continue…,每项都需要确认,并会先创建恢复副本。因冲突而停下不会显示为错误;如果操作是从当前窗口发起的,第一个冲突会在Changes中打开。
- 在Changes中,文件会带行号和语法高亮显示,每个冲突都是一张卡片,可以采用Current、Incoming、两者、基础版本或你自己写的文本。只需一次点击,就能切换到三栏视图(Current · Result · Incoming),或以文本形式查看完整结果。
- ⌥↑和⌥↓可在冲突之间移动。只有在没有剩余冲突时,Mark resolved才会写入。
- Open in会把文件发送到已安装或在Git中配置的合并工具,其结果会返回供你审查。*Merge tools…*可为单个仓库或所有仓库选择工具。
- 横条上的**Resolve with agent…**会把处理剩余冲突的任务放入某个对话的消息框,仅限当前工作树。由你阅读、编辑并发送,之后自己审查并继续。
- 如果文件中的冲突标记是在ffgit之外被智能体或编辑器删除的,ffgit会对照Git写入的冲突来读取它,让你审查它解决的每个冲突。智能体暂存的文件会一直显示在Resolved下,直到操作结束。
Activity的Needs you会列出每个因冲突停下的工作树,并提供Show conflicts和Resolve with agent…。
分支与工作树
Section titled “分支与工作树”- 切换或创建分支,切换前会请求确认。分支菜单可以重命名和删除本地分支,并设置或移除其上游。
- 侧边栏会把你的分支与智能体的分支(
claude/、codex/以及你添加的前缀)分开列出,智能体的分支则按默认分支是否已包含它们来区分。 - 发现、创建和打开关联工作树。新工作树会检出其子模块(默认为All,也可选择Top level或None)。
- 侧边栏的行会说明只有某个工作树才有的内容(2 not pushed、1 not on any branch),或说明其工作已在默认分支中(In main)。当两个工作树改动了同一个文件时,双方都会指出对方——这是合并冲突的早期预警。
- 分支菜单中的*Start agent task…*会针对该分支打开New chat,在已检出该分支的工作树中工作,或在一个从该分支出发的新工作树中工作。参见智能体。
- 在默认分支有上游的项目中,ffgit会询问一次是否开启Keep the default branch current,默认关闭。开启后,ffgit每15分钟获取一次远程更新并快进默认分支,让新的工作树从最新代码开始:仅在该分支已检出、没有改动且没有自己的提交时进行,绝不合并。
分支菜单中的**Stack on…**用于设置该分支所基于的分支,Unstack则移除这一关联。之后侧边栏会把堆叠分支列在其父分支之下,并显示其状态:on a、a has 3 new commits、a was rewritten、a is in main或a is gone。
- **Bring
bup toa…**会把父分支合并到落后的堆叠分支中,并照常先审查合并。 - 当没有任何远程、标签或其他分支拥有这些提交时,**Restack
bontoa…**会重放该分支自己的提交,以及堆叠在它之上的每个分支的提交。它会先在内存中推算并经过审查,然后在恢复副本固定所有旧末端之后执行。不会推送任何内容。重新堆叠(restack)需要Git 2.40或更高版本。 - 从堆叠分支发起Create pull / merge request…时,会以父分支为基础;父分支的请求合并后,Review会提供Change base to main…。
Open in
Section titled “Open in”顶栏中的Open in(侧边栏的项目和工作树菜单中也有)可以在Terminal、iTerm、Warp或Ghostty中,在Finder中,或在已安装的编辑器(例如VS Code、Cursor、Antigravity、Windsurf、Zed、Sublime Text或JetBrains IDE)中打开工作树。View on GitHub或View on GitLab会打开上游分支的页面。
可见的仓库会根据Git操作、文件系统事件和每两秒一次的状态轮询自动刷新;处于后台的窗口会暂停其文件监视。