Git Absorb 自动修复提交生成器

为什么需要自动修复提交

当你基于某个分支继续开发时，常会遇到这样的场景：上游的某个提交在评审后需要修改，而你已经在它之上做了新的提交。传统做法是手动 git rebase -i，逐个找到对应提交，把改动 squash 或 fixup 进去，过程容易出错且耗时。

git-absorb 的核心思路是让变更自动落回正确的祖先提交，无需人工挑选和排序。它会分析你暂存区里的改动，匹配到每个变更最可能归属的原始提交，并自动生成对应的 fixup! 提交，把修改“吸收”进历史，保持线性且干净的分支。

它如何工作

1. 分析暂存区变更：读取 git diff --cached，识别出哪些行被修改、新增或删除。
2. 匹配祖先提交：根据变更内容，计算每个 hunk 最可能归属的已有提交（通常是离当前 HEAD 最近的、修改了相同文件或相似行的提交）。
3. 生成 fixup 提交：为每个被匹配的祖先提交创建一个 fixup! 提交，把对应的变更打进去，而不是创建新的顶层提交。
4. 应用并整理：最后可以通过 git rebase -i --autosquash 快速完成整理，将 fixup 合并到原提交中。

整个过程不需要你打开交互式编辑器，也减少了因手动操作导致的冲突或错位。

适用边界与注意点

• 依赖 a2x 工具：构建时需要系统中存在 a2x，否则可能无法生成 manpage。
• 需要构建 libgit2：虽然不链接系统的 libgit2，但编译和运行需要你能自行构建 libgit2（受近期代码变更影响）。
• 适用于线性历史：如果你的分支已经有合并提交或复杂的非 ff 历史，匹配逻辑可能不如预期精准。
• 暂存区驱动：工具主要关注 --cached 的改动，未暂存的内容不会被处理，需提前确认变更已加入暂存区。