附件与存储

启用附件

1. 在 Cloudflare 控制台为部署账户开通 R2。
2. 重新运行 Actions → 00 Deploy Worker。
3. 工作流复用或创建 cfchat-files 存储桶，建立 FILES binding。
4. 回到站点测试文件上传和头像更换。

未开通 R2 时，工作流仍可部署文字聊天；附件上传、读取和 Telegram 文件同步不可用。开通后重新部署即可。

若部署在 R2 检查步骤失败，核对 API Token 的 R2:Edit 权限和账户 ID。只有服务未开通（Cloudflare 错误码 10042）会自动转为无附件部署。

修改上传限制

后台没有上传限制入口。Actions 用户修改 fork 的 wrangler.example.toml；手动部署修改实际使用的 wrangler.toml，然后重新部署：

[vars]
MAX_FILE_SIZE = "10485760"
ALLOWED_FILE_TYPES = "image/,application/pdf,text/"

这是 10 MiB 上限，允许图片、PDF 和文本。请修改已有的 [vars] 字段。

• 大小单位为字节，默认 20 MiB（20971520）。
• 类型按 MIME 前缀匹配，逗号分隔；image/ 允许图片类，application/pdf 允许 PDF。
• HTML、SVG、脚本及 XML 等危险 MIME 仍会被拒绝。
• 空白名单表示放开一般类型过滤，通常保留明确列表即可。

GitHub 同名 Repository Variables 不会被当前工作流读取。通用设置方式见站点配置。

文件如何清理

消息到期后，关联文件进入清理队列，核对仍被消息、头像或图标引用的对象后再删除。未引用上传默认保留 1 天，批次和预算配置见站点配置。

升级前曾保存完整站点图标 URL 的，按站点配置填写 SITE_ORIGINS。

查看占用

后台「存储统计」显示快照，手动扫描后可按来源查看用量。Cloudflare R2 控制台可查看桶级总量与请求统计。