用途:把冗长难懂的 git stash 列表逐条审查清楚,为每个 stash 给出留、丢、应用或归档的决定,只丢弃可证明冗余的条目。
主要能力:先以 git stash list --format='%gd | %H | %ci | %gs' 快照,用提交 SHA 作为稳定标识;再用 git stash show -p 与 git stash show --stat 逐条检查,将每个 stash 归为 REDUNDANT(可证明冗余)、KEEP(有独有改动)或 UNSURE(无法证明冗余,按 KEEP 处理)。保留项用 git branch "stash-archive/$(date +%Y%m%d)-${SLUG}" "$SHA" 或 git update-ref "refs/stash-archive/${SLUG}" "$SHA" 归档后再处理。
必要用法:应用保留项前须确认 git status --porcelain 为空;丢弃只按降序索引执行 git stash drop 'stash@{N}',且必须先重新解析索引;禁止使用 git stash clear。
限制与风险:git stash drop 与 git stash clear 无 porcelain 撤销,丢弃的提交仅短暂留在 reflog/fsck 中且可达性丧失。索引每次丢弃后会重编号,按过期索引操作会删错。无法证明冗余时默认归档而非丢弃;若被要求全部清空,应先全部归档再逐条确认丢弃。输出应先给出判定表(idx、sha7、date、subject、verdict、action)与汇总,再执行破坏性操作。