68 lines
2.0 KiB
Markdown
68 lines
2.0 KiB
Markdown
# pr +version-diff
|
||
|
||
> **前置条件：** 先阅读 [`../../gitlink-shared/SKILL.md`](../../gitlink-shared/SKILL.md) 了解认证、全局参数和安全规则。
|
||
|
||
查看 Pull Request 指定 patchset/version 的 diff。可选 `--file` 只查看某个文件的 diff，适合 Agent 或维护者针对 review 反馈定位变更。
|
||
|
||
## 命令
|
||
|
||
```bash
|
||
# 查看指定 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>
|
||
```
|
||
|
||
## 典型流程
|
||
|
||
```bash
|
||
# 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-shared/SKILL.md) -- 认证与全局参数
|
||
- [gitlink-pr SKILL.md](../SKILL.md) -- PR 操作总览
|
||
- [pr +versions](gitlink-pr-versions.md) -- 查看 PR patchset/version 列表
|