Add Chinese README for Secure File Bot

添加中文 README 文件,详细介绍了私有 Telegram 文件存储机器人的功能、安装步骤和指令说明。
This commit is contained in:
nickdu088
2025-11-03 08:25:31 +11:00
committed by GitHub
parent b7702171a6
commit 271b4432ae

84
README_cn.md Normal file
View 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
└── ...
```