Skip to content

About

GitHub/GitCode Webhook 机器人:验签、事件归档、管理面板及 Docker Compose/Cloudflare Tunnel 部署

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

sciencediscovery_bot

以 Webhook 为入口的 TypeScript 事件总线。支持 GitHub App、普通组织/仓库 Webhook 和 GitCode 接入,保存请求与响应,按订阅更新静态看板。使用 Node.js 22+;核心采用标准 Fetch/Web Crypto,并通过 Cloudflare Workers 运行时验证。

正式 Worker 只处理 openJiuwen-ai/sciencediscovery;其他 Webhook 仍完整记录。看板采集在看板仓的 GitHub Actions 中执行,再由 Pages 工作流发布。分析业务当前为占位。

云端只有正式 Worker sciencediscovery-bot,配置是 wrangler.jsonc,由 main 分支经 Workers Builds 发布,见 Worker 自动部署 和 Workers 指南。原测试 Worker 已删除,不再有云端测试版本;改动在本地用 npm test、workerd 测试和浏览器旅程验证。管理入口为同域名 /admin/,必须先配置 Cloudflare Access。

本机快速启动

cp .env.example .env
# 编辑 .env,填写 Webhook 密钥;仅使用隧道时再配置其 token 和 profile。
docker compose up -d --build
  • Webhook:http://127.0.0.1:8791/webhook/github(或 /webhook/gitcode)。
  • 管理面板:http://127.0.0.1:8792/,包含“事件记录”和“监听点”两页。
  • Cloudflare Tunnel 只能转发 http://bot:8791,不能转发 8792。

宿主运行先执行 npm ci,加载 .env 后运行 ./run.sh start;停止使用 ./run.sh stop。配置见部署指南。

Workers 本地适配:npm ci 后复制 .dev.vars.example 为 .dev.vars,运行 npm run workers:local,使用 18891/18892;默认阻止远端请求。云端归档与 Actions 采集的配置、当前边界见 Workers 指南。

文档

整体架构 · 完整目录 · 接入与验签 · 投递记录与查看 · 事件总线与扩展 · 看板更新 · GitHub PR 同步到 GitCode · 管理面板 · 验证指南

新增或修改特性时,同步更新对应文档及目录;仓库维护约定见 AGENTS.md。

About

GitHub/GitCode Webhook 机器人:验签、事件归档、管理面板及 Docker Compose/Cloudflare Tunnel 部署

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages