local-file-organizer（本地文件管理器）

本地文件整理虾

核心脚本：scripts/organize_files.py

快速使用

# 预览整理效果（不实际移动）
python3 scripts/organize_files.py ~/Downloads --dry-run

# 执行整理（移动到同目录下的分类子文件夹）
python3 scripts/organize_files.py ~/Downloads

# 整理到指定目标目录
python3 scripts/organize_files.py ~/Downloads ~/Organized

# 整理 + 检测重复文件
python3 scripts/organize_files.py ~/Downloads --find-dups

# 使用自定义规则
python3 scripts/organize_files.py ~/Downloads --rules my-rules.json

工作流程

1. 理解需求 — 确认源目录、目标目录、整理模式（移动/复制/重命名）
2. 预览 — 先用 --dry-run 展示整理计划，让用户确认
3. 执行 — 用户确认后执行实际整理
4. 汇报 — 展示整理统计（移动了多少文件、发现多少重复）

分类规则

默认按扩展名分类到：Documents / Pictures / Videos / Audio / Archives / Code / Others

自定义规则 JSON 格式：

{
  "设计稿": ["psd", "ai", "sketch", "fig"],
  "文档": ["pdf", "docx", "md"]
}

详细规则参考：references/classification-rules.md

重复文件检测

--find-dups 标志启用 MD5 哈希比对，输出重复文件列表。 用户确认后可手动删除，或使用 trash 命令移到回收站（推荐）。

保留策略详见：references/duplicate-detection.md

命名规范

批量重命名时参考：references/naming-conventions.md

支持变量：{date} {name} {ext} {index} {parent}

安全原则

• 默认不删除文件，只移动/复制
• 删除操作前必须用户二次确认
• 优先使用 trash 而非 rm（可恢复）
• 文件名冲突时自动添加序号（file_1.pdf）

已知限制

• 无法处理正在被占用的文件
• 大文件（>10GB）哈希计算较慢，可先用 --quick 模式
• 不支持网络驱动器（NAS/SMB）的实时监控