file-batch-tool 1.2.0

功能强大的文件批量处理工具，支持重命名、图片转换、压缩、分类、加水印、AI助手等

文件批量处理工具

一款基于 PyQt5 的图形化文件批量处理工具，同时也可作为 Python 库被其他项目引用！提供 8 大核心功能，包括批量重命名、图片格式转换、文件压缩、文件分类、图片水印、批量修改文件时间、提取EXIF信息和批量复制/移动。

🌟 项目特性

• 🖼️ 强大的图片处理能力：格式转换、水印添加、EXIF提取
• 📁 全面的文件操作：重命名、压缩、分类、复制、移动
• 🤖 AI智能助手：支持自然语言命令解析
• 🎨 美观的GUI界面：基于PyQt5，简洁易用
• 🚀 高性能处理：多线程异步处理，不阻塞界面
• 📊 实时进度显示：清晰的处理进度和日志
• 🔒 安全可靠：内置文件保护机制
• 🌐 跨平台支持：Windows / Linux / macOS

功能清单

功能模块	说明
批量重命名	前缀/后缀、自动编号、单文件独立设置
图片格式转换	JPG/PNG/WebP 互转，透明通道自动处理
文件压缩	ZIP批量压缩，可排除指定类型
文件分类	按扩展名/日期自动归档
图片水印	文字水印/图片水印，自定义样式
批量改时间	修改创建/修改时间
提取EXIF	导出图片元数据到CSV
复制/移动	批量文件操作

---

安装指南

系统要求

项目	要求
Python	3.8 或更高版本
操作系统	Windows / Linux / macOS
内存	建议 4GB 以上
磁盘	至少 100MB 可用空间

依赖说明

依赖包	版本要求	用途	必需
Pillow	>= 10.0.0	图片处理（格式转换、水印、EXIF提取）	是
PyQt5	>= 5.15.0	GUI图形界面	是

---

安装方法

方法一：从 PyPI 安装（推荐）

# 直接安装
pip install file-batch-tool

# 安装完成后，在命令行运行
file-batch-tool

方法二：从源码安装

步骤 1：克隆项目

# 从 GitHub 克隆
git clone https://github.com/c-the-life/file_batch_tool.git

# 或从 Gitee 克隆（国内更快）
git clone https://gitee.com/the-life/file_batch_tool.git

# 进入项目目录
cd file_batch_tool

步骤 2：创建虚拟环境（推荐）

Windows:

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
venv\Scripts\activate

# 确认 Python 版本
python --version

Linux / macOS:

# 创建虚拟环境
python3 -m venv venv

# 激活虚拟环境
source venv/bin/activate

# 确认 Python 版本
python --version

步骤 3：安装依赖

# 升级 pip 到最新版本
pip install --upgrade pip

# 安装项目依赖
pip install -r requirements.txt

依赖安装详解：

# 安装 Pillow（图片处理库）
pip install Pillow>=10.0.0

# 安装 PyQt5（GUI框架）
pip install PyQt5>=5.15.0

步骤 4：运行程序

# 运行图形界面
python file-batch-tool.py

方法三：开发模式安装

# 克隆项目
git clone https://github.com/c-the-life/file_batch_tool.git
cd file_batch_tool

# 创建并激活虚拟环境
python -m venv venv
venv\Scripts\activate  # Windows
# source venv/bin/activate  # Linux/macOS

# 以开发模式安装（修改代码后无需重新安装）
pip install -e .

# 运行程序
python file-batch-tool.py

---

详细安装步骤（Windows 用户）

1. 安装 Python

1. 访问 Python 官网 下载 Python 3.8+
2. 运行安装程序，勾选 "Add Python to PATH"
3. 打开命令提示符，验证安装：

   python --version
   pip --version
   

2. 下载项目

# 方式1：使用 git
git clone https://gitee.com/the-life/file_batch_tool.git

# 方式2：直接下载 ZIP
# 访问 https://gitee.com/the-life/file_batch_tool
# 点击 "克隆/下载" -> "下载 ZIP"

3. 安装依赖

cd file_batch_tool
pip install -r requirements.txt

4. 运行程序

python file-batch-tool.py

---

详细安装步骤（Linux 用户）

1. 安装系统依赖

Ubuntu / Debian:

sudo apt update
sudo apt install python3 python3-pip python3-venv
# PyQt5 系统依赖
sudo apt install libgl1-mesa-glx libegl1 libxkbcommon-x11-0

Fedora / CentOS:

sudo dnf install python3 python3-pip python3-venv
sudo dnf install mesa-libGL mesa-libEGL libxkbcommon-x11

2. 创建虚拟环境

python3 -m venv venv
source venv/bin/activate

3. 安装项目

git clone https://github.com/c-the-life/file_batch_tool.git
cd file_batch_tool
pip install -r requirements.txt

4. 运行程序

python file-batch-tool.py

---

详细安装步骤（macOS 用户）

1. 安装 Python（如未安装）

# 使用 Homebrew 安装
brew install python3

2. 创建虚拟环境

python3 -m venv venv
source venv/bin/activate

3. 安装项目

git clone https://github.com/c-the-life/file_batch_tool.git
cd file_batch_tool
pip install -r requirements.txt

4. 运行程序

python file-batch-tool.py

---

常见安装问题

问题 1：pip 安装速度慢

解决方案：使用国内镜像源

# 临时使用清华镜像
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

# 永久配置镜像源
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

常用国内镜像：

镜像源	地址
清华	https://pypi.tuna.tsinghua.edu.cn/simple
阿里云	https://mirrors.aliyun.com/pypi/simple
豆瓣	https://pypi.douban.com/simple
中科大	https://pypi.mirrors.ustc.edu.cn/simple

问题 2：PyQt5 安装失败

Windows:

# 尝试指定版本
pip install PyQt5==5.15.9

# 或使用 conda
conda install pyqt

Linux:

# 安装系统依赖后再试
sudo apt install libgl1-mesa-glx libegl1
pip install PyQt5

问题 3：Permission denied（权限不足）

# 使用 --user 参数安装到用户目录
pip install -r requirements.txt --user

# 或使用 sudo（Linux/macOS）
sudo pip install -r requirements.txt

问题 4：Python 版本不兼容

# 检查 Python 版本
python --version

# 如果版本低于 3.8，请升级 Python
# 或使用 pyenv 管理多版本 Python

---

作为 Python 库使用

安装

pip install file-batch-tool

使用示例

from file_batch_tool import batch_rename, batch_convert_image, batch_compress

# 批量重命名
batch_rename("/path/to/files", prefix="processed_")

# 图片格式转换
batch_convert_image("/path/to/images", to_format="webp")

# 文件压缩
batch_compress("/path/to/files", output="archive.zip")

更多 API 文档请查看 API.md

---

技术栈

分类	技术	用途
界面	PyQt5	GUI开发
图片	Pillow	格式转换/水印/EXIF
文件	pathlib, shutil	跨平台文件操作
压缩	zipfile	ZIP打包
时间	datetime	文件时间处理

---

注意事项

1. 重要文件先备份，虽然我们有保护机制，但备份更安全
2. 支持拖拽，直接将文件/文件夹拖入输入框
3. 批量处理时，界面会显示处理进度
4. 权限问题：确保程序有文件读写权限
5. 水印/转换后的文件会自动添加标识前缀/后缀

---

💡 使用技巧

批量重命名技巧

• 按日期重命名：使用 {date} 变量添加日期前缀
• 自动编号：使用 {num} 变量实现自动递增编号
• 正则替换：支持正则表达式进行复杂的字符串替换

图片处理技巧

• WebP格式：推荐使用 WebP 格式，可节省 30-70% 存储空间
• 水印位置：右下角水印通常不会遮挡图片主体
• 批量处理：先对少量图片测试，确认效果后再批量应用

AI助手使用技巧

• 明确指令：用简洁的语言描述任务，例如"将图片文件夹中的所有JPG转换为PNG"
• 分步处理：复杂任务可以拆分为多个简单指令
• 查看示例：参考 examples 目录中的示例代码

---

📚 更多资源

• API文档：查看 API.md 了解所有函数的详细参数
• 教程指南：查看 TUTORIAL.md 学习完整使用流程
• 贡献指南：查看 CONTRIBUTING.md 参与项目开发
• 示例代码：查看 examples/ 目录获取可运行的示例

---

🤝 社区支持

• 问题反馈：在 GitHub Issues 中提交问题和建议
• 功能请求：提出您想要的新功能
• 代码贡献：欢迎提交 Pull Request
• 讨论交流：在 Discussions 中交流使用心得

---

📄 开源协议

MIT License - 可以自由使用、修改和分发

---

如果这个项目对你有帮助，请给个 Star！