fix pull request number issue

This commit is contained in:
wbtiger 2026-05-12 14:28:30 +08:00
commit 00f72bccf7
7 changed files with 30 additions and 30 deletions

View File

@ -36,18 +36,18 @@ gitlink-cli pr +list --owner Gitlink --repo forgeplus --state open
# 创建 PR源分支必须有实际代码变更
gitlink-cli pr +create --title "feat: 新增搜索功能" --head feature/search --base master --body "实现了全文搜索"
# 查看 PR 详情(使用 pull_request_id
gitlink-cli pr +view --id 14200
# 查看 PR 详情(使用 pull_request_number即网页 URL 中的序号
gitlink-cli pr +view --id 3
# 合并 PR支持 merge/rebase/squash
gitlink-cli pr +merge --id 14200
gitlink-cli pr +merge --id 14200 --method squash
gitlink-cli pr +merge --id 3
gitlink-cli pr +merge --id 3 --method squash
# 关闭 PR拒绝合并
gitlink-cli pr +close --id 14200
gitlink-cli pr +close --id 3
# 查看变更文件(含 diff 内容)
gitlink-cli pr +files --id 14200
gitlink-cli pr +files --id 3
```
## 创建 PR 的完整流程
@ -124,7 +124,7 @@ gitlink-cli api GET /:owner/:repo/pulls/get_branches
- GitLink 的默认分支通常是 `master`(非 `main`),创建 PR 时注意 `--base` 参数
- 合并 PR 前建议先用 `pr +view` 确认状态
- **PR 创建要求源分支与目标分支有实际代码差异**,否则返回"分支内容相同,无需创建合并请求"
- PR 查看/合并/关闭需要使用 `pull_request_id`(从 `pr +create` `pr +list` 返回)
- PR 查看/合并/关闭需要使用 `pull_request_number`(即网页 URL `/pulls/N` 中的序号,从 `pr +list` 返回)
- `pr +merge` 默认使用 merge 方式,可通过 `--method` 指定 rebase 或 squash
- `pr +diff` 实际调用 `/pulls/:id/files` 端点,返回变更文件列表和 diff 内容
- `pr +list``--state` 参数open/merged/closed仅影响统计计数API 返回的列表可能包含所有状态的 PR

View File

@ -8,22 +8,22 @@
```bash
# 关闭 PR
gitlink-cli pr +close --id 14200
gitlink-cli pr +close --id 3
# 简写
gitlink-cli pr +close -i 14200
gitlink-cli pr +close -i 3
```
## 参数
| 参数 | 必填 | 说明 |
|------|------|------|
| `--id` / `-i` | 是 | PR 编号(`pull_request_id` |
| `--id` / `-i` | 是 | PR 序号(`pull_request_number` |
## API
```
POST /{owner}/{repo}/pulls/{id}/refuse_merge
POST /{owner}/{repo}/pulls/{number}/refuse_merge
```
## Workflow

View File

@ -92,7 +92,7 @@ gitlink-cli api PUT /:owner/:repo/update_file --body '{
- **源分支与目标分支必须有实际代码差异**,否则 API 返回 "分支内容相同,无需创建合并请求"
- GitLink 默认主分支为 `master`(非 `main``--base` 默认值为 `master`
- `create_file``content` 字段**必须 base64 编码**,不编码会返回 "文件已存在" 错误
- 创建成功后返回的 `pull_request_id` 用于后续 view/merge/close 操作
- 创建成功后返回的 `pull_request_number` 用于后续 view/merge/close 操作
- 关联已有 Issue 时,把 Issue 编号或 URL 写入 PR `--body`,或用 `issue +comment` 在 Issue 下补充 PR 链接;不要为了关联 PR 直接用 Raw API 更新 Issue 描述
## References

View File

@ -8,28 +8,28 @@
```bash
# 查看变更文件
gitlink-cli pr +files --id 14200
gitlink-cli pr +files --id 3
# 简写
gitlink-cli pr +files -i 14200
gitlink-cli pr +files -i 3
# JSON 格式
gitlink-cli pr +files -i 14200 --format json
gitlink-cli pr +files -i 3 --format json
# pr +diff 是等效别名
gitlink-cli pr +diff -i 14200
gitlink-cli pr +diff -i 3
```
## 参数
| 参数 | 必填 | 说明 |
|------|------|------|
| `--id` / `-i` | 是 | PR 编号(`pull_request_id` |
| `--id` / `-i` | 是 | PR 序号(`pull_request_number` |
## API
```
GET /{owner}/{repo}/pulls/{id}/files
GET /{owner}/{repo}/pulls/{number}/files
```
## 注意事项

View File

@ -41,7 +41,7 @@ GET /{owner}/{repo}/pulls?state={state}&page={page}&limit={limit}
- `0` = open
- `1` = merged
- `2` = closed
- 返回的每条 PR 包含 `pull_request_id` 字段,用于 `pr +view`、`pr +merge`、`pr +close` 等操作
- 返回的每条 PR 包含 `pull_request_number` 字段(即网页 URL `/pulls/N` 中的序号),用于 `pr +view`、`pr +merge`、`pr +close` 等操作
## References

View File

@ -8,26 +8,26 @@
```bash
# 默认 merge 方式合并
gitlink-cli pr +merge --id 14200
gitlink-cli pr +merge --id 3
# 使用 squash 方式
gitlink-cli pr +merge -i 14200 --method squash
gitlink-cli pr +merge -i 3 --method squash
# 使用 rebase 方式
gitlink-cli pr +merge -i 14200 -m rebase
gitlink-cli pr +merge -i 3 -m rebase
```
## 参数
| 参数 | 必填 | 说明 |
|------|------|------|
| `--id` / `-i` | 是 | PR 编号(`pull_request_id` |
| `--id` / `-i` | 是 | PR 序号(`pull_request_number` |
| `--method` / `-m` | 否 | 合并方式:`merge`、`rebase`、`squash`(默认 `merge` |
## API
```
POST /{owner}/{repo}/pulls/{id}/pr_merge
POST /{owner}/{repo}/pulls/{number}/pr_merge
Body: { "do": "merge" }
```

View File

@ -8,30 +8,30 @@
```bash
# 查看 PR 详情
gitlink-cli pr +view --id 14200
gitlink-cli pr +view --id 3
# 简写
gitlink-cli pr +view -i 14200
gitlink-cli pr +view -i 3
# JSON 格式输出
gitlink-cli pr +view -i 14200 --format json
gitlink-cli pr +view -i 3 --format json
```
## 参数
| 参数 | 必填 | 说明 |
|------|------|------|
| `--id` / `-i` | 是 | PR 编号(`pull_request_id`,从 `pr +list``pr +create` 获取) |
| `--id` / `-i` | 是 | PR 序号(`pull_request_number`,即网页 URL `/pulls/N` 中的数字,从 `pr +list` 获取) |
## API
```
GET /{owner}/{repo}/pulls/{id}
GET /{owner}/{repo}/pulls/{number}
```
## 注意事项
- `--id` 使用的是 `pull_request_id`,可从 `pr +list``pr +create` 的返回结果中获取
- `--id` 使用的是 `pull_request_number`(网页 URL 中的序号),可从 `pr +list` 返回的 `pull_request_number` 字段获取
- 返回内容包含 PR 标题、描述、状态、源/目标分支、作者等详细信息
- PR 状态字段 `pull_request_status``0` = open, `1` = merged, `2` = closed
- 建议在执行 `pr +merge``pr +close` 前先用 `pr +view` 确认 PR 当前状态