用途:提交前先把噪声挡在版本库外,再写规范提交信息。核心是排除清单与忽略落点决策,git 提交在末端。
主要能力:按高频噪声分类筛选应提交项;对排除噪声判断写入 .gitignore、全局 excludesFile 或 .git/info/exclude;用 git check-ignore -v 避免重复添加规则;对已追踪噪声用 git rm --cached 移出索引(先 git rm -n --cached 预演,需用户确认);提交前做密钥启发式预扫,命中则拒交报警;未给 message 时按 feat/fix/docs/refactor/chore/test/perf/build/ci 加祈使句主题自动生成,并采样 git log 风格。
使用方式:先 git status --porcelain 与 git diff --stat 查看改动;逐文件分类;按落点写入忽略 pattern;对已追踪噪声从索引移除;逐个 git add <path> 暂存;用 git diff --cached 做密钥预扫;防空提交后 git commit -m。用户已给 message 则直接采用。
适用场景:需要保持提交干净、避免把临时与构建产物、凭证带入版本库的日常本地提交。
限制:不主动 push;疑似密钥一律不提交,但忽略只挡未追踪文件,已入历史的密钥需用户自行 rotate 与清史;不清史、不改写历史(不 amend/rebase);噪声 pattern 为高频项非穷尽;密钥检测为启发式,精确规则以 gitleaks 等为准;pre-commit 失败需修根因,--no-verify 仅在用户明示时使用;大文件误入暂存建议用 Git LFS 或移出。