文件整理助手

解决什么问题

当目录里混着文档、图片、代码、压缩包和媒体文件时，人工按扩展名归类容易漏项，同名文件冲突和报告缺失也让结果难以复核。file-organizer 面向这种本地目录整理场景，目标不是智能识别文件内容，而是按扩展名做可预期的批量归档。

技能如何工作

用户传入目标文件夹路径后，技能调用 scripts/organize.py 完成整理。核心步骤包括：

• 读取目标文件夹中的文件，跳过已存在的分类子文件夹
• 按扩展名映射到 文档、图片、代码、压缩包、视频、音频、表格、演示 或 其他
• 创建缺失的子文件夹并移动文件
• 处理同名冲突、文件占用和路径异常
• 生成 整理报告_日期时间.txt，并在控制台输出各类数量、总大小和耗时

它支持 --dry-run 预览模式，可以先确认移动计划再执行正式整理。

适用边界

该技能适合按扩展名整理的普通办公目录、项目素材目录或下载目录。若依赖文件内容语义分类、云盘权限、复杂重命名规则或跨目录合并，需要额外处理。移动文件前建议先备份，或使用预览模式确认结果。