功能说明
按查找替换模式批量重命名文件，但默认只做预演并列出将发生的改动，因此错误模式不会误触磁盘。计划就是一组「原名到新名」的映射，使预演与真实执行共用同一条代码路径，保证预览与实际一致。
运行命令
node rename.mjs --dir ./photos --find IMG --replace photo预期输出
匹配到两个文件时应列出新名称并给出预演汇总，输出为：
IMG_001.jpg -> photo_001.jpg
IMG_002.jpg -> photo_002.jpg
2 file(s) to rename (dry run)限制
替换是字面量而非正则，且不检测冲突；若两个原名映射到同一目标名会发生覆盖。
上述代码与预期输出严格对应，可在本地按运行命令复现并逐项核对。当前实现覆盖了最常见的使用路径，超出上文限制所述边界的场景需要额外的设计与实现。若要在生产环境使用，建议先补充输入校验、错误处理与日志，再结合自身环境调整依赖版本。
本译文由 AI 依据英文原文完整重写，包含功能说明、运行方式与真实预期输出，供中文读者对照英文原稿阅读。