安装自检与版本检查
运行安装自检
- 用超级管理员账号进入后台。
- 打开左侧底部「安装与维护」。
- 手动运行检查，查看每项状态。
- 需要排查时导出 JSON 诊断报告，连同部署日志提供给维护者。
页面检查 D1 连通性、迁移记录与表/列/索引/触发器，另检查会话 KV、可选 R2、六个 Durable Objects 和必要环境变量。报告不包含密钥值，Demo 结果为模拟。
这是只读检查，不执行迁移、清库或 GC。检查通过后，再实际测试登录、收发消息与附件，确认业务可用。
检查失败如何处理
| 结果 | 下一步 |
|---|---|
| 缺少迁移或结构 | 查看 00 Deploy Worker 日志，按D1 迁移处理 |
| KV 或 D1 不可达 | 核对 Cloudflare 资源绑定与服务状态 |
| R2 未绑定 | 按附件与存储开通并重新部署 |
| 环境变量缺失 | 核对站点配置及相关 Secret |
结构检查核对对象是否存在，环境检查核对变量是否存在；写入、解密和定时投递通过实际功能测试确认。无法登录时直接查看 Cloudflare 和 Actions 日志。
检查版本更新
在后台「站点外观」找到版本更新区域，点击「检查更新」。浏览器将当前部署提交与 GitHub 仓库分支比较；真正更新按更新站点操作。
Actions 自动记录仓库、分支和 SHA。手动部署从已推送的干净 Git 提交构建，可准确识别版本。
检查依赖公开 GitHub 仓库和匿名 API 配额。私有仓库、未推送提交或 API 限流时会显示无法准确检查。
查看存储用量
在「存储统计」查看已保存快照；有扫描权限的管理员可启动扫描，按用户、Telegram 和未知来源查看附件占用。扫描有分页和频率限制，会产生 R2 list 用量。