Add Chinese README for Secure File Bot
添加中文 README 文件,详细介绍了私有 Telegram 文件存储机器人的功能、安装步骤和指令说明。
This commit is contained in:
84
README_cn.md
Normal file
84
README_cn.md
Normal file
@@ -0,0 +1,84 @@
|
|||||||
|
# 🛡️ Secure File Bot (aiogram)
|
||||||
|
|
||||||
|
一个基于 **[aiogram 3.x](https://docs.aiogram.dev/)** 构建的 **私有 Telegram 文件存储机器人**。
|
||||||
|
它只允许指定的 Telegram 用户发送消息、图片、视频和文件,并自动保存到本地文件夹中。
|
||||||
|
|
||||||
|
你可以通过 Telegram 命令来 **搜索、获取、删除、概览** 文件,未来还可集成 OpenAI 或第三方 API。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ✨ 功能特点
|
||||||
|
|
||||||
|
✅ **访问控制** — 只有配置的 `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 secure_file_bot_aiogram.py
|
||||||
|
```
|
||||||
|
|
||||||
|
启动后,在 Telegram 中向机器人发送:
|
||||||
|
```
|
||||||
|
/start
|
||||||
|
```
|
||||||
|
|
||||||
|
## 💬 指令说明
|
||||||
|
|
||||||
|
| 命令 | 功能 |
|
||||||
|
| ----------------- | ------------------ |
|
||||||
|
| `/start` | 初始化机器人并创建存储目录 |
|
||||||
|
| `/overview` | 查看所有已保存文件的列表、大小与时间 |
|
||||||
|
| `/search <关键词>` | 按名称搜索文件 |
|
||||||
|
| `/get <编号>` | 从搜索结果中取回文件 |
|
||||||
|
| `/delete <文件名>` | 删除匹配的文件 |
|
||||||
|
| *(发送文本、图片、视频或文档)* | 自动保存到本地 |
|
||||||
|
|
||||||
|
|
||||||
|
## 🧠 工作原理
|
||||||
|
|
||||||
|
* 发送文本 → 自动保存为 .txt
|
||||||
|
* 发送图片 → 自动识别并保存为正确格式(JPG、PNG、WEBP...)
|
||||||
|
* 发送视频 → 自动识别并保存为正确格式(MP4、AVI、MOV...)
|
||||||
|
* 发送文件 → 使用原文件名与 MIME 类型保存
|
||||||
|
* 所有内容都会存放在 local_storage/ 文件夹中
|
||||||
|
|
||||||
|
## 🧩 项目结构示例
|
||||||
|
```
|
||||||
|
secure_file_bot_aiogram/
|
||||||
|
├── secure_file_bot_aiogram.py
|
||||||
|
├── requirements.txt
|
||||||
|
├── README.md
|
||||||
|
└── local_storage/
|
||||||
|
├── 20251103_140501.txt
|
||||||
|
├── 20251103_141012.jpg
|
||||||
|
├── 20251103_141223.mp4
|
||||||
|
└── ...
|
||||||
|
```
|
||||||
Reference in New Issue
Block a user