iamLiquidX/telegram-clone-worker
# 技术雷达学习卡：Telegram Clone Worker
一、一句话定位
基于 Cloudflare Workers + D1 的无服务器 Telegram 频道克隆工具，支持历史消息回填和实时同步，完全运行在免费层内。
二、核心技术/架构亮点
1. 无服务器全栈：Worker 处理 API 与 Cron 定时任务，D1（SQLite）持久化任务、机器人令牌和缓冲区，前端 React 19 SPA 作为管理界面。
2. 双模式同步：历史回填（精确区间或“最近N条”）+ 1分钟轮询实时同步，中间使用缓冲区确保顺序。
3. 智能限流与自愈：自动检测 429、401（令牌失效）、409（Webhook 冲突），暂停/恢复机器人，多机器人原子锁避免碰撞。
4. 精细过滤：按媒体类型（视频/文档/照片/音频）和文件大小阈值筛选，实时显示匹配/跳过日志。
5. 零泄漏安全：机器人令牌仅存于 D1，HMAC-SHA256 会话令牌无需数据库查询。
三、适用场景与目标用户
- 场景：迁移大型频道历史（10万+条）、维护实时镜像、按条件选择性转发（只复制大文件或特定类型）。
- 用户：Telegram 频道管理员、需要自托管服务且希望在 Cloudflare 免费额度内运行的开发者。
四、可动手动作
1. 一键部署：点击 README 中的 Deploy to Cloudflare Workers 按钮，绑定 Workers 和 D1。
2. 配置机器人：在 @BotFather 创建机器人，获取令牌；在 Worker 环境变量或控制台设置 `ADMIN_PASSWORD` 用于后台安全。
3. 创建回填任务：通过 Dashboard 指定源频道、目标频道、消息 ID 范围或最近 N 条，设置过滤条件。
4. 最佳实践：每个大规模回填任务使用独立机器人令牌，避免单令牌被限流冻结。
五、学习优先级
P2（观念了解） —— 该项目完整展示了如何用 Serverless + SQLite 实现实时流水线、限流自愈和单页管理，适合学习 Cloudflare Workers 架构和 Telegram Bot 集成的最佳实践，但非日常必上手工具。⌂