git diff-tree 用于直接比较两个 tree 对象的 blob 内容和模式，不经过工作区或暂存区；基本用法为 git diff-tree -r ，关键参数包括 -r（递归）、-t（显示树类型变更）、--no-commit-id（去除提交头信息）、--root（单提交时视为初始提交）、-M（检测重命名）、-C（检测复制）。
git diff-tree 命令的基本用法和关键参数
git diff-tree 是 Git 内部用于比较两个 tree 对象的命令，它不走工作区或暂存区，直接比对 commit 的快照树结构，适合做轻量、精准的文件层级变动分析。默认输出是简略格式（只显示变更类型和路径），必须加 -r 才递归展开子目录，否则只显示顶层 tree 差异。
常用组合：
-
git diff-tree -r <commit1><commit2></commit2></commit1>：列出所有新增、修改、删除、重命名的文件路径 -
git diff-tree -r --name-only <commit1><commit2></commit2></commit1>：只输出变动文件路径，适合配合xargs或脚本处理 -
git diff-tree -r -t <commit1><commit2></commit2></commit1>：额外显示 tree 类型变更（比如某路径从 blob 变成 tree）
区分 --no-commit-id 和 --root 的实际影响
如果不加 --no-commit-id，git diff-tree 默认会在第一行输出类似 commit <hash></hash> 的头信息，这在写自动化脚本时容易干扰解析；加上后，输出纯为差异行，更干净。
--root 只在对比一个 commit 与其父提交（即单个 git diff-tree <commit></commit>）时有意义：它会把该 commit 视为“初始提交”，强制展示所有文件为新增（A 状态）。但对比两个明确 commit 时，--root 无效，也不需要。
典型误用场景：想看某个 commit 引入了哪些新文件，却错误写成 git diff-tree -r --root <commit1><commit2></commit2></commit1>——此时 --root 被忽略，且语义混乱。
识别重命名与复制：-M 和 -C 参数的实际效果
git diff-tree 默认不检测重命名（rename）或复制（copy），即使两个文件内容几乎一样、仅路径不同，也会被当作“删除+新增”两条记录。要启用检测，必须显式加 -M（重命名）或 -C（复制）。
OpenClaw 技能 — 给定一个 GitHub 仓库 URL，自动解析出 owner/repo 名称，发现其中的 YAML/properties 配置文件及其配对的中文字段说明；在 `workspace/{repo}/` 目录下按同步日期（格式为 `YYYY-MM-DD`）创建时间戳子目录；写入 `.openclaw-config-state.json` 状态文件。每次用户提问前，先比对远程仓库当前 ref（如 `main` 或 `master`）的最新提交 SHA 与本地状态文件中记录的 SHA：
注意两点：
-
-M后可跟相似度阈值，如-M70%表示内容相似度 ≥70% 才视为重命名；默认是 50%，太低易误判 -
-C默认不开启内容比较，需搭配--find-copies-harder才真正扫描所有 blob，否则只在已知源文件中找副本 - 重命名检测仅对状态为
R的行生效，不会改变A/D的判定逻辑
示例：git diff-tree -r -M80% <old><new></new></old> 比默认更稳地捕获大文件重命名。
为什么 git diff-tree 比 git diff 更适合结构审计
git diff 会经过工作区/暂存区过滤，受 .gitattributes、textconv、clean/smudge 等影响，还可能因换行符或空白符配置产生假阳性；而 git diff-tree 直接读取 object database 中的原始 tree 和 blob，结果确定、无副作用。
适用场景包括：
- CI 中校验某次 PR 是否意外删掉了配置目录（用
--name-only+grep -q "config/"） - 审计安全合规，确认敏感文件（如
.env）未被提交到历史（git diff-tree -r --no-commit-id <start><end> | grep '\.env$'</end></start>） - 构建增量包时，只打包变动的源文件（
git diff-tree -r --name-only --no-commit-id <old><new> | grep '\.js$'</new></old>）
唯一要注意的是：它不显示行级差异，只管“文件是否存在/路径是否变/类型是否改”。真要看某 JS 文件改了哪几行，还是得切回 git diff。
