技能介绍

解决的问题

图片文件常散落在多个目录，按文件名、拍摄时间或用途归档时容易漏项、误覆盖、缺少可审计记录。尤其批量 HEIC/JPG 中混杂截图、素材和照片，人工分类成本高，事后又很难说明哪些文件被移动、哪些因损坏或过大被跳过。

技能如何工作

它把图片归档拆成可检查的流程：

递归扫描：识别 jpg、png、gif、bmp、webp、heic、heif 等格式，异常文件单独标注。
双维分类：date-year-month、date-year-month-day 优先读取 EXIF 拍摄日期，无法读取时降级到文件时间；type 模式结合文件名关键词、EXIF 和尺寸规则。
安全操作：支持 move 或 copy，重名文件自动加后缀；move 采用先传后记，未完成项不影响已完成部分。
结构化报告：输出 Markdown 报告，包含操作摘要、全量清单明细和异常项说明，便于粘贴日志或归档。

适用边界与注意点

它适合本地图片文件夹整理，不替代数据库式资产管理。超过 --max-size-mb 阈值的文件仍会处理，但可能只依赖 EXIF 与关键词，跳过像素级检测；依赖 Pillow 与可选 pillow-heif，缺少 HEIF 支持时相关能力会受限。执行前建议先用 --dry-run 预览，再确认 source、mode 和 operation。