FileMasterPro - 全能文件夹整理大师

一款具备深度递归扫描、安全白名单、回收站暂存、一键撤销功能的现代化文件夹整理工具。

---

使用方法

FileMasterPro - 商业级文件整理软件使用说明

🎯 软件概述

FileMasterPro 是一款现代化的文件整理软件，具有以下核心功能：

主要功能

1. 智能文件整理 - 自动识别文件类型并分类整理
2. 深度递归扫描 - 支持多层子文件夹扫描
3. 演习模式 - 预览整理效果而不实际执行
4. 白名单保护 - 自动保护系统文件和关键文件夹
5. 回收站功能 - 将垃圾文件安全移动到回收站
6. 一键撤销 - 后悔药功能，随时恢复原状
7. 一键归拢 - 快速整理根目录散落文件

🚀 快速开始

环境要求

• Python 3.13（推荐使用 Microsoft Store 版本）
• 依赖包：customtkinter、send2trash、pyinstaller

安装依赖

# 使用 Python 3.13 的 pip
python3.13 -m pip install customtkinter send2trash pyinstaller

运行软件

# 直接运行
python3.13 FileMasterPro.py

# 或使用 pyinstaller 打包
python3.13 -m PyInstaller --onefile --windowed --name FileMasterPro FileMasterPro.py

📋 功能详解

1. 智能文件整理

• 自动分类：支持图片、文档、安装包、压缩包、视频、音频等10+类别
• 深度扫描：可递归扫描所有子文件夹（默认开启）
• 演习模式：预览整理计划，不实际移动文件

2. 安全保护机制

• 强力白名单：自动保护系统文件夹（Windows、Program Files等）
• 关键后缀保护：保护 .dll、.sys、.exe 等关键系统文件
• 文件夹保护：绝对不移动文件夹，只整理文件

3. 一键归拢功能

• 快速整理：将根目录散落文件统一移动到"根目录待处理_日期"文件夹
• 智能保护：自动跳过关键系统文件和脚本文件
• 演习模式：支持预览归拢计划

4. 后悔药功能

• 自动生成：每次整理后自动生成 undo_it.py 脚本
• 一键恢复：运行 undo_it.py 即可恢复所有文件
• 历史记录：保存完整的移动记录到 organize_history.json

🎨 界面说明

主界面布局

┌─────────────────────────────────────────────────────────┐
│ FileMasterPro - 商业级文件整理软件                      │
├─────────────────────────────────────────────────────────┤
│ 目标文件夹：[路径输入框] [📁 浏览]                      │
│                                                         │
│ [🔍] 深度扫描模式（递归扫描所有子文件夹）               │
│ [🔬] 演习模式（只预览不执行）                           │
│                                                         │
│ [🚀 开始智能整理] [📦 一键归拢] [⏹️ 停止任务] [💊 撤回] │
│                                                         │
│ 📝 操作日志                                             │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ 实时显示整理进度...                                 │ │
│ │                                                     │ │
│ └─────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘

按钮功能

• 🚀 开始智能整理：执行完整的文件整理流程
• 📦 一键归拢：快速整理根目录散落文件
• ⏹️ 停止任务：中断正在进行的整理任务
• 💊 撤回上次操作：撤销最近一次的整理操作

🔧 高级配置

自定义文件分类

在 FileMasterPro.py 中修改 CATEGORY_DICT 字典：

CATEGORY_DICT = {
    '图片': ['jpg', 'jpeg', 'png', 'gif', 'webp', 'bmp', 'ico'],
    '文档': ['pdf', 'doc', 'docx', 'txt', 'ppt', 'pptx', 'xls', 'xlsx', 'csv'],
    # ... 添加或修改分类
}

自定义白名单

修改以下常量来自定义保护规则：

• POWERFUL_EXCLUDE_KEYWORDS：强力白名单关键词
• EXCLUDE_FOLDERS：排除文件夹列表
• CRITICAL_EXTENSIONS：关键文件后缀
• CRITICAL_FILE_KEYWORDS：关键文件名关键词

📊 使用场景

场景1：整理下载文件夹

1. 选择下载文件夹路径
2. 开启深度扫描模式
3. 点击"开始智能整理"
4. 查看整理结果，确认无误

场景2：清理桌面散落文件

1. 选择桌面文件夹路径
2. 点击"一键归拢"
3. 系统自动创建归拢文件夹
4. 手动检查归拢文件夹内容

场景3：安全测试整理计划

1. 开启演习模式
2. 执行整理操作
3. 查看预览结果
4. 确认无误后关闭演习模式重新执行

⚠️ 注意事项

安全第一

1. 备份重要文件：首次使用前建议备份重要文件
2. 使用演习模式：新环境先使用演习模式测试
3. 检查白名单：确保关键文件夹在保护列表中

性能优化

1. 大文件处理：软件会识别并报告超过100MB的大文件
2. 安装包建议：超过500MB的安装包会给出清理建议
3. 内存管理：使用多线程处理，避免界面卡顿

🔍 故障排除

常见问题

1. 界面无法启动

   • 检查 Python 版本是否为 3.13
   • 确认 customtkinter 已正确安装
   • 尝试使用管理员权限运行

2. 整理速度慢

   • 关闭深度扫描模式
   • 减少扫描文件夹数量
   • 检查是否有权限问题

3. 撤销功能失效

   • 确认 organize_history.json 文件存在
   • 检查文件权限
   • 手动运行 undo_it.py 脚本

日志查看

所有操作都会记录在界面日志中，可通过日志排查问题：

• 权限错误：显示为"权限不足"
• 文件错误：显示为"移动文件失败"
• 系统错误：显示为"整理过程中发生错误"

📦 打包发布

使用 PyInstaller 打包

# 打包为单个可执行文件
python3.13 -m PyInstaller --onefile --windowed --name FileMasterPro FileMasterPro.py

# 打包后文件位置
# dist/FileMasterPro.exe

自定义图标

# 添加自定义图标
python3.13 -m PyInstaller --onefile --windowed --icon=icon.ico --name FileMasterPro FileMasterPro.py

📞 技术支持

问题反馈

1. 查看日志文件获取详细信息
2. 检查 Python 版本和依赖包
3. 尝试在测试文件夹中复现问题

功能建议

如需新功能或改进建议，可修改源代码：

• 添加新的文件分类
• 调整界面布局
• 优化整理算法

---

版本: 1.0.0
最后更新: 2026年3月16日
作者: daaimengermengzhu