Hunk 中文教程：让人和 Agent 看同一份终端 Diff

Hunk 把 Git、Jujutsu、Sapling、两个文件或 stdin patch 放进一个终端审查界面。它有多文件侧栏、split/unified 布局、历史浏览和行级评论，也能让 coding agent 通过本地会话读取审查结构、移动焦点和留下意见。它不会替你提交、合并或批准远程 PR。

1. 选一个能核对来源的安装方法

Homebrew、mise、Nix 和官方 release 都有明确的包来源。官方 curl 脚本会安装到 ~/.hunk 并可能修改 shell PATH；只有发布了 SHA256SUMS 且本机有校验工具时才执行校验，否则警告后仍会继续。不要直接管道执行未读脚本。

curl -fsSLo install-hunk.sh https://hunk.dev/install.sh
less install-hunk.sh
DO_NOT_TRACK=1 HUNK_VERSION=0.22.0 \
  sh install-hunk.sh --no-modify-path
~/.hunk/bin/hunk --version

npm 路线需要 Node.js 22+；standalone、Homebrew、mise 和 Nix 不需要 Node.js。x86-64 CPU 还要支持 SSE4.2。

2. 先直接运行，不改全局 pager

cd /path/to/test-repo
hunk diff
hunk show HEAD~1
hunk log

hunk diff 默认包含 working tree 的 untracked 文件。逐个检查侧栏文件、折行、行号、主题、退出后终端状态和大文件占位。管道或重定向时，Hunk 应输出静态文本而不是打开 TUI。

3. watch 与历史各有边界

hunk diff --watch 会观察文件系统并自动刷新；Jujutsu 和 Sapling 当前用轮询。hunk log 可浏览 commit 和选择连续范围，但它仍是只读历史界面，不负责 branch、merge 或 rebase。大仓库先观察 CPU 和文件描述符，再决定是否长期启用 watch。

4. 接 Agent 前先理解本地会话

TUI 启动后会向 loopback session daemon 注册。CLI 使用所有者私有的凭据和签名请求，官方源码在 Unix 上要求运行时目录为 0700、凭据文件为 0600，并拒绝符号链接或非所有者路径。先用结构化输出确认目标会话：

hunk session list
hunk session get --repo .
hunk session review --repo . --json

只有 agent 确实需要原始 diff 时才加 --include-patch。评论、reload 和删除评论会改变当前审查会话；批量操作前先展示计划。代码文件本身由 agent 的其他工具修改，Hunk 主要承担审查定位与意见记录。

5. 仓库扩展按本地代码处理

TypeScript extension 能加命令、VCS backend、pane，也能改写 changeset。用户目录扩展和显式 --extension 都应先读源码；仓库内 .hunk/extensions/ 只在明确信任后加载。临时排查可用 --no-extensions。

6. 更新查询不是完全无网络

curl 安装来源的版本解析、自动更新检查和 hunk update 默认访问 updates.hunk.dev，传请求来源与当前版本；官方文档说不发送安装 ID、仓库、主机名、cookie 或请求体。设置 HUNK_DISABLE_ANALYTICS=1 或 DO_NOT_TRACK=1 后直接查 GitHub。npm 和 Homebrew 则查询各自渠道。

7. 同类对比：Hunk 与 delta

相比 delta，Hunk 有多文件侧栏、交互 history、鼠标操作和 agent 评论会话，适合主动走查整个 changeset；delta 更接近成熟的 Git pager，启动和配置路径简单，也没有本地评论 daemon。只想美化 git diff/git show 时用 delta；要让人和 agent 围绕同一处改动协作时用 Hunk。

8. 最后再接入 Git

先用 alias，避免一次修改影响所有仓库：

git config --global alias.hdiff '-c core.pager="hunk pager" diff'
git config --global alias.hshow '-c core.pager="hunk pager" show'

确认 pager 在 TTY、管道、SSH、tmux 和大 diff 下都正常，再考虑设置 core.pager。回滚前记录原值。

9. 验证状态与商业边界

未验证：release checksum、安装脚本、终端兼容、渲染、VCS adapter、daemon 认证、agent 评论、性能、Windows 和社区扩展。README 底部有带 UTM 的 Modem 赞助链接，但 Hunk 核心没有付费套餐、账户、积分或转售门槛，因此保留并明确披露。

常见问题