10 KiB

Raw Blame History

gitlink-notification-digest 使用样例

样例 1：手动执行通知摘要

日期：2026-06-03 用户：lindiwen23 CLI 版本：gitlink-cli 0.1.18

执行流程

# Step 1: 获取用户名
gitlink-cli auth status
# → Logged in as lindiwen23

# Step 2: 获取未读通知（status=1）
gitlink-cli api GET "users/lindiwen23/messages.json" --query "status=1&limit=20" --format json
# → 7 条未读，unread_notification=7, unread_atme=0

# Step 3: 获取已读通知（用于趋势分析和回顾）
gitlink-cli api GET "users/lindiwen23/messages.json" --query "status=2&limit=20" --format json
# → 21 条已读

# Step 4: 分类统计、生成摘要报告

关键发现

项目	值
未读通知	7 条
@我未读	0 条
总通知	28 条（7 未读 + 21 已读）
不存在命令	`gitlink-cli notification`（整个子命令不存在）
实际 API	`GET /api/users/{owner}/messages.json`
CLI Bug	`api` 路径以 `/` 开头会被解析为本地文件路径

原始 API 返回（未读 7 条）

{
  "total_count": 7,
  "type": "",
  "unread_notification": 7,
  "unread_atme": 0,
  "messages": [
    {
      "id": 740214, "status": 1,
      "content": "jiangtx在 <b>jiangtx/gitlink-cli</b> 提交了一个合并请求：<b>label 模块新建</b>",
      "notification_url": "https://www.gitlink.org.cn/jiangtx/gitlink-cli/pulls/15347",
      "source": "ProjectPullRequest",
      "created_at": "2026-06-03 00:27:37", "time_ago": "10小时前",
      "type": "notification"
    },
    {
      "id": 740213, "status": 1,
      "content": "jiangtx在 <b>jiangtx/gitlink-cli</b> 提交了一个合并请求：<b>pr 域补全</b>",
      "notification_url": "https://www.gitlink.org.cn/jiangtx/gitlink-cli/pulls/15346",
      "source": "ProjectPullRequest",
      "created_at": "2026-06-03 00:11:48", "time_ago": "10小时前",
      "type": "notification"
    },
    {
      "id": 740178, "status": 1,
      "content": "jiangtx在 <b>jiangtx/gitlink-cli</b> 提交了一个合并请求：<b>repo 域补全</b>",
      "notification_url": "https://www.gitlink.org.cn/jiangtx/gitlink-cli/pulls/15343",
      "source": "ProjectPullRequest",
      "created_at": "2026-06-02 23:29:52", "time_ago": "11小时前",
      "type": "notification"
    },
    {
      "id": 740076, "status": 1,
      "content": "jiangtx在 <b>jiangtx/gitlink-cli</b> 提交了一个合并请求：<b>基础设施修复</b>",
      "notification_url": "https://www.gitlink.org.cn/jiangtx/gitlink-cli/pulls/15336",
      "source": "ProjectPullRequest",
      "created_at": "2026-06-02 16:56:47", "time_ago": "17小时前",
      "type": "notification"
    },
    {
      "id": 740002, "status": 1,
      "content": "<b>CWQ</b> 点赞了你管理的仓库 <b>CWQ/Aether_Lens_System-v0.0.1</b>",
      "notification_url": "https://www.gitlink.org.cn/caoweiqiong",
      "source": "ProjectPraised",
      "created_at": "2026-06-02 15:12:55", "time_ago": "19小时前",
      "type": "notification"
    },
    {
      "id": 738181, "status": 1,
      "content": "<b>Somebird</b> 已加入项目 <b>CWQ/Aether_Lens_System-v0.0.1</b>",
      "notification_url": "https://www.gitlink.org.cn/caoweiqiong/Aether",
      "source": "ProjectMemberJoined",
      "created_at": "2026-06-01 22:22:07", "time_ago": "1天前",
      "type": "notification"
    },
    {
      "id": 738136, "status": 1,
      "content": "<b>Somebird</b> 点赞了你管理的仓库 <b>CWQ/Aether_Lens_System-v0.0.1</b>",
      "notification_url": "https://www.gitlink.org.cn/Somebird",
      "source": "ProjectPraised",
      "created_at": "2026-06-01 20:18:28", "time_ago": "2天前",
      "type": "notification"
    }
  ]
}

分类处理

按 source 字段分类：

source	含义	数量	优先级
`ProjectPullRequest`	项目新 PR（jiangtx/gitlink-cli）	4	P2
`ProjectPraised`	项目被点赞（CWQ/Aether_Lens_System）	2	P3
`ProjectMemberJoined`	新成员加入	1	P3

生成的报告

# 🔔 通知摘要

> 生成时间：2026-06-03 10:18
> 未读通知：7 条 / 总计：28 条

---

## 一、概要

| 类型 | 未读 | 总计 |
|------|------|------|
| 🔴 @提及 | 0 | 0 |
| 🟡 Issue 更新 | 0 | 0 |
| 🟢 PR 更新 | 4 | ~8 |
| 🔵 系统通知 | 3 | ~19 |

---

## 二、需要立即处理（P0）

🎉 无紧急通知。

## 三、今天处理（P1）

无待处理通知。

## 四、本周关注（P2）

| # | 类型 | 仓库 | 内容摘要 | 时间 |
|---|------|------|----------|------|
| 1 | 🟢 PR | jiangtx/gitlink-cli | label 模块新建 (#15347) | 6/3 00:27 |
| 2 | 🟢 PR | jiangtx/gitlink-cli | pr 域补全 (#15346) | 6/3 00:11 |
| 3 | 🟢 PR | jiangtx/gitlink-cli | repo 域补全 (#15343) | 6/2 23:29 |
| 4 | 🟢 PR | jiangtx/gitlink-cli | 基础设施修复 (#15336) | 6/2 16:56 |

## 五、可忽略（P3）

| # | 类型 | 仓库 | 内容摘要 | 时间 |
|---|------|------|----------|------|
| 1 | 🔵 点赞 | CWQ/Aether_Lens_System-v0.0.1 | CWQ 点赞了仓库 | 6/2 15:12 |
| 2 | 🔵 成员 | CWQ/Aether_Lens_System-v0.0.1 | Somebird 加入项目 | 6/1 22:22 |
| 3 | 🔵 点赞 | CWQ/Aether_Lens_System-v0.0.1 | Somebird 点赞了仓库 | 6/1 20:18 |

## 六、通知趋势

| 时间段 | 通知数 |
|--------|--------|
| 今日（6/3） | 2 |
| 昨日（6/2） | 3 |
| 本周（6/1-6/3） | 8 |

## 操作建议

- 建议标记已读：3 条 P3 通知
- 需要回复/处理：0 条 P0/P1 通知

经验总结

gitlink-cli notification 命令不存在：GitLink CLI 没有内置 notification 子命令，所有操作需通过 gitlink-cli api 调用 Raw API
API 端点是 messages 不是 notifications：GitLink 用「消息」术语
CLI 路径 Bug：gitlink-cli api 的 PATH 参数以 / 开头会被解析为本地文件路径，必须去掉前导 /
响应字段 unread_notification 和 unread_atme：顶层统计字段可直接用于分类计数，无需遍历全部消息
没有批量已读 API：标记已读需逐条调用 POST users/{owner}/messages/{id}/read
source 字段 PullReuqestAtme：官方 API 存在拼写错误（应为 PullRequestAtme），匹配时注意

样例 2：通过 Agent 调用 Skill（自动摘要）

日期：2026-06-03 调用方式：Agent(subagent_type="general-purpose", prompt="请调用 gitlink-notification-digest skill，帮我整理通知。")

Agent 自主执行的命令序列

工具调用 1: Read  → ../gitlink-shared/SKILL.md              ← 遵循 Skill 前置条件
工具调用 2: Bash  → gitlink-cli auth status                  ← 获取用户名
工具调用 3: Bash  → gitlink-cli api GET "users/lindiwen23/messages.json"
                      --query "status=1&limit=20" --format json   ← 获取未读
工具调用 4: Bash  → gitlink-cli api GET "users/lindiwen23/messages.json"
                      --query "status=2&limit=20" --format json   ← 获取已读（趋势分析）
工具调用 5: Bash  → gitlink-cli api GET "users/lindiwen23/messages.json"
                      --query "limit=20" --format json            ← 获取全部（总计统计）

Agent 决策过程

Agent 正确遵循了 skill v2.0.0 的工作流：

先读取 gitlink-shared/SKILL.md 了解认证和全局参数
用 auth status 获取当前用户 lindiwen23
使用 Raw API（路径无前导 /）获取未读、已读、全部三类数据
按 source 字段分类：ProjectPullRequest → P2，ProjectPraised/ProjectMemberJoined → P3
按输出模板生成结构化报告，含所有七个章节
主动询问是否需要标记 P3 通知为已读

共消耗 35,601 tokens，6 次工具调用，耗时 51.7 秒。

Agent 生成的报告

# 通知摘要

> 生成时间：2026-06-03 10:30
> 未读通知：7 条 / 总计：28 条（含已读 21 条）
> @我未读：0 条

## 一、概要

| 类型 | 未读 | 总计 |
|------|------|------|
| @提及 | 0 | 0 |
| Issue 更新 | 0 | 0 |
| PR 更新 | 4 | 7 |
| 系统通知 | 3 | 21 |

## 二、需要立即处理（P0）
无紧急通知。

## 三、今天处理（P1）
无待处理通知。

## 四、本周关注（P2）
4 条 jiangtx/gitlink-cli 的 PR 需关注

## 五、可忽略（P3）
3 条 CWQ/Aether_Lens_System-v0.0.1 的点赞和成员通知

## 六、通知趋势
| 时间段 | 通知数 |
|--------|--------|
| 今日 | 2 |
| 昨日 | 3 |
| 本周 | 7 |

## 七、近期已读回顾
| 类型 | 内容 | 时间 |
|------|------|------|
| 加入项目 | 加入 jiangtx/gitlink-cli | 06-01 |
| 成员加入 | wyxttn 加入 yetja/灵枢 | 05-29 |
| PR 合并 | 帮助中心 PR 已通过 | 05-13 |
| 角色变更 | 帮助中心角色改为管理员 | 05-13 |

## 操作建议
- 建议标记已读：3 条 P3 通知
- 需要关注：4 条 P2 通知

验证结论

✅ skill v2.0.0 验证通过：

Agent 正确使用了 gitlink-cli api 而非不存在的 gitlink-cli notification
Agent 路径没有以 / 开头，避开了 CLI 路径解析 Bug
Agent 按 source 枚举值正确分类，识别出 PullReuqestAtme 拼写异常
Agent 正确区分了 P0/P1/P2/P3 优先级
Agent 使用 unread_notification/unread_atme 顶层字段快速统计
Agent 生成了趋势章节和已读回顾章节
报告结构完整，七个章节覆盖全部模板要求

异常场景速查

场景	检测方式	处理
`notification +list` 命令不存在	运行 `gitlink-cli notification` 报错	改用 `gitlink-cli api GET "users/{owner}/messages.json"`
API 返回 HTML 而非 JSON	响应以 `<!doctype html>` 开头	去掉路径前导 `/` 重试
未读通知 > 返回条数	`total_count` > `messages.length`	追加 `--query "page=2"`
用户名不确定	`auth status` 输出	从输出中提取 login 字段
无未读通知	`unread_notification == 0`	输出 "🎉 所有通知已处理完毕"

版本兼容性说明

本 skill v2.0.0 基于 gitlink-cli 0.1.18 编写。关键变更：

版本	`notification` 子命令	实际 API	标记已读
v1.0.0	`notification +list`（虚构）	不存在	`notification +read-all`（虚构）
v2.0.0	无此子命令	`GET /api/users/{owner}/messages.json`	`POST /api/users/{owner}/messages/{id}/read`

当 CLI 版本更新后，重新验证可用命令：

gitlink-cli --help

10 KiB Raw Blame History Unescape Escape