Files

nickdu088 8305ae4d52 Update README_cn.md for bot file name changes

Updated README_cn.md to reflect changes in file names and descriptions.

2025-11-03 09:47:59 +11:00

2.8 KiB

Raw Blame History

🛡️ 个人专属文件机器人 (aiogram)

一个基于 aiogram 3.x 构建的 私有 Telegram 文件存储机器人。
它只允许指定的 Telegram 用户发送消息、图片、视频和文件，并自动保存到本地文件夹中。

你可以通过 Telegram 命令来 搜索、获取、删除、概览 文件，未来还可集成 OpenAI 或第三方 API。

如何申请Telegram机器人

✨ 功能特点

✅ 访问控制 — 只有配置的 user_id 才能使用机器人。
✅ 自动存储 — 自动保存文本、图片、视频和文件到本地。
✅ 支持所有格式 — JPG、PNG、WEBP、MP4、AVI、MOV 等都能识别。
✅ 搜索与获取 — 支持关键字搜索与快速取回文件。
✅ 删除功能 — 可通过命令删除指定文件。
✅ 概览功能 — 查看所有文件、大小、保存时间。
✅ 可扩展性强 — 方便未来对接 OpenAI 或其他 API。

🧰 安装步骤

1. 克隆项目

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
    └── ...

2.8 KiB Raw Blame History Unescape Escape