用途:该技能用于从零构建生产级 Telegram 机器人,覆盖架构选择、框架选择、数据库集成、部署、变现与安全的完整生命周期,并按需提供参考文档。
主要能力:
- 框架选型:Python 侧 aiogram 3.x 适合生产、高负载、异步与 FSM 场景;python-telegram-bot v21 适合简单脚本与新手;TypeScript 侧推荐 grammY,支持无服务器(bot.handleUpdate(req.body))。Telegraf v4 处于维护模式,新项目应用 grammY。
- 架构模式:单体(<1000 DAU)、基于队列(webhook→SQS/RabbitMQ→worker,避免超时并按用户保序)、无服务器(低流量、按量付费,需冷启动<1s 和外部状态)、微服务(>10 万 DAU)。
- Webhook 与轮询对比,以及 Webhook 安全:secret token 校验 X-Telegram-Bot-Api-Secret-Token,可选 IP 白名单(149.154.160.0/20、91.108.4.0/22)。
- 参考文档按需加载:python-aiogram、typescript-grammy、databases、deployment、ai-integration、payments、security。
- 提供 Python 与 TypeScript 目录结构示例,以及上线前校验清单(token 放环境变量、全局错误处理、限流、输入校验、HTML 转义、生产不用 MemoryStorage、优雅退出、typing 指示、消息 4096 字符拆分)。
使用方式:先按决策树选择语言、复杂度、数据库、托管方式,再加载对应参考文档实现。安装命令、依赖版本与完整长代码示例暂未提供。
适用场景:面向 Telegram 平台构建需要数据库、部署、支付与安全防护的生产级机器人。
限制:文中部分版本与时间标注(如 Bot API 10.0、2026 年 5 月、3.28.2、v21.11.1)为资料原文,未能独立核实;具体价格、计费与效果暂未提供。