# Smart File Organizer Pro > 智能文件整理助手 Pro - 增强版，支持按日期归档、多模式预设、进度显示、操作历史 - Skill: `dvcrn/smart-file-organizer-pro` (Agent Skill, multi-file: 7 files) - Install (CLI): `npx skillmds@latest add dvcrn/smart-file-organizer-pro` - Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/smart-file-organizer-pro/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: dvcrn (https://skillmd.com/u/dvcrn) - Updated: 2026-09-08 - Page: https://skillmd.com/skills/dvcrn/smart-file-organizer-pro --- # 智能文件整理助手 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/2024_03_12_001.jpg [2/1234] report.pdf → Documents/Work_Report_20240312.pdf [3/1234] song.mp3 → Music/song.mp3 ... ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 💡 这是预览模式，未执行实际操作 💡 要执行整理，请移除 --preview 参数 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ``` ## 操作历史和撤销 ### 查看操作历史 ```bash # 查看最近操作 python3 scripts/history.py --list # 查看操作详情 python3 scripts/history.py --show <操作ID> # 撤销上次操作 python3 scripts/undo.py --last # 撤销指定操作 python3 scripts/undo.py --id <操作ID> ``` ### 备份管理 ```bash # 列出所有备份 python3 scripts/backup.py --list # 恢复指定备份 python3 scripts/backup.py --restore <备份ID> # 清理旧备份 python3 scripts/backup.py --clean --older-than 30 ``` ## 高级功能 ### 智能建议 ```bash # 获取整理建议 python3 scripts/analyze.py --path . # 输出示例: 💡 检测到大量照片文件，建议使用归档模式 💡 发现 23 个可能重复的文件，建议运行去重 💡 建议创建自定义规则: 电子发票 -> Documents/发票 ``` ### 批量处理 ```bash # 整理多个目录 python3 scripts/batch.py --paths ~/Downloads,~/Documents,~/Pictures # 使用配置文件批量处理 python3 scripts/batch.py --config batch_rules.json ``` ### 文件监控 ```bash # 监控目录并自动整理新文件 python3 scripts/watch.py --path ~/Downloads --mode standard ``` ## 故障排除 ### 常见问题 **Q: 中文文件名显示乱码？** ```bash # 设置编码 export PYTHONIOENCODING=utf-8 python3 scripts/organize.py --path . ``` **Q: 权限不足无法移动文件？** ```bash # 使用安全模式 python3 scripts/organize.py --path . --safe-mode ``` **Q: 处理速度太慢？** ```bash # 调整线程数 python3 scripts/organize.py --path . --threads 8 ``` ## 更新日志 ### v2.0.0 (当前版本) - ✨ 新增四种整理模式 - ✨ 新增日期归档功能 - ✨ 新增进度显示 - ✨ 新增操作历史 - ✨ 新增智能建议 - 🚀 性能优化：多线程处理 - 🎨 彩色输出优化 - 📝 更完善的文档 ### v1.0.0 - 基础文件分类功能 - 智能重命名 - 重复文件检测 - 安全备份 --- **智能文件整理助手 Pro** - 让文件管理更智能、更高效！