项目介绍
EdgeChat 是一个运行在 Cloudflare 生态上的边缘聊天系统，适合团队内部沟通、私有社群和轻量级站内 IM 场景。
它的设计目标很明确：低门槛、低成本、易部署。项目默认不开放公开注册，而是通过管理员邀请或手动创建账号的方式控制用户接入。
核心特性
- 支持群组聊天，包括公开群组和自定义私有群组
- 支持一对一私信
- 新写入的消息和附件使用服务端加密，历史数据不做批量回填
- 管理员后台不提供消息正文搜索或完整会话查看入口
- 管理员可永久封禁用户，或按天、小时、分钟设置临时封禁；到期后无需定时任务即可自动恢复
- 支持文件上传、头像与实时消息
- 支持管理员将公开或私有群组与 Telegram 群聊进行文字、Unicode Emoji 和 16 MiB 内文件双向同步
网站配色
从 2.17.0 起，可在 后台 → 站点外观 → 网站配色 一键应用 奶油樱花粉，也可随时恢复 经典配色。点击即保存，不会顺带保存名称或图标草稿；需要超级管理员或「修改站点外观」权限。
配色覆盖登录、注册、聊天、个人设置和后台，当前窗口立即生效，其他访客刷新后生效。保留个人自定义背景、危险/成功等提示色；目前是浅色配色，不是深色模式。Demo 仅保存到当前页面内存，刷新后恢复，不影响生产。
升级继续使用原有 GitHub Actions，无需新增迁移、环境变量或 Secret。旧站点在主动切换前保持经典配色。
2.17.1 起，奶油樱花粉采用浅粉与雾蓝交融的轻柔渐变，主按钮使用浅底深字，整体更明亮、梦幻。
技术栈
- 前端：Vue 3 + Vue Router + Vite
- 后端：Cloudflare Workers + Hono
- 数据：Cloudflare D1
- 会话：Cloudflare KV
- 文件：Cloudflare R2
- 实时通信：Durable Objects + WebSocket
按任务阅读
初次了解
部署与更新
- Cloudflare API 令牌：创建部署凭据
- GitHub Actions 自动部署：运行工作流、查看部署步骤
- 更新已部署站点：手动同步并部署新版本
- 自动更新：启用每天两次的上游同步
- Cloudflare 资源与用量：查看资源用途与用量
站点配置
- 站点配置：消息自动删除时间、上传限制等后台没有入口的参数
- 附件与存储：开通 R2，修改文件大小与类型
- 语音通话与 TURN：配置中继并测试通话
后台与维护
- 用户与后台权限：建号、分组、封禁与登录记录
- 安装自检与版本检查：查看状态与导出报告
- 管理员初始化与恢复：首次登录和超管恢复
- D1 数据库迁移：备份、规划、执行与验证
- 加密密钥：轮换和保管密钥
- 隐身模式：开启入口认证或恢复后台访问
集成
- Telegram Bridge 集成：连接 Telegram 群聊
- 跨实例群组绑定：在两个 EdgeChat 实例之间同步群消息
客户端与开发
- Android 客户端：安装、构建和发布当前 Capacitor 客户端
- 项目结构：理解代码目录、核心模块与开发入口