72 lines
2.5 KiB
Markdown
72 lines
2.5 KiB
Markdown
# 🤖 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 Dashboard](https://dash.cloudflare.com) → **Workers & 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` | 更新命令菜单 |
|
||
|
||
--- |