文件整理 Skill
自动按文件类型智能归类整理目录中的文件，支持预览和自定义规则。
快速使用
1. 预览整理效果（推荐先预览）
python scripts/organize_files.py <目录路径> --dry-run
示例：
# 预览整理下载文件夹
python scripts/organize_files.py D:\Downloads --dry-run
# 预览整理桌面
python scripts/organize_files.py C:\Users\Lenovo\Desktop --dry-run
2. 执行实际整理
# 确认预览无误后，去掉 --dry-run 执行
python scripts/organize_files.py D:\Downloads
3. 生成文件分析报告
# 分析目录中的文件类型分布
python scripts/organize_files.py D:\Downloads --report -o report.txt
分类规则
脚本内置 8 大类自动分类：
| 分类 | 文件夹 | 包含扩展名 |
|---|---|---|
| 文档 | 01_文档 |
.pdf, .doc, .docx, .txt, .xls, .xlsx, .ppt, .csv, .md 等 |
| 图片 | 02_图片 |
.jpg, .png, .gif, .svg, .webp, .psd, .ai 等 |
| 视频 | 03_视频 |
.mp4, .avi, .mkv, .mov, .wmv, .flv 等 |
| 音频 | 04_音频 |
.mp3, .wav, .flac, .aac, .ogg 等 |
| 压缩包 | 05_压缩包 |
.zip, .rar, .7z, .tar.gz, .iso 等 |
| 安装包 | 06_安装包 |
.exe, .msi, .dmg, .deb, .apk 等 |
| 代码 | 07_代码 |
.py, .js, .java, .cpp, .html, .css, .json 等 |
| 设计稿 | 08_设计稿 |
.psd, .ai, .sketch, .fig, .xd 等 |
未识别的文件放入 99_其他。
命令行参数
python organize_files.py <目录> [选项]
参数:
目录 要整理的目录路径 (默认: 当前目录)
选项:
--dry-run 预览模式，只显示分类结果不执行操作
--copy 复制文件而不是移动 (保留原文件)
--report 生成文件分析报告 (不执行整理)
-o, --output 报告输出文件路径
-c, --config 自定义分类规则 JSON 文件
-q, --quiet 静默模式
自定义分类规则
创建 JSON 配置文件自定义分类：
{
"我的文档": {
"extensions": [".pdf", ".docx", ".txt"],
"folder": "我的文档"
},
"照片": {
"extensions": [".jpg", ".png", ".cr2", ".nef"],
"folder": "照片"
}
}
使用自定义规则：
python scripts/organize_files.py D:\Photos -c my_rules.json
工作流程
- 询问用户要整理的目录
- 先执行
--dry-run预览，展示分类结果让用户确认 - 用户确认后执行实际整理（移动文件到对应文件夹）
- 如有需要，可生成报告
注意事项
- 默认只处理顶层文件，不递归子目录
- 重名文件自动添加序号（如
file_1.txt） - 自动跳过系统文件（
.DS_Store,Thumbs.db,.git等） - Windows 路径使用反斜杠或加引号：
"D:\My Documents"
CHANGELOG
[1.0.0] - 2026-05-17
新增:
- 初始版本发布
- 支持 8 大类文件自动分类（文档/图片/视频/音频/压缩包/安装包/代码/设计稿）
- 预览模式（--dry-run），先预览再执行
- 文件分析报告功能（--report）
- 自定义分类规则支持（JSON 配置）
- 重名文件自动序号处理
- 系统文件自动跳过
