88 lines
2.8 KiB
Markdown
88 lines
2.8 KiB
Markdown
# 🛡️ 个人专属TG机器人 (aiogram)
|
||
|
||
一个基于 **[aiogram 3.x](https://docs.aiogram.dev/)** 构建的 **私有 Telegram 文件存储机器人**。
|
||
它只允许指定的 Telegram 用户发送消息、图片、视频和文件，并自动保存到本地文件夹中。
|
||
|
||
你可以通过 Telegram 命令来 **搜索、获取、删除、概览** 文件，未来还可集成 OpenAI 或第三方 API。
|
||
|
||
[如何申请Telegram机器人](https://core.telegram.org/bots/tutorial)
|
||
|
||
---
|
||
|
||
## ✨ 功能特点
|
||
|
||
✅ **访问控制** — 只有配置的 `user_id` 才能使用机器人。
|
||
✅ **自动存储** — 自动保存文本、图片、视频和文件到本地。
|
||
✅ **支持所有格式** — JPG、PNG、WEBP、MP4、AVI、MOV 等都能识别。
|
||
✅ **搜索与获取** — 支持关键字搜索与快速取回文件。
|
||
✅ **删除功能** — 可通过命令删除指定文件。
|
||
✅ **概览功能** — 查看所有文件、大小、保存时间。
|
||
✅ **可扩展性强** — 方便未来对接 OpenAI 或其他 API。
|
||
|
||
---
|
||
|
||
## 🧰 安装步骤
|
||
|
||
### 1. 克隆项目
|
||
|
||
```bash
|
||
git clone https://github.com/yourusername/secure-file-bot.git
|
||
cd secure-file-bot
|
||
```
|
||
### 2. 安装依赖
|
||
```
|
||
pip install aiogram==3.13
|
||
```
|
||
### 3. 配置参数
|
||
|
||
打开 Python 脚本 secure_file_bot_aiogram.py，修改以下变量：
|
||
```
|
||
BOT_TOKEN = "YOUR_BOT_TOKEN_HERE" # 从 @BotFather 获取的机器人 Token
|
||
AUTHORIZED_USER_ID = 123456789 # 你的 Telegram 用户 ID
|
||
STORAGE_DIR = "local_storage" # 本地文件存储目录
|
||
```
|
||
|
||
## 🚀 启动机器人
|
||
```
|
||
python bot.py
|
||
```
|
||
|
||
启动后，在 Telegram 中向机器人发送：
|
||
```
|
||
/start
|
||
```
|
||
|
||
## 💬 指令说明
|
||
|
||
| 命令 | 功能 |
|
||
| ----------------- | ------------------ |
|
||
| `/start` | 初始化机器人并创建存储目录 |
|
||
| `/overview` | 查看所有已保存文件的列表、大小与时间 |
|
||
| `/search <关键词>` | 按名称搜索文件 |
|
||
| `/get <编号>` | 从搜索结果中取回文件 |
|
||
| `/delete <文件名>` | 删除匹配的文件 |
|
||
| *(发送文本、图片、视频或文档)* | 自动保存到本地 |
|
||
|
||
|
||
## 🧠 工作原理
|
||
|
||
* 发送文本 → 自动保存为 .txt
|
||
* 发送图片 → 自动识别并保存为正确格式（JPG、PNG、WEBP...）
|
||
* 发送视频 → 自动识别并保存为正确格式（MP4、AVI、MOV...）
|
||
* 发送文件 → 使用原文件名与 MIME 类型保存
|
||
* 所有内容都会存放在 local_storage/ 文件夹中
|
||
|
||
## 🧩 项目结构示例
|
||
```
|
||
secure_file_bot_aiogram/
|
||
├── bot.py
|
||
├── requirements.txt
|
||
├── README.md
|
||
└── local_storage/
|
||
├── 20251103_140501.txt
|
||
├── 20251103_141012.jpg
|
||
├── 20251103_141223.mp4
|
||
└── ...
|
||
```
|
||
|