2025-11-29 22:21:29 +08:00
2025-11-29 21:51:42 +08:00
2025-11-29 21:36:37 +08:00
2025-11-29 22:21:29 +08:00
2025-11-29 22:13:24 +08:00

🤖 TPM - Telegram 管理员转发与防骚扰机器人

TPM 是一个基于 Cloudflare Workers 构建的 Telegram 中转机器人, 支持自动消息转发、管理员回复、屏蔽机制、人机验证、关键词拦截、以及远程拦截词表同步。


🚀 功能简介

  • 管理员中转:用户消息自动转发给管理员,管理员可直接回复。
  • 人机验证:首次或超过 3 小时未验证的用户需点击按钮验证。
  • 屏蔽与解封:管理员可 /block /unblock 用户。
  • 关键词过滤:支持本地和远程拦截词(自动定时刷新)。
  • 多语言提示:支持中英文自动识别。
  • 节流提醒:用户等待提示每小时最多出现一次。
  • Webhook 自动注册:支持一键注册、注销、查看。

⚙️ 环境变量

变量名 示例值 说明
ENV_BOT_TOKEN XXX:XXXXXX Telegram Bot Token
ENV_BOT_SECRET secret_value Webhook Secret Token
ENV_ADMIN_UID "123456789" 管理员的 Telegram UID纯数字字符串

🛠️ 部署步骤

  1. 打开 Cloudflare DashboardWorkers & Pages → 新建 Worker
  2. worker.js 全部代码复制进去
  3. 在 “Settings → Variables → Environment Variables” 添加上述三个环境变量
  4. 绑定 KV
    • 命名空间名称任意
    • 绑定变量名固定为:KV
  5. 部署后访问:
    • https://你的域名/registerWebhook 注册 Webhook
    • https://你的域名/debugWebhook 查看绑定状态

🧩 管理员命令

命令 说明
/block 屏蔽用户(需回复用户消息)
/unblock 解除屏蔽(需回复用户消息)
/checkblock 查看屏蔽状态
/addkw <关键词> 添加屏蔽关键词
/rmkw <关键词> 移除屏蔽关键词
/listkw 查看本地关键词
/reloadblock 强制刷新远程拦截词
/listkw_remote 查看远程词表前 100 条
/listkw_all 查看本地 + 远程合并词表
/version 查看当前提示文案版本
/notifytest 测试用户等待提醒内容
/resetnotify <userId> 手动清理某个用户节流键

调试命令

路径 功能
/registerWebhook 重新注册 Webhook
/unRegisterWebhook 注销 Webhook
/debugWebhook 查看当前绑定状态
/setMenu 更新命令菜单

Description
🤖 Telegram 管理员转发与防骚扰机器人
Readme MIT 39 KiB
Languages
JavaScript 100%