SuperAPI AI 工具集

git-hunk

通用与其它

查看项目

更新于 10-16 05:51

技能介绍

用途:git-hunk 替代 git add 与 git add -p,提供确定性的两步工作流——先用稳定内容哈希枚举代码块,再按哈希暂存或取消暂存,确保每条被暂存的行都经过审阅。除 git 外无其他依赖,安装后可当作 git hunk <子命令> 使用。

主要能力:默认工作流为 git hunk list --oneline 查看变更、git hunk diff <哈希> 检查、git hunk add <哈希>… 精确暂存、git hunk list --staged --oneline 校验,再配合 git diff --cached --check 和 --stat 后提交。命令包括 list、diff、add、reset、commit、stash、restore、count、check;均支持 --help、--no-color、--tracked-only、--untracked-only、--quiet、--verbose、-U<n>,哈希前缀至少 4 个十六进制字符。add、reset、commit、restore 支持行级选择 <sha>:<行号>。哈希由文件路径、稳定行号和 diff 内容(+/- 行)计算,暂存其他代码块不会改变剩余哈希;暂存与未暂存的哈希不同。新增、删除与未跟踪文件会自动出现在 list 中,行选择可直接作用于未跟踪文件。--ref 可对历史提交或范围取代码块,--3way 在上下文漂移时回退三方合并,可从中提取或回退单个代码块。

使用方式:先用 list 收集目标哈希,再在一条 git hunk add <哈希>… 中一次性暂存,避免并行写 .git/index.lock。--file 仅限定哈希可匹配的文件范围,不能“文件加哈希”混用,整文件与单个代码块应分两条命令执行。行号按代码块正文(含上下文行)计数,建议用 git hunk diff -n <sha> 读取编号而非手数;-U0 会改变哈希,list 与后续命令需使用相同 -U。

限制:拆分实现与测试后需用能编译测试的步骤验证,例如 go vet ./...、cargo test --no-run 或包含测试 glob 的类型检查;二进制、类型变更、符号链接和空文件不支持行选择,只能整块操作;restore 对未跟踪文件需 --force。错误输出到 stderr,成功退出 0、失败退出 1。官方文档中除上述命令与用法外的定价、平台支持与效果数据暂未提供。