用途:Hunk 是交互式终端差异查看器,其 TUI 面向用户,代理不应直接运行 hunk diff 或 hunk show 等交互命令,而应通过 hunk session * 命令,经本地守护进程检查和控制实时会话。若无会话,需先请用户在终端启动 Hunk。
主要能力:会话选择支持 --repo <path>(按当前仓库根匹配)、<session-id>(多会话同仓库时指定),唯一会话自动解析;reload 另支持 --session-path 与 --source。检查类命令为 hunk session list/get/context/review,review --json 默认返回文件与代码块结构,--include-patch 才取原始 diff 文本,--include-notes 附带实时评论。导航命令 hunk session navigate 支持绝对定位(需 --file 加 --hunk、--old-line 或 --new-line 之一,均从 1 开始)与相对评论跳转(--next-comment 或 --prev-comment,二者不可同时用)。重载用 hunk session reload,须在 -- 后接 diff 或 show 命令。评论通过 comment add(单条,需 --file、--summary 及一个行目标)或 comment apply --stdin(批量 JSON,先整体校验再写入)添加,另有 list、rm、clear。高亮用 highlight add,--start 为 0 起始含、--end 不含的 UTF-16 偏移,tone 有 match/info/warning/error 等,--focus 可跳转视口;标记在滚动、导航及未改动该文件的 reload 后保留。
使用方式:先用 review --json 了解结构,必要时用 --include-patch 读取具体文件原始 diff,再用 context 与 navigate 对齐用户当前视图,然后评论。批量笔记优先用一次 comment apply。STML 富文本注释仅在 context --json 列出 experimentalFeatures 中的 stml 时可用,且用户须以 --experimental 启动。工作树审查默认含未跟踪文件,可用 --exclude-untracked 排除。
限制:无会话、文件不在审查中、多会话匹配、缺少 -- 分隔符等会报错;comment apply 只从 stdin 读取;highlight add 的 end 必须大于 start。收费、平台与价格信息暂未提供。