gitlink-cli/skills/gitlink-standup/references/api-reference.md

1.2 KiB
Raw Blame History

gitlink-standup API 参考

前置条件: 先阅读 ../../gitlink-shared/SKILL.md

本技能全程只读。

采集的接口

用户动态

GET /users/:login/project_trends.json?page=<n>&limit=<n>

返回 project_trends[],使用字段:

字段 说明
trend_type 活动类型CommitLog / Issue / PullRequest / VersionRelease
action_type 动作描述(如"创建了代码提交(Commit)"
action_time 相对时间(如"3天前"
name 活动标题(提交信息 / Issue 标题 / PR 标题)

用户信息(可选)

gitlink-cli user +info --login <login> --format json

时间说明

action_time 为相对时间字符串,非精确时间戳,因此本技能按活动条数 + 类型汇总, 通过 --limit 控制采集的近期活动量,而非按精确日期区间过滤。

输出字段JSON

[
  {"login": "wbtiger", "total_activities": 30,
   "by_type": {"CommitLog": 26, "PullRequest": 4},
   "samples": {"CommitLog": ["..."], "PullRequest": ["..."]}}
]

错误处理

某成员动态采集失败时,记为 0 活动,不中断其他成员。