核心用法
File Auto Organizer 是一款命令行文件整理工具，通过 python3 scripts/organizer.py 调用，支持三种核心模式：
- `organize`：综合整理（类型+日期双重维度）
- `by-type`：按文件扩展名归类（图片/文档/视频/压缩包/音频/代码六大类）
- `by-date`：按修改时间分档（今天/昨天/本周/更早）
- `stats`：生成空间占用与文件分布统计报告
默认覆盖常见 30+ 种文件格式，支持 --report 参数输出整理日志。
显著优点
- 零配置开箱即用：预设六大类文件映射，无需编写规则即可处理日常下载
- 纯本地执行：Python 脚本直读直写，无云端上传，隐私可控
- 轻量可扩展：基于文件扩展名与 os.stat 时间戳，逻辑透明，用户可修改 scripts/organizer.py 自定义分类
- 洁癖友好：重复文件检测与报告生成，满足量化整理需求
潜在缺点与局限性
- 无 GUI 界面：纯命令行交互，对非技术用户门槛较高
- 无撤销机制：整理操作直接移动/重命名原文件，误操作后需手动恢复或依赖系统回收站
- 扩展名误判风险：依赖后缀名而非 MIME 类型，伪装扩展名的恶意文件可能被错误归类；代码类扩展名（如
.js.py）若含恶意脚本，执行前无静态扫描 - 无版本控制：覆盖整理可能破坏依赖绝对路径的旧版应用程序或快捷方式
- 权限问题：对系统目录（如
/Applications/Program Files）操作可能因权限不足失败或需 sudo
适合人群
- 开发者、运维人员等习惯命令行的高效用户
- 下载文件夹长期堆积、需要定期批量归类的「整理控」
- 希望本地自动化、拒绝云服务的隐私敏感用户
- 具备基础 Python 能力、能阅读并修改脚本规则的进阶用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| 误删/误移动 | 整理逻辑基于扩展名与时间戳，若文件名含特殊字符或路径过长可能导致异常；建议首次使用前备份 |
| 恶意文件接触 | 脚本本身不执行文件内容，但整理过程中会遍历全部文件，若下载文件夹含利用漏洞的恶意文档（如 Office 宏病毒），整理动作可能触发系统预览/索引，建议先杀毒扫描 |
| 权限提升 | 若用于系统目录需管理员权限，误操作可能破坏系统文件；建议限定在用户目录（`~/Downloads` `~/Desktop`）内使用 |
| 重复文件删除 | `--dedup` 功能（如有启用）基于哈希或文件名匹配，可能误删相似但不同的文件，建议开启前核对规则 |
使用建议
首次运行前先用 stats 子命令预览文件分布，整理时加 --dry-run（如脚本支持）或手动备份目标目录；避免在包含应用程序包（.app .exe 目录）的路径执行批量整理。