WebHooker/docs/zh/guide/storage.md

存储布局

KV 存储布局

键模式	值	TTL
config:routes	路由 JSON 数组	永久
config:groups	分组 JSON 数组	永久
session:{id}	管理员会话 { userId, login }	7 天
token:{userId}	{ userId, accessToken, expiresAt, refreshToken? }	0.9 × Token 有效期
token-reverse:{sha256}	用于按 Token 反查的用户 id	0.9 × Token 有效期
state:{hex}	{ redirectTo, expiresAt, discordUserId?, telegramUserId?, telegramChatId? }	600 秒
invite:{token}	{ groupId, role, expiresAt, createdBy, note? }	7 天
invite:group:{id}	每组的 Token 索引（保证邀请列表一致性）	永久
delivery:{id}	Webhook 投递 id（去重标记）	300 秒
delivery:{groupId}:{id}	分组级 webhook 入口的租户级投递去重	300 秒
tenant:{groupId}	分组 webhook secret（64 位 hex，控制台生成）	永久
msg:{routeId}:{key}:{target}	原地更新用消息 id 追踪（如 workflow_run / check_run）	7 天
cmd:guild:{id}	已注册命令的服务器 id（去重）	永久
cmd:registered:global	全局命令注册标记（去重）	1 天
config:discord-app-id	缓存的 Discord 应用 id	永久
i18n:{lang}	叠加在英文之上的翻译覆盖	永久

D1 存储布局

D1 数据库（DB 绑定，数据库 webhooker）包含四张表：

表	用途
send_logs	每次分发尝试一行（路由 id、事件、目标、ok/error、耗时、错误码、详情）
audit_logs	每次管理员操作一行（登录/登出、分组/路由/成员/邀请变更）
discord_links	映射 discord_user_id → github_user_id，供 /gh Discord 命令使用
telegram_links	映射 telegram_user_id → github_user_id，供 /gh Telegram 命令使用

audit_logs 由定时任务在 AUDIT_RETENTION_DAYS（默认 90）后自动清理。行字段说明见日志。