Skip to content

日志

发送日志(send_logs

每次分发尝试都会记录到 D1 send_logs 表,并可在控制台(日志标签页)查看。字段:

字段含义
routeId匹配的路由
groupId路由所属分组
event事件类型(如 pushpull_requestcustom
repo仓库全名(存在时)
target消息发送到的目标 id
platformdiscordtelegram
ok发送是否成功
status平台 API 的 HTTP 状态码(适用时)
error失败时的错误信息
errorCode稳定错误码(如 NO_TARGETNO_TOKENRATE_LIMITED
attempts含重试在内的发送次数
durationMs发送耗时
deliveryIdWebhook 投递 id(提供时)
messageId平台消息 id(用于原地编辑)
actor发送者登录名
action事件动作(存在时)
detail附加 JSON 详情(存在时)

控制台的日志标签页列出最近记录(可按分组过滤),并可查看单条完整详情。写入为尽力而为——插入失败不会中断分发。

审计日志(audit_logs

所有管理员操作都会记录到 D1 audit_logs 表,并可在控制台(审计标签页)查看:登录/登出、分组/路由/成员/邀请变更、Token 撤销、安装绑定等。字段:时间戳、操作者(GitHub id + 登录名)、动作、目标类型/id、分组 id、IP 与详情 JSON。

记录由定时任务在 AUDIT_RETENTION_DAYS(默认 90)后自动清理。与发送日志一样,写入为尽力而为。

Webhook 日志频道

分组还可以在 Discord 频道/子区或 Telegram 群组/话题中接收每条 webhook 的摘要消息——见分组 → Webhook 日志频道。这些摘要是尽力发送的,不会记录到 send_logs

基于 MIT 许可发布。