gitlink-cli/doc/shortcut-gaps.md

3.9 KiB
Raw Blame History

Shortcut 缺口跟踪

记录 GitLink API 中有端点但尚无 Shortcut 的缺口,按领域组织。

issue

端点 计划 Shortcut 状态
GET /v1/:owner/:repo/issues/:number/journals issue +journals 已实现 (2026-06-02)

repo

端点 计划 Shortcut 状态
GET /:owner/:repo/readme repo +readme 已实现 (2026-06-02)
GET /:owner/:repo/contributors repo +contributors 已实现 (2026-06-02)
GET /:owner/:repo/languages repo +languages 已实现 (2026-06-02)
GET /:owner/:repo/commits repo +commits 已实现 (2026-06-02)
GET /:owner/:repo/tags repo +tags 已实现 (2026-06-02)
GET /:owner/:repo/sub_entries?filepath=...&ref=... repo +raw 已实现 (2026-06-02)

2026-06-03 实测:GET /:owner/:repo/raw/:ref/:path 端点对 API Token 认证返回 403已替换为 sub_entries 端点,从返回的 entries.content 字段提取文件内容。

pr

端点 计划 Shortcut 状态
POST /:owner/:repo/pulls/check_can_merge pr +check-merge 已实现 (2026-06-02)
GET /:owner/:repo/pulls/get_branches pr +branches 已实现 (2026-06-02)

ci

端点 计划 Shortcut 状态
GET /:owner/:repo/ci_authorize ci +authorize 已实现 (2026-06-02)
POST /v1/:owner/:repo/actions/enable ci +enable 已实现 (2026-06-02)
POST /v1/:owner/:repo/actions/disable ci +disable 已实现 (2026-06-02)
POST /:owner/:repo/activate 端点路由存在但后端未实现(返回-1用 actions/enable 替代
DELETE /:owner/:repo/deactivate 端点路由存在但后端未实现(返回-1用 actions/disable 替代

org

端点 计划 Shortcut 状态
GET /organizations/:id/teams org +teams 已实现 (2026-06-02)
POST /organizations/:id/teams org +create-team 已实现 (2026-06-02)
DELETE /organizations/:id/organization_users/:uid org +remove-member 已实现 (2026-06-02)

2026-06-02 通过 gitlink-cli api 对组织 150530 实测:

  • GET teams 返回 teams 数组,支持 page/limit 分页
  • POST teams 返回 403当前用户非 owner端点存在
  • DELETE organization_users 对无效 ID 返回"组织成员不存在",端点存在

user

端点 计划 Shortcut 状态
GET /users/:user_id/headmaps user +headmaps 已实现 (2026-06-02)
GET /users/:user_id/statistics/activity user +stats-activity 已实现 (2026-06-02)
GET /users/:user_id/statistics/develop user +stats-develop 已实现 (2026-06-02)
GET /users/:user_id/statistics/role user +stats-role 已实现 (2026-06-02)
GET /users/:user_id/statistics/major user +stats-major 已实现 (2026-06-02)
GET /users/:user_id/project_trends user +trends 已实现 (2026-06-02)

2026-06-02 通过 gitlink-cli api 对用户 baoerjun 实测:

  • headmaps 返回 headmaps 数组(不支持分页)
  • statistics 拆分为 4 个子端点activity/develop/role/major均可用
  • project_trends 返回动态列表,支持 page/limit 分页(实测 total_count=69

汇总

领域 已实现 端点已验证待实现 端点不存在/后端未实现
issue 1 (+journals) 0 0
repo 6 0 0
pr 2 (+check-merge +branches) 0 0
ci 3 (+authorize +enable +disable) 0 2 (activate/deactivate)
org 3 (+teams +create-team +remove-member) 0 0
user 6 (+headmaps +stats-* 5个 +trends) 0 0
合计 21 0 2