devcxl merge-old-history-before-hash
将 target_hash（含）之前的所有提交压缩为一个新的根提交，保留其后的线性历史。
之前: A -- B -- C(target_hash) -- D -- E
之后: M(merged_message) -- D' -- E'
M 的文件树与 C 完全一致；D'、E' 是顺序 cherry-pick 的结果。
执行前：收集参数
向用户确认以下信息（未提供则按默认值处理）：
| 参数 | 说明 | 默认值 |
|---|---|---|
target_hash |
边界提交 hash（含此提交被压缩） | 必填 |
merged_message |
新根提交信息 | 必填 |
source_branch |
待处理分支 | 当前分支 |
默认行为：生成新分支供人工验证，不直接覆盖原分支。
执行脚本
使用 scripts/merge-history.sh：
bash scripts/merge-history.sh <target_hash> "<merged_message>" [source_branch]
脚本会自动完成：前置校验 → 备份 → 创建孤儿根提交 → cherry-pick → 给出后续操作提示。
merge commit 检测：若
target_hash之后存在 merge commit，脚本会以 exit code 2 中止，需人工处理。
验证结果
# 查看新历史
git log --oneline --decorate
# 验证新根提交文件树与 target_hash 完全一致（输出为空即正确）
git diff "$target_hash" "$(git rev-list --max-parents=0 HEAD)"
替换原分支（验证通过后）
git branch -f <source_branch> <base_branch>
git switch <source_branch>
git push --force-with-lease
回滚
| 场景 | 命令 |
|---|---|
| cherry-pick 过程中失败 | git cherry-pick --abort |
| 放弃改写，回原分支 | git switch <source_branch> && git reset --hard <backup_branch> |
| 直接切回备份继续工作 | git switch <backup_branch> |