mcpField
T
telegram

telegram

github.com/itechmeat开发2374 次安装2 周前更新
代码仓库

关于 telegram

面向 Telegram Bot 开发的路由技能，按任务引导至 API、Webhook、aiogram 和 Mini Apps 等参考资料。还整理安全禁忌与近期 Bot API 及 aiogram 变更。

主要功能

  1. 01按任务定位参考文档
  2. 02覆盖 Bot API 与 aiogram 模式
  3. 03提供 Webhook 安全指引
  4. 04列出凭据与回调处理禁忌
  5. 05汇总近期版本变更

适用场景

  1. 01查找 Telegram Bot 的 API 方法
  2. 02配置并保护 Webhook
  3. 03设计 aiogram 处理器与 FSM
  4. 04检查键盘、支付或登录功能

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/itechmeat/llm-code --skill telegram

安装后在 Claude Code 中输入/telegram确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
aiogram-patterns.md
authentication.md
bot-api.md
bot-features.md
bots-overview.md
inline-mode.md
keyboard-design.md
mini-apps.md
payments.md
performance.md
webhooks.md

详细介绍

Telegram（技能路由器）

路由技能：选择与任务匹配的参考资料。

快速导航

任务参考资料
初次接触 Telegram 机器人bots-overview.md
机器人功能概览bot-features.md
API 方法/类型bot-api.md
Webhook 设置与安全webhooks.md
aiogram 3 处理器/FSMaiogram-patterns.md
键盘 UXkeyboard-design.md
内联模式inline-mode.md
Mini Apps（Web Apps）mini-apps.md
付款（Stars）payments.md
身份验证（Login Widget、URL Auth）authentication.md
速率限制与性能performance.md

关键禁令

  • ❌ 同一个机器人不能同时使用轮询和 webhooks
  • ❌ 不要硬编码令牌/密钥——使用环境变量
  • ❌ 不要在 callback_data 或日志中存放密钥
  • ❌ 不要忽略 answer_callback_query——始终进行响应
  • ❌ 不要在 webhook 处理器中执行阻塞任务——使用后台任务
  • ❌ 未经哈希验证，不要信任 Login Widget 数据

完成标准

  • Webhook 处理器验证 X-Telegram-Bot-Api-Secret-Token
  • 键盘：每行最多 2 个按钮，优先考虑移动端
  • 验证回调数据，不要盲目信任
  • 处理器具有幂等性，或实现去重机制

发布说明（3.29.x - 3.31.x / Bot API 10.1 - 10.3）

  • aiogram 3.31.0 新增对 Bot API 10.3 的完整支持，带来丰富消息（富文本块按钮、可展开的块引用、文档块）、临时消息（EphemeralMessageParameters、带有 can_stop/keep_on_stop 的消息草稿）以及新的回复标记控件（DisabledButton、force_reply）。3.30.0 新增对 Bot API 10.2 的支持，3.29.0 新增对 Bot API 10.1 的支持。面向近期版本的 aiogram 开发时，请采用较新的方法/类型架构。
  • 3.31.0 还修复了 webhook 路径上的调度器上下文丢失、Bot API 级别的 parse_mode 未应用于较新的照片/视频实体、实况照片内容类型检测以及特定地区的 i18n 区域设置解析问题；易受攻击的依赖项已升级至修复版本。
  • 3.29.1 修复了验证嵌套联合类型时出现严重的指数级减速问题，因此在修复后的版本线上，复杂的处理器/过滤器模型解析速度快得多。

发布说明（3.28.x / Bot API 10.0）

  • aiogram 3.28.x 新增对 Bot API 10.0 的支持，带来访客模式更新、更丰富的投票/媒体流程、实况照片、反应管理方法以及托管/商务机器人的访问设置。
  • 3.28.1+ 补丁版本线还修复了 InputPollOption.media 验证问题，因此投票/媒体集成应采用较新的架构和经过修复的 aiogram 序列化器行为。

链接

相关技能

评论

支持 Markdown