一个基于 Cloudflare Worker 的多平台仓库更新监控工具，支持 GitHub、Gitee、GitLab 和 CNB 仓库的代码提交监控、定时检测和通知功能。

点此预览

• 多平台支持：支持同时监控 GitHub、Gitee、GitLab 和 CNB 仓库的代码提交
• 多仓库检测：支持同时监控多个仓库
• 灵活配置：通过环境变量配置仓库和分支
• 定时检测：支持 Cloudflare Cron Triggers 定时触发
• 手动触发：通过 HTTP 请求手动触发检测
• 缓存优化：集成 Cloudflare Cache API 减少 API 调用
• 状态持久化：使用 KV 存储记录上次检测的 commit SHA
• 认证支持：
  • 支持 GitHub Token 认证，提高 API 限流配额
  • 支持 Gitee Token 认证
  • 支持 GitLab Token 认证（支持 gitlab.com 和自托管 GitLab）
  • 支持 CNB Token 认证
• 通知接口：支持 MagicPush 通知
• 限流监控：实时获取 GitHub API 限流状态
• 可视化仪表盘：内置 Web 仪表盘，直观展示所有监控仓库状态

⚠️⚠️部署前先看这里⚠️⚠️

在构建命令处填写：npm install --save-dev wrangler@4,这是必须的，否则会报错，因为构建默认使用的是wrangler@3，不支持自动创建kv命名空间

点此👉👉 👈👈

在 Cloudflare Worker 的设置中配置以下环境变量：

变量名	必填	说明	默认
DEV_MODE	否	是否启用开发模式	true
NOTIFY_ON_FIRST_CHECK	否	首次检测是否通知	false
TZ	否	时区设置	UTC+8

变量名	必填	说明	示例
GITHUB_REPO	否	监控的 GitHub 仓库列表，支持逗号或换行分隔	facebook/react,vuejs/core
GITHUB_BRANCH	否	默认分支名称	main
GITHUB_TOKEN	否	Personal Access Token（提高 API 限流配额）	ghp_xxxxxxxxxxxx
GITHUB_CACHE_TTL	否	缓存过期时间（秒）	300

变量名	必填	说明	示例
GITEE_REPO	否	监控的 Gitee 仓库列表，支持逗号或换行分隔	owner/repo1,owner/repo2
GITEE_BRANCH	否	默认分支名称	master
GITEE_TOKEN	否	私人令牌（提高 API 限流配额）	your-gitee-token
GITEE_CACHE_TTL	否	缓存过期时间（秒）	300

变量名	必填	说明	示例
GITLAB_REPO	否	监控的 GitLab 仓库列表，支持逗号或换行分隔	owner/repo1,owner/repo2
GITLAB_BRANCH	否	默认分支名称	main
GITLAB_TOKEN	否	Private Access Token（提高 API 限流配额）	your-gitlab-token
GITLAB_API_BASE	否	API 基础地址（自托管 GitLab 时需配置）	https://gitlab.example.com
GITLAB_HOST	否	主机地址（用于生成仓库链接，默认 gitlab.com）	gitlab.example.com
GITLAB_CACHE_TTL	否	缓存过期时间（秒）	300

变量名	必填	说明	示例
CNB_REPO	否	监控的 CNB 仓库列表，支持逗号或换行分隔	owner/repo1,owner/repo2
CNB_BRANCH	否	默认分支名称	main
CNB_TOKEN	CNB 监控必填	API 认证 Token	your-cnb-token
CNB_API_BASE	否	API 基础地址	https://api.cnb.cool
CNB_CACHE_TTL	否	缓存过期时间（秒）	300

变量名	必填	说明	示例
MAGICPUSH_URL	否	MagicPush API URL（启用 MagicPush 通知时必填）	https://your-magicpush-api.com/notify
MAGICPUSH_TOKEN	否	MagicPush Bearer Token（启用 MagicPush 通知时必填）	your-magicpush-token

直接访问 Worker 的根路径 /，即可打开监控仪表盘页面：

https://your-worker.your-subdomain.workers.dev/

仪表盘功能：

• 展示所有监控仓库的实时状态
• 统计 GitHub、Gitee、GitLab 和 CNB 仓库数量
• 显示每个仓库的最新 commit SHA
• 自动每 30 秒刷新数据
• 支持手动刷新
• 响应式设计，支持移动端和桌面端

获取仓库列表和状态（无需鉴权，支持跨域）：

GET /api/repos

响应示例：

{
  "code": 200,
  "message": "获取成功",
  "data": {
    "total": 3,
    "github": 2,
    "cnb": 1,
    "repos": [
      {
        "platform": "github",
        "name": "facebook/react",
        "branch": "main",
        "key": "facebook/react@main",
        "latestSha": "abc123...",
        "hasUpdate": false
      },
      {
        "platform": "cnb",
        "name": "owner/repo",
        "branch": "main",
        "key": "cnb:owner/repo@main",
        "latestSha": "abc123...",
        "hasUpdate": false
      }
    ]
  }
}

CORS 支持： 该接口支持跨域请求，可用于第三方应用集成：

fetch('https://your-worker.your-subdomain.workers.dev/api/repos')
  .then(res => res.json())
  .then(data => console.log(data));

注意：手动触发需要设置环境变量 DEV_MODE=true，否则会返回"开发模式已关闭"。

请求说明：

• 使用 /check 路径进行检测
• 使用 /test-notify 路径测试通知

启用开发模式后：

GET /check

检测所有已配置的 GitHub、Gitee、GitLab 和 CNB 仓库。

# GitHub 仓库
GET /check?repo=owner/repo
GET /check?repo=owner/repo@branch

# CNB 仓库
GET /check?repo=owner/repo&type=cnb
GET /check?repo=owner/repo@branch&type=cnb

# 仅检测 GitHub 仓库
GET /check?type=github

# 仅检测 Gitee 仓库
GET /check?type=gitee

# 仅检测 GitLab 仓库
GET /check?type=gitlab

# 仅检测 CNB 仓库
GET /check?type=cnb

添加 notify=true 参数，检测到更新时会发送通知：

GET /check?notify=true
GET /check?repo=owner/repo&notify=true
GET /check?type=cnb&notify=true

测试 MagicPush 通知配置是否正常工作：

# 测试 MagicPush 通知
GET /test-notify

响应示例（通知测试）：

{
  "code": 200,
  "message": "通知测试完成",
  "data": [
    {
      "channel": "magicpush",
      "status": "success"
    }
  ]
}

响应示例（CNB 仓库检测）：

{
  "code": 200,
  "message": "检测完成",
  "data": [
    {
      "repo": "cnb:owner/repo@main",
      "platform": "cnb",
      "hasUpdate": true,
      "latestSha": "abc123...",
      "latestDate": "2026-02-09T15:30:00Z",
      "latestMessage": "Update README",
      "authorName": "John Doe",
      "previousSha": "def456...",
      "isFirstCheck": false,
      "url": "https://cnb.cool/owner/repo",
      "branch": "main"
    }
  ]
}

响应示例（开发模式已关闭）：

开发模式已关闭

HTTP 状态码：403

在 Cloudflare Dashboard 中配置 Cron Triggers：

# 每 30 分钟检测一次
*/30 * * * *

# 每小时检测一次
0 * * * *

# 每天早上 9 点检测一次
0 9 * * *

{
  "code": 200,
  "message": "检测完成",
  "data": [
    {
      "repo": "facebook/react@main",
      "hasUpdate": true,
      "latestSha": "abc123...",
      "latestDate": "2024-01-15T10:30:00Z",
      "previousSha": "def456..."
    },
    {
      "repo": "cnb:owner/repo@main",
      "platform": "cnb",
      "hasUpdate": true,
      "latestSha": "abc123...",
      "latestDate": "2026-02-09T15:30:00Z",
      "latestMessage": "Update README",
      "authorName": "John Doe",
      "previousSha": "def456...",
      "url": "https://cnb.cool/owner/repo",
      "branch": "main"
    }
  ],
  "rateLimit": {
    "limit": "60",
    "remaining": "55",
    "reset": "2024-01-15T11:00:00Z"
  }
}

{
  "code": 500,
  "message": "检测失败",
  "error": "错误详情"
}

本工具使用 MagicPush 作为通知渠道，检测到仓库更新时自动发送通知。

配置环境变量：

• MAGICPUSH_URL：MagicPush API URL
• MAGICPUSH_TOKEN：MagicPush Bearer Token

通知消息以 Markdown 格式发送，type 固定为 markdown。

通知格式（GitHub 仓库更新）：

## GitHub 仓库更新 - owner/repo@branch

- **仓库**：[owner/repo](https://github.com/owner/repo)
- **SHA**：`abc123...`
- **Commit**: fix bug
- **时间**：2026-02-08 12:58:15

通知格式（CNB 构建更新）：

## CNB 构建更新 - owner/repo@main

- **仓库**：[owner/repo](https://cnb.cool/owner/repo)
- **构建 ID**：`abc123...`
- **状态**：✅ success
- **时间**：2026-02-09 15:30:00
- [查看构建详情](https://cnb.cool/build/xxx)

项目内置了一个美观的监控仪表盘，采用现代深色主题设计：

• 深色主题：采用深蓝渐变背景，营造专业的监控面板氛围
• 玻璃拟态：卡片使用毛玻璃效果，提升视觉层次感
• 响应式布局：自适应移动端和桌面端
• 实时状态：状态指示器带有脉冲动画效果
• 自动刷新：每 30 秒自动获取最新数据

1. 顶部导航栏：项目名称、最后更新时间、刷新按钮
2. 统计概览区：总仓库数、GitHub、Gitee、GitLab、CNB 数量、运行状态
3. GitHub 仓库区：网格卡片展示各 GitHub 仓库状态
4. Gitee 仓库区：网格卡片展示各 Gitee 仓库状态
5. GitLab 仓库区：网格卡片展示各 GitLab 仓库状态
6. CNB 仓库区：网格卡片展示各 CNB 仓库提交状态
7. 页脚：版权信息

直接访问 Worker 的 URL 即可：

https://your-worker.your-subdomain.workers.dev/

repo-watcher/
├── src/
│   ├── index.js           # 主入口，Worker 导出
│   ├── handlers/          # 请求处理器
│   │   ├── index.js       # 处理器导出
│   │   ├── check.js       # 检测处理器
│   │   ├── dashboard.js   # 仪表盘处理器
│   │   ├── repos.js       # 仓库列表处理器
│   │   └── test-notify.js # 通知测试处理器
│   ├── services/          # 服务层
│   │   ├── index.js       # 服务导出
│   │   ├── github.js      # GitHub API 服务
│   │   ├── gitee.js       # Gitee API 服务
│   │   ├── gitlab.js      # GitLab API 服务
│   │   ├── cnb.js         # CNB API 服务
│   │   └── notify.js      # 通知服务
│   └── utils/             # 工具函数
│       ├── index.js       # 工具导出
│       ├── parser.js      # 解析工具
│       ├── kv.js          # KV 操作工具
│       └── datetime.js    # 日期时间工具
├── static/
│   ├── dashboard.html     # 仪表盘页面
│   └── favicon.svg        # 网站图标
├── wrangler.toml          # Wrangler 配置文件
├── package.json           # 项目配置
└── README.md              # 项目文档

GitHub 仓库格式：

• owner/repo：使用默认分支
• owner/repo@branch：指定分支

Gitee 仓库格式：

• owner/repo：使用默认分支
• owner/repo@branch：指定分支

GitLab 仓库格式：

• owner/repo：使用默认分支
• owner/repo@branch：指定分支

CNB 仓库格式：

• owner/repo：使用默认分支
• owner/repo@branch：指定分支

GitHub 检测流程：

1. 从 GitHub API 获取最新 commit 信息
2. 从 KV 读取上次记录的 SHA
3. 对比 SHA 判断是否有更新
4. 更新 KV 中的最新 SHA
5. 如果有更新，或首次检测且 NOTIFY_ON_FIRST_CHECK=true，则调用通知函数

Gitee 检测流程：

1. 从 Gitee API 获取最新 commit 信息
2. 从 KV 读取上次记录的 SHA
3. 对比 SHA 判断是否有更新
4. 更新 KV 中的最新 SHA
5. 如有更新，发送通知并更新 KV

GitLab 检测流程：

1. 从 GitLab API 获取最新 commit 信息
2. 从 KV 读取上次记录的 SHA
3. 对比 SHA 判断是否有更新
4. 更新 KV 中的最新 SHA
5. 如有更新，发送通知并更新 KV

CNB 检测流程：

1. 从 CNB API 获取最新 commit 信息
2. 从 KV 读取上次记录的 SHA
3. 对比 SHA 判断是否有更新
4. 更新 KV 中的最新 SHA
5. 如果有更新，或首次检测且 NOTIFY_ON_FIRST_CHECK=true，则调用通知函数

首次检测行为：

• 默认情况：首次检测不会发送通知，仅记录 SHA
• 设置 NOTIFY_ON_FIRST_CHECK=true：首次检测也会发送通知

• 使用 Cloudflare Cache API 缓存 API 响应
• GitHub 缓存：可配置 GITHUB_CACHE_TTL（默认 300 秒）
• Gitee 缓存：可配置 GITEE_CACHE_TTL（默认 300 秒）
• GitLab 缓存：可配置 GITLAB_CACHE_TTL（默认 300 秒）
• CNB 缓存：可配置 CNB_CACHE_TTL（默认 300 秒）
• 减少 API 调用次数，降低限流风险

GitHub 认证：

• 可选 GitHub Token 认证
• 认证后 API 限流从 60 次/小时提升至 5000 次/小时
• 自动检测是否配置 Token 并添加认证头

Gitee 认证：

• 可选 Gitee Token 认证
• 使用 private_token 参数认证
• 认证后可提高 API 限流配额

GitLab 认证：

• 可选 GitLab Token 认证
• 使用 PRIVATE-TOKEN header 认证
• 支持 gitlab.com 和自托管 GitLab 实例
• 自托管需配置 GITLAB_API_BASE 和 GITLAB_HOST

CNB 认证：

• 必须配置 CNB_TOKEN 才能使用 CNB 监控
• 使用 Bearer Token 认证方式
• 支持自定义 CNB API 地址（CNB_API_BASE）

1. GitHub API 限流：未认证请求限制 60 次/小时，建议配置 GitHub Token
2. Gitee API 限制：建议配置 Gitee Token 以提高限流配额
3. GitLab API 限制：自托管 GitLab 可能有不同的限流策略，建议配置 GitLab Token
4. CNB API 限制：CNB Token 必须配置，可能有调用频率限制，请合理设置 CNB_CACHE_TTL
5. KV 存储限制：免费账户有读写次数限制，合理设置检测频率
6. Cron 触发限制：免费账户最多 1 个 Cron Trigger
7. 通知频率：避免过于频繁的通知造成骚扰
8. 开发模式：默认关闭手动触发检测，避免 CDN 回源导致浪费请求次数。如需手动触发，请设置 DEV_MODE=true，测试完成后建议关闭
9. CNB API 兼容性：CNB API 格式可能变化，如遇问题请检查 API 响应格式

MIT License