文件整理 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 大类自动分类：

未识别的文件放入 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

工作流程

1. 询问用户要整理的目录
2. 先执行 --dry-run 预览，展示分类结果让用户确认
3. 用户确认后执行实际整理（移动文件到对应文件夹）
4. 如有需要，可生成报告

注意事项

• 默认只处理顶层文件，不递归子目录
• 重名文件自动添加序号（如 file_1.txt）
• 自动跳过系统文件（.DS_Store, Thumbs.db, .git 等）
• Windows 路径使用反斜杠或加引号："D:\My Documents"

CHANGELOG

[1.0.0] - 2026-05-17

新增:

• 初始版本发布
• 支持 8 大类文件自动分类（文档/图片/视频/音频/压缩包/安装包/代码/设计稿）
• 预览模式（--dry-run），先预览再执行
• 文件分析报告功能（--report）
• 自定义分类规则支持（JSON 配置）
• 重名文件自动序号处理
• 系统文件自动跳过