根据用户需求生成结构完整的命令行工具规格书，包含目标、边界、…

# 批量重命名仓库照片工具规格书

一、需求背景

物流团队在仓库日常作业中拍摄大量出/入库照片，文件名混乱（如 IMG_0001.JPG），难以与运单对应。需开发批量重命名工具，按“运单号+拍摄时间”规则规范化命名，单批处理约5000张JPG。

二、功能需求

• 批量导入：支持拖拽导入或选择文件夹，递归扫描子目录；单批支持5000张及以上JPG（JPEG/JPG格式），PNG等其他格式可选支持。
• 重命名规则：新文件名 = 运单号 + 分隔符 + 拍摄时间（精确到秒），示例：SF1234567890_20240601-143025.jpg。
• 运单号来源：①按文件夹/分组批量指定；②导入运单号清单（TXT/CSV/Excel）按序或按时间区间匹配。
• 拍摄时间：优先读取EXIF DateTimeOriginal；无EXIF时取文件修改时间，并在报告中标记“时间来源存疑”。
• 冲突处理：同名文件自动追加序号（如 -01），不覆盖原文件。
• 执行方式：提供预览列表（原文件名→新文件名）供人工确认后执行；支持一键撤销（恢复原文件名）。
• 日志与导出：生成处理日志（成功/失败/跳过清单），支持导出CSV对照表（运单号、原文件名、新文件名、拍摄时间）。

三、性能要求

• 5000张JPG单批处理时间控制在分钟级（不含人工确认）。
• 处理过程不修改图像内容，仅改文件名，不得造成画质或EXIF损坏。

四、异常处理

• 运单号缺失、格式非法、文件被占用、损坏JPG等场景：跳过并记录原因，不中断整批任务。
• 断电/中断后可依据日志续跑。

五、验收标准

1. 选取包含5000张JPG的测试集，全部完成重命名且成功率≥99%，失败项均有日志说明。

2. 抽检不少于100张：新文件名格式100%符合“运单号+拍摄时间”规则；有EXIF的文件拍摄时间与实际EXIF一致。

3. 执行撤销操作后，文件名100%恢复原状；重命名前后文件大小、图像内容校验一致（如MD5对比）。

4. 异常用例（缺运单号、重名、损坏文件）均被正确处理并记录，工具不崩溃。

5. 日志与CSV对照表可正常导出，字段完整、可追溯。

6. 运行环境（Windows/macOS，具体版本以团队实际为准）下运行稳定，无卡死现象。

六、交付物

工具程序/脚本、使用说明文档、处理日志模板、验收测试报告。