文件智能整理器

解决什么问题

filie-oranger 面向本地目录中文件类型混杂、临时下载与办公素材互相堆叠的问题。它不做内容理解，而是按扩展名将顶层文件移动到 01_文档、02_图片、03_视频 等分类文件夹，把“先扫一眼判断该放哪里”的重复动作自动化。

核心能力与关键步骤

• 预览优先：先用 --dry-run 展示将要生成的分类结果，确认后再实际移动文件，降低误操作风险。
• 内置 8 大类：覆盖文档、图片、视频、音频、压缩包、安装包、代码、设计稿；未识别文件进入 99_其他。
• 可自定义规则：通过 JSON 配置扩展名到目标文件夹的映射，适配团队命名习惯。
• 生成报告：整理后输出分析报告，便于回溯移动了哪些文件、归入哪些目录。
• 安全细节：默认只处理顶层文件，不递归子目录；重名文件自动加序号；自动跳过 .DS_Store、Thumbs.db、.git 等系统或元数据文件。

适用边界

它适合下载目录、项目素材根目录、临时工作区的批量归类，不适合需要按语义重命名、跨盘迁移、备份恢复或子目录结构重构的场景。若目录包含关键生产文件，应先预览并确认映射规则；Windows 路径建议加引号，例如 "D:\My Documents"。