跳转到内容

清理与备份

Cleanup(清理)是仓库的第三个标签页,用于释放当前打开项目的空间。它在后台扫描,边读取边填充结果。

Ready to clean列出可以清理的内容,每一行都显示大小和对应操作:

  • Finished worktrees:工作内容已在默认分支中的工作树,包括通过squash合并的。它们的构建产物会先移到废纸篓,未提交的文件和其他被忽略的文件(例如.env)会存入恢复副本。
  • Merged branches:已合并且未被检出的分支。Squash-merged branches:远程分支已不存在、且main已包含其改动的分支;会先用恢复副本固定它们的提交。
  • Build output and packages:项目每个工作树中下次构建或安装时会重新写入的被忽略文件夹,例如build、node_modules和Pods。每个文件夹都会写明它匹配的规则,以及恢复它的命令(Restore: npm install)。已跟踪的文件、.env和包含发布构建的文件夹默认不勾选。
  • Chats:在项目文件夹中运行过的Claude Code和Codex对话;*Clean up…*会删除旧对话,或只释放其下次运行时会重新写入的内容。
  • Temporary Git packs:存在超过一小时的残留tmp_pack_*文件。
  • Backups、stale worktree entries和Git’s object store(Git对象存储),各有自己的对话框。

Check first列出包含默认分支中尚没有的工作的工作树和分支;每一项都会打开常规的确认对话框。有人正在其中工作的工作树——当前窗口、某个智能体或某个终端——永远不会出现在列表中。

Suggestions(建议)会读取仓库本身。执行操作后,相应改动会被暂存,供你在Changes中提交;文件仍保留在磁盘上。

  • Build output in Git、Likely secrets in Git(仅按文件名判断)以及System and editor files in Git(例如.DS_Store)会提供Stop tracking…。
  • Build folders .gitignore misses会提供Add to .gitignore…。
  • Names that break on other systems会列出仅大小写不同的路径、Windows禁止使用的名称,以及超过260个字符的路径。
  • What makes the repository grow会指出在整个历史中各版本占用空间最多的文件。
  • 当Git LFS已安装并为该仓库配置好时,Large files without Git LFS会提供Track with LFS…;ffgit从不运行git lfs install。
  • 当合并提交带入了大量wip和fix提交时,会出现How pull requests are merged,并链接到项目的设置。
  • Size limit用于设置大小阈值,超过该大小的已暂存文件会在Changes中被标记。

这项设置在你选择规则之前保持关闭,按项目分别保存:ffgit每小时检查一次,当智能体工具为对话创建的工作树闲置了3、7、14或30天,其对话均已结束(settle),其拉取请求或合并请求已合并,或其自身内容与默认分支没有任何差异时,就会将其移除。对话正在其中运行时绝不会移除,并且总是经过与*Remove worktree…*相同的恢复副本流程。铃铛图标会告诉你移除了什么。

克隆可以是部分克隆(partial clone):较早的文件版本(例如黄金测试图片)会留在远程,直到差异或图片对比需要打开它们时,ffgit再一次性批量下载。**Make lighter…**可以把磁盘上已有的克隆原地转换为部分克隆,同时保留分支、贮藏、尚未推送的提交、工作树和备份。只有在Git检查过结果、且远程成功提供了其中一个旧版本之后,它才会删除旧版本。

启用Automatic backups后,ffgit会在切换分支、丢弃、贮藏、合并、变基、拉取、编辑历史以及其他会改写文件的命令执行之前保存一份恢复副本。副本只保存改动过的内容,存放在项目的.ffgit/backups文件夹中(Git会忽略该文件夹),直到你将其删除。

在Backups(备份)中,你可以:

  • Verify(校验)副本;
  • Restore to new folder…:还原已保存的文件和已暂存的改动,绝不会覆盖你当前的工作;
  • Export…(导出)副本以便迁移到另一台电脑,或使用Import backup…(导入备份);
  • 随时使用Create backup创建备份,并按时间**Clean up…**旧副本,事先会说明将释放多少空间。

Backups中会显示备份文件夹及其磁盘占用,备份的位置和保留期限都可以更改。