57 lines
1.4 KiB
Markdown
57 lines
1.4 KiB
Markdown
|
# Telegram 用户监听机器人
|
|||
|
|
|
|||
|
|
基于 **Pyrogram Userbot + Bot** 的监听与通知项目：
|
|||
|
|
- Userbot 监听所有群消息
|
|||
|
|
- Bot 负责规则配置与发送通知
|
|||
|
|
|
|||
|
|
## 功能
|
|||
|
|
- `/watch 群ID 用户ID 关键词1 关键词2` 添加监听规则
|
|||
|
|
- `/unwatch 群ID 用户ID` 删除规则
|
|||
|
|
- `/list` 查看所有规则
|
|||
|
|
- `/notify 目标ID` 设置通知目标（不设置则默认通知给你自己）
|
|||
|
|
|
|||
|
|
触发通知包含：群名、用户名、用户ID、关键词、消息内容。
|
|||
|
|
|
|||
|
|
## 运行前准备
|
|||
|
|
1. 在 https://my.telegram.org 申请 `api_id` 与 `api_hash`。
|
|||
|
|
2. 获取 Userbot 的会话字符串（Session String）。
|
|||
|
|
|
|||
|
|
生成 Session String 示例：
|
|||
|
|
```bash
|
|||
|
|
python - <<'PY'
|
|||
|
|
from pyrogram import Client
|
|||
|
|
|
|||
|
|
api_id = int(input("API_ID: "))
|
|||
|
|
api_hash = input("API_HASH: ")
|
|||
|
|
|
|||
|
|
with Client("user", api_id=api_id, api_hash=api_hash) as app:
|
|||
|
|
print(app.export_session_string())
|
|||
|
|
PY
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 本地运行
|
|||
|
|
```bash
|
|||
|
|
pip install -r requirements.txt
|
|||
|
|
|
|||
|
|
export TG_API_ID=123456
|
|||
|
|
export TG_API_HASH=your_api_hash
|
|||
|
|
export TG_BOT_TOKEN=123456:bot_token
|
|||
|
|
export TG_USER_SESSION_STRING=your_user_session_string
|
|||
|
|
|
|||
|
|
python main.py
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Docker 运行
|
|||
|
|
```bash
|
|||
|
|
docker compose up -d --build
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 规则存储
|
|||
|
|
- 默认存储在 `./rules.json`
|
|||
|
|
- 可通过环境变量 `RULES_PATH` 自定义
|
|||
|
|
- 支持多用户独立配置
|
|||
|
|
|
|||
|
|
## 注意事项
|
|||
|
|
- 需要确保 Userbot 已加入目标群
|
|||
|
|
- Bot 需要能够向通知目标发送消息
|