gitlink-cli/skills/gitlink-pr/references/gitlink-pr-version-diff.md

pr +version-diff

前置条件： 先阅读 ../../gitlink-shared/SKILL.md 了解认证、全局参数和安全规则。

查看 Pull Request 指定 patchset/version 的 diff。可选 --file 只查看某个文件的 diff，适合 Agent 或维护者针对 review 反馈定位变更。

命令

# 查看指定 patchset/version diff
gitlink-cli pr +version-diff --id 3 --version-id 16040

# 简写
gitlink-cli pr +version-diff -i 3 -v 16040

# 只查看某个文件的 diff
gitlink-cli pr +version-diff -i 3 -v 16040 --file shortcuts/pr/pr.go

# 指定仓库并输出 JSON
gitlink-cli pr +version-diff --owner Gitlink --repo forgeplus -i 3 -v 16040 --format json

参数

参数	必填	说明
--id / -i	是	PR 序号（网页 URL /pulls/N 中的 N，即 pull_request_number）
--version-id / -v	是	patchset/version id，可从 pr +versions 返回结果获取
--file / -f	否	按文件路径过滤 diff，对应 API 查询参数 filepath

API

GET /v1/{owner}/{repo}/pulls/{number}/versions/{version_id}/diff

当传入 --file 时，会附加查询参数：

filepath=<path>

典型流程

# 1. 列出 PR 的 patchset/version
gitlink-cli pr +versions -i 3 --format json

# 2. 选择需要查看的 version id
# 3. 查看该 version 的 diff
gitlink-cli pr +version-diff -i 3 -v 16040

# 4. 如只关心某个文件，使用 --file 过滤
gitlink-cli pr +version-diff -i 3 -v 16040 --file shortcuts/pr/pr.go

注意事项

• --version-id 是 version id，不是 commit SHA。
• 这是只读查询命令，不会修改 PR。
• 如果要审查最新一轮变更，先用 pr +versions 获取最新 version，再调用本命令。

References

• gitlink-shared SKILL.md -- 认证与全局参数
• gitlink-pr SKILL.md -- PR 操作总览
• pr +versions -- 查看 PR patchset/version 列表