开发工具代码评审CLIAI 应用【免费下载链接】hunkReview-first terminal diff viewer for agentic coders项目地址https://gitcode.com/gh_mirrors/hu/hunk点击查看免费下载Hunk 是一款面向 Agent 化开发者的终端 diff 查看器Review-first terminal diff viewer。本文聚焦于把它接入 Git 工作流的两种官方方式将hunk pager配置为 Git 的通用 pagercore.pager或将hunk difftool配置为 Git 的 difftool。读完本文你将掌握完整的配置命令、plain-text 回退机制的原理、difftool 的参数约定以及如何干净地撤销集成。Pager 模式一条命令两种命运Hunk 的 pager 模式hunk pager与普通 pager 的最大区别在于它不只负责分页显示还会检查 stdin 内容是否形如 patch从而决定是打开完整的 review 界面还是退回到普通文本分页。这一判断逻辑在 pager.ts 的looksLikePatchInput中实现检测规则如下文本中包含diff --git/^diff --git /m或同时包含---与头/^--- /m与/^\\\ /m或包含 hunk 头/^ /m。匹配前会先做两件事把\r\n归一化为\n并剥离终端控制序列stripTerminalControl。后者保证了即使在管道中夹带了 ANSI 颜色或窗口标题序列检测依然可靠——这一点在 pager.test.ts 中有对应的测试用例含\u001b]0;title\u0007...\u001bP...\u001b\\这类夹带控制序列的样本。因此git diff、git show这类输出 unified diff 的命令交给hunk pager后会直接进入 Hunk 的 review 界面而git log、git status等普通文本输出则走 plain-text 回退路径详见下文。配置 Git pager方案一全局接管将 Hunk 设为 Git 的全局 pagergit config --global core.pager hunk pager设置后git diff、git show等命令的输出都会经由 Hunk。有两个需要提前了解的边界pager 输入完全由 Git 控制。Git 只把已经产生的输出喂给 pager因此未跟踪untracked文件不会在此模式下被合成——这是 pager 模式与hunk diff工作树审查的关键差异。hunk diff通过 VCS adapter 主动枚举工作树变更默认会把 untracked 文件纳入 reviewloaders.test.ts 与 changeset 加载器的测试都验证了这一行为并可用--exclude-untracked关闭而 pager 模式只能看到 Git 已经输出的内容。普通文本不会打开 review 界面。git log等非 diff 输出会被分流到 plain-text 回退见下文。方案二保留原 pager使用 opt-in 别名如果不想全局接管可以保留原有 pager仅新增两个别名按需触发 Hunkgit config --global alias.hdiff -c core.pagerhunk pager diff git config --global alias.hshow -c core.pagerhunk pager show之后git hdiff/git hshow走 Hunkgit diff/git show仍是原来的行为。-c选项在单次命令内临时覆盖core.pager不影响全局配置是侵入性最小的接入方式。Plain-text 回退永不递归的文本分页当hunk pager收到的内容不是 unified diff 时Hunk 不会强开 review 界面而是把文本流式交给一个普通文本 pager。pager 命令的选择顺序为环境变量HUNK_TEXT_PAGERHunk 专属优先级最高环境变量PAGER默认值Unix 下为less -RWindows 下为more。关键防护如果解析出的可执行名最终解析回hunk该值会被忽略并回退到默认 pager见 pager.ts 的resolveTextPagerSpec。这保证了 Git 永远不会递归进入hunk pager自身形成死循环——即使你把HUNK_TEXT_PAGER或PAGER误设成了hunk。executableName还会去掉.cmd/.exe后缀并归一化大小写因此hunk.exe、Hunk等变体同样会被识别并拦截pager.test.ts 专门测试了优先 HUNK_TEXT_PAGER 且避免递归启动 hunk。在实现层面pager 命令通过shell-quote解析为 argv 数组后直接 spawnshell: false不经过 shell 求值支持NAMEvalue前缀与env NAMEvalue pager ...包装形式pager.ts。这意味着你可以安全地使用诸如HUNK_TEXT_PAGERbat --pagingalways这类带参数的命令。Pager 模式的分流细节源码级hunk pager的完整路由逻辑在 startup.ts根据终端环境有四种走向理解它有助于排查为什么没进 review 界面输入/环境行为非 diff 文本 普通终端plain-text-pager交给文本 pager 分页非 diff 文本 TERMdumb或 captured pager hostpassthrough原样透传dumb 终端无法安全地拥有交互式文本 pagerdiff 文本 非 TTY stdoutpassthrough直接透传彩色文本diff 文本 普通交互终端转为kind: patch输入以pager: true选项进入 review 界面diff 文本 captured pager host如 LazyGit可提供 PTY 却声明TERMdumbstatic-diff-pager输出静态彩色 diff而不是启动 TUIcapturedPagerHost的判定会读取环境变量用于识别 LazyGit 等捕获型宿主——它们在自己的面板里渲染 Hunk 的 stdout此时透传应保留 Git 已着色的输出preserveColor: true。这些场景在 startup.test.ts 中均有对应测试非 diff 路由、dumb 终端透传、diff 输入归一化、非交互透传、captured host 静态输出等。配置 Git difftooldifftool 是另一种接入方式Git 为每一对待比较的临时文件调用外部工具Hunk 通过hunk difftool子命令承接。配置命令git config --global diff.tool hunk git config --global difftool.hunk.cmd hunk difftool $LOCAL $REMOTE $MERGED git config --global difftool.prompt false三个配置项的作用diff.tool hunk把默认差异工具设为hunkdifftool.hunk.cmd定义对每个文件对要执行的命令。Git 提供的三个环境变量中$LOCAL是左文件如 HEAD 版本$REMOTE是右文件如工作树版本$MERGED是合并后的显示路径通常带HEAD:前缀等展示信息difftool.prompt false跳过每个文件逐个确认的交互提示连续审查所有文件。配置完成后直接运行git difftooldifftool 与hunk diff的取舍difftool 是**面向文件对pair-oriented**的Git 会为每个文件单独调用一次hunk difftoolHunk 每次只审查一个文件对。因此适合按文件逐个深入审查的场景多个文件之间的连续切换由git difftool驱动配合difftool.prompt false可无打断连续查看。而当你想要 Hunk原生的一整份 changeset 流所有文件作为一次完整 review支持跨文件跳转、目录树浏览、watch 自动刷新等时应优先使用hunk diff如hunk diff --staged而不是 difftool。从命令行解析看hunk difftool的签名是hunk difftool left right [path]cli.ts 与CLI_REFERENCE_COMMANDS.difftool第三个可选参数即来自$MERGED的展示路径。difftool 输入在 review 中会被标记为sourceLabel: git difftool并显示git difftool: path这样的标题loaders.ts。difftool 的 reload 边界需要留意--watch自动刷新在 difftool 模式下的限制。根据 reloadBounds.ts 的边界定义hunk difftool fileA fileB在仓库内执行时reload 边界为仓库根目录根目录外的文件不可重新加载在仓库外执行时边界就是这两个初始文件本身其他文件与所有仓库支持的 reload 均不可用。也就是说git difftool产出的临时文件对适合单次静态审查需要持续跟踪变化的场景应回到hunk diff --watch。撤销集成想要完全移除上述集成Git 提供了对应的反操作git config --global --unset core.pager git config --global --remove-section difftool.hunk--unset core.pager删除全局 pager 设置恢复 Git 默认 pager 行为--remove-section difftool.hunk删除difftool.hunk整个配置节连同其中的cmd同时建议执行git config --global --unset diff.tool移除默认 difftool 指向。如果之前用的是别名方案则逐一删除别名即可git config --global --unset alias.hdiff git config --global --unset alias.hshow如需确认当前生效配置可运行git config --global --list | grep -E pager|difftool|alias检查残留。小结把 Hunk 接入 Git 有两条互补的路径hunk pager做全局或别名式的自动接管依赖 stdin 的 patch 检测自动决定是否打开 review 界面hunk difftool以文件对为单位承接git difftool的逐个调用。前者要理解 plain-text 回退HUNK_TEXT_PAGER→PAGER→less -R与永不递归的防呆设计后者要记住$LOCAL/$REMOTE/$MERGED的变量约定与 pair-oriented 的定位。两者的配置都是几条git config即可完成且都可以随时干净撤销适合在日常 Git 工作流中渐进式引入。相关实现与测试可进一步阅读pager.ts、startup.ts、cli.ts、pager.test.ts、startup.test.ts。赞分享开发工具代码评审CLIAI 应用【免费下载链接】hunkReview-first terminal diff viewer for agentic coders项目地址https://gitcode.com/gh_mirrors/hu/hunk点击查看免费下载相关推荐使用 MCP Toolbox for Databases 将 IDE 接入 Neo4j完整配置指南使用 MCP Toolbox for Databases 将 IDE 接入 Neo4j完整配置指南 本篇指南以 MCP Toolbox for DatabasMCP 服务数据库后端AI 应用将 OpenShift 平台监控指标接入 VictoriaMetricsremote write 完整配置指南将 OpenShift 平台监控指标接入 VictoriaMetricsremote write 完整配置指南 导读 OpenShift Container时序数据库数据库指标监控可观测性后端将 DeepSeek 接入 Claude Code终端与 VSCode 扩展的完整配置实战指南将 DeepSeek 接入 Claude Code终端与 VSCode 扩展的完整配置实战指南 Claude Code 是运行在终端或 VSCode 扩展教程大模型AI Agent上一篇LeetCode-Go 题解137. Single Number II —— 用三进制状态机与位运算找出只出现一次的数字下一篇GraphiQL 数据获取全解使用 graphiql/toolkit 的 createGraphiQLFetcher 打通 HTTP、Multipart 增量交付与 WebSocket 订阅创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考