智能文件整理助手 Pro 🗂️✨
✨ Pro 版本亮点
- - 🚀 多模式预设 - 简洁/标准/深度三种整理模式
- 📅 智能归档 - 按日期自动归档到年/月/日结构
- 📊 进度显示 - 实时显示整理进度和统计
- 📜 操作历史 - 完整的操作日志和撤销记录
- 🎨 彩色输出 - 清晰友好的终端显示
- ⚡ 性能优化 - 多线程处理，更快速度
- 🧠 智能建议 - 根据文件内容给出整理建议
- 🔒 增强安全 - 自动备份、冲突检测、权限检查
快速开始
基本使用
bash
简洁模式 - 快速整理
python3 scripts/organize.py --path . --mode simple
标准模式 - 平衡整理和重命名
python3 scripts/organize.py --path . --mode standard
深度模式 - 完整整理+重命名+去重
python3 scripts/organize.py --path . --mode deep
预览模式 - 查看将要执行的操作
python3 scripts/organize.py --path . --mode standard --preview
按日期归档
bash
按年/月/日归档照片
python3 scripts/organize.py --path ~/Pictures --mode archive --date-format YYYY/MM/DD
按年/月归档文档
python3 scripts/organize.py --path ~/Documents --mode archive --date-format YYYY/MM
自定义规则
bash
使用自定义配置文件
python3 scripts/organize.py --path . --config my_rules.json
只处理特定类型
python3 scripts/organize.py --path . --types jpg,png,pdf
设置输出详细程度
python3 scripts/organize.py --path . --mode standard --verbose
整理模式说明
1. 简洁模式 (simple)
- - 仅按文件类型分类
- 不重命名文件
- 不检测重复文件
- 适合：快速整理、保留原名
2. 标准模式 (standard)
- - 按文件类型分类
- 智能重命名（可选）
- 基础重复检测
- 适合：日常整理
3. 深度模式 (deep)
- - 按文件类型分类
- 智能重命名
- 完整重复检测
- 按日期归档
- 适合：彻底整理
4. 归档模式 (archive)
- - 按日期创建目录结构
- 保持原始文件名
- 自动生成归档报告
- 适合：照片/文档归档
文件分类规则
默认分类
- - 📷 图片 → Pictures/ (jpg, png, gif, webp, bmp, svg, raw, heic)
- 📄 文档 → Documents/ (pdf, doc, docx, xls, xlsx, ppt, pptx, txt, md)
- 🎬 视频 → Videos/ (mp4, mov, avi, mkv, flv, wmv, m4v)
- 🎵 音频 → Music/ (mp3, wav, flac, m4a, aac, ogg)
- 📦 压缩包 → Archives/ (zip, rar, 7z, tar, gz, bz2)
- 💻 代码 → Code/ (py, js, java, cpp, html, css, json, xml)
- 🔧 可执行 → Executables/ (exe, msi, app, dmg)
- 📁 其他 → Others/
按应用来源分类（可选）
- - 🌐 浏览器下载 → Downloads/Browser/
- 💬 社交应用 → Downloads/Social/
- 🎮 游戏 → Downloads/Games/
- 📱 移动应用 → Downloads/Mobile/
命令行参数详解
基本参数
--path <路径> 要整理的目录（默认：当前目录）
--mode <模式> 整理模式：simple/standard/deep/archive（默认：standard）
--preview 预览模式，不实际执行操作
--config <文件> 使用自定义配置文件
整理选项
--types <类型> 只处理指定文件类型（逗号分隔）
--exclude <类型> 排除指定文件类型（逗号分隔）
--rename 启用智能重命名
--deduplicate 启用重复文件检测
--date-format <格式> 日期归档格式（如：YYYY/MM/DD）
安全选项
--backup 整理前创建备份
--no-backup 跳过备份
--dry-run 同 --preview
--safe-mode 安全模式，更保守的操作
输出选项
--verbose 详细输出
--quiet 静默模式
--progress 显示进度条
--report 生成整理报告
配置文件示例
config.json 完整示例
json
{
mode: standard,
分类设置: {
images: [.jpg, .png, .gif, .webp, .heic],
documents: [.pdf, .doc, .docx, .xls, .xlsx],
videos: [.mp4, .mov, .avi],
audio: [.mp3, .wav, .flac],
archives: [.zip, .rar, .7z],
code: [.py, .js, .html, .css, .json]
},
重命名规则: {
启用: true,
保留原始名称: false,
图片模式: IMG
{YYYYMMDD}{序号},
文档模式: DOC
{标题}{日期},
通用模式: FILE
{日期}{序号}
},
归档设置: {
启用: false,
日期格式: YYYY/MM/DD,
使用创建日期: true,
使用修改日期: false
},
重复文件检测: {
启用: true,
检测方法: hash,
处理方式: move,
保留策略: oldest,
重复文件夹: Duplicates
},
安全设置: {
预览模式: false,
自动备份: true,
备份保留天数: 30,
跳过系统文件: true,
跳过隐藏文件: true,
最大文件大小MB: 1024,
安全模式: false
},
性能设置: {
最大工作线程: 4,
显示进度: true,
使用缓存: true
},
输出设置: {
详细程度: normal,
彩色输出: true,
生成报告: true,
日志级别: INFO
}
}
输出说明
终端输出示例
🗂️ 智能文件整理助手 Pro v2.0
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📁 目标目录: /home/user/Downloads
📋 整理模式: 标准模式 (standard)
⚙️ 配置: 预览模式已启用
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⏳ 正在扫描文件...
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 扫描结果:
✓ 总文件数: 1,234
✓ 图片文件: 456
✓ 文档文件: 234
✓ 视频文件: 123
✓ 其他文件: 421
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📋 整理预览:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[1/1234] vacation.jpg → Pictures/20240312_001.jpg
[2/1234] report.pdf → Documents/WorkReport20240312.pdf
[3/1234] song.mp3 → Music/song.mp3
...
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💡 这是预览模式，未执行实际操作
💡 要执行整理，请移除 --preview 参数
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
操作历史和撤销
查看操作历史
bash
查看最近操作
python3 scripts/history.py --list
查看操作详情
python3 scripts/history.py --show <操作ID>
撤销上次操作
python3
