用途:修复照片和视频中缺失的拍摄时间元数据,把文件系统的 mtime 写入对应元数据标签。
主要能力:检测缺少拍摄时间元数据的图片与视频(包括 HEIF/HEIC);将 mtime 写入 EXIF/XMP/QuickTime 标签;支持备份与 dry-run 预演;提供 discover、filter、write 分阶段执行,以及对不稳定 NAS/SMB 权限的重试机制。
使用方式:需先具备 Python 3 与 exiftool。运行技能目录中的脚本:python <skill-dir>/scripts/fill_missing_exif.py ...。默认安装位置为 Windows 的 %USERPROFILE%.codex\skills\fill-missing-exif,Linux/macOS 的 $HOME/.codex/skills/fill-missing-exif。完整流程示例:python <skill-dir>/scripts/fill_missing_exif.py /data --backup-dir /backup --dry-run。分阶段命令包括 discover、filter、write,可通过 --input/--output 传递中间结果,filter 支持 --scan-workers。确认计划文件与备份路径后再用 -y 执行写入;权限不稳定时可加 --retry-until-success。处理解码错误、损坏文件、权限失败时可参考 references/troubleshooting.md。建议始终先运行 --dry-run。
适用场景:需要为缺失拍摄时间的媒体文件批量补写时间信息的照片、视频整理与归档流程。
限制:依赖 Python 3 与 exiftool;写入前建议先 dry-run 并确认备份;其他具体限制与失败处理细节暂未提供。