fix: Issue 操作切换到 v1 API，统一使用 project_issues_index 替代数据库 ID #11

wbtiger · 2026-05-12T16:55:44+08:00

wbtiger commented

2026-05-12 16:55:44 +08:00

改动

将 Issue 所有操作从旧版 /api/ 切换到 /api/v1/，使用户可以直接用网页 URL 中的 Issue 编号（project_issues_index）操作 Issue，无需再查找数据库内部 ID。

具体变更

Go 源码（shortcuts/issue/issue.go）：

所有 Issue 操作（list/view/create/update/close/comment）的 API 路径从 /api/ 切到 /api/v1/
flag --id/-i 改为 --number/-n（语义与网页 URL 一致）
create 增加 status_id: 1（v1 API 要求必填）
update/close 的 HTTP 方法从 PUT 改为 PATCH（v1 API 规范）
comment 的请求字段从 content 改为 notes（v1 API 字段名）
comment 路径从 /issues/{id}/journals 改为 /v1/{owner}/{repo}/issues/{number}/journals

Skill 文档：

SKILL.md 和所有 references 文档同步更新 --id → --number
更新 API 路径和字段映射说明

测试

所有 6 个 Issue 命令均已在 Gitlink/gitlink-cli 上实测通过：

issue +list ✅（返回 project_issues_index）
issue +view -n 4 ✅
issue +create ✅（自动设置 status_id/priority_id）
issue +update -n 9 ✅
issue +close ✅
issue +comment -n 4 ✅

认证兼容性

v1 API 认证与旧版完全兼容（均使用 access_token query param），internal/auth/transport.go 无需修改。

Fixes #9

## 改动将 Issue 所有操作从旧版 `/api/` 切换到 `/api/v1/`，使用户可以直接用网页 URL 中的 Issue 编号（`project_issues_index`）操作 Issue，无需再查找数据库内部 ID。 ### 具体变更 **Go 源码（`shortcuts/issue/issue.go`）：** - 所有 Issue 操作（list/view/create/update/close/comment）的 API 路径从 `/api/` 切到 `/api/v1/` - flag `--id/-i` 改为 `--number/-n`（语义与网页 URL 一致） - `create` 增加 `status_id: 1`（v1 API 要求必填） - `update/close` 的 HTTP 方法从 `PUT` 改为 `PATCH`（v1 API 规范） - `comment` 的请求字段从 `content` 改为 `notes`（v1 API 字段名） - `comment` 路径从 `/issues/{id}/journals` 改为 `/v1/{owner}/{repo}/issues/{number}/journals` **Skill 文档：** - SKILL.md 和所有 references 文档同步更新 `--id` → `--number` - 更新 API 路径和字段映射说明 ### 测试所有 6 个 Issue 命令均已在 Gitlink/gitlink-cli 上实测通过： - `issue +list` ✅（返回 project_issues_index） - `issue +view -n 4` ✅ - `issue +create` ✅（自动设置 status_id/priority_id） - `issue +update -n 9` ✅ - `issue +close` ✅ - `issue +comment -n 4` ✅ ### 认证兼容性 v1 API 认证与旧版完全兼容（均使用 `access_token` query param），`internal/auth/transport.go` 无需修改。 Fixes #9

wbtiger added 1 commit 2026-05-12 16:55:45 +08:00

44147bd71a fix: Issue 操作切换到 v1 API，统一使用 project_issues_index 替代数据库 ID

改动：
- Issue 所有操作（list/view/create/update/close/comment）从旧版 /api/ 切到 /api/v1/
- flag --id/-i 改为 --number/-n（与网页 URL 中的 Issue 编号一致）
- create 增加 status_id:1（必填，v1 API 要求）
- update/close 的 HTTP 方法从 PUT 改为 PATCH（v1 API 规范）
- comment 的请求字段从 content 改为 notes（v1 API 字段名）
- comment 路径从 /issues/{id}/journals 改为 /v1/{owner}/{repo}/issues/{number}/journals

Fixes #9

wbtiger added 1 commit 2026-05-12 17:05:10 +08:00

3e1abd8b8a docs: 补充 Issue status_id 映射表（1=新增, 2=正在解决, 3=已解决, 5=关闭）

wbtiger merged commit b49cf8ffda into master

2026-05-12 17:06:29 +08:00

wbtiger referenced this issue from a commit

2026-05-12 17:06:30 +08:00

Merge pull request 'fix: Issue 操作切换到 v1 API，统一使用 project_issues_index 替代数据库 ID' (#11) from wbtiger/gitlink-cli:fix/issue-use-v1-index into master

wbtiger referenced this issue from a commit

2026-07-14 22:54:51 +08:00

Merge pull request 'fix(notification-digest): v2.0.0 修正虚构 notification 命令' (#11) from dw into master

Sign in to join this conversation.

No reviewers