技能介绍

解决的问题

当一批文件来自下载、导出、扫描或多人协作时，文件名经常不符合命名规范：缺少业务前缀、日期后缀残留、大小写混乱、扩展名混在一起。逐个改名容易漏改，也很容易把已经整理好的目录改坏。这个技能面向一个具体场景：在指定目录中批量重命名文件或文件夹，并通过规则组合完成可预览、可回退的改名操作。

技能如何工作

技能先解析用户输入中的关键参数：

target_dir：目标目录路径
targets：处理 files、folders 或 all
rules：重命名规则，多规则用 | 分隔
backup：是否备份，默认开启
recursive：是否递归处理子目录，默认关闭

支持规则包括 prefix、suffix、replace、regex、serial、case、strip、ext 和 recursive。例如 prefix:img_|suffix:_v1|replace:_old:_new 会依次添加前缀、后缀并替换文本；regex:(\d+):part$1 可用于把数字改写为带 part 的格式。默认进入预览模式，先展示将要进行的更改，用户确认 yes 后才执行。执行前会创建带时间戳的备份目录，随后完成重命名并输出成功与失败数量。失败项会被记录并继续处理其他文件，备份目录不受影响。

适用边界与注意点

这个技能适合明确目录范围、明确规则类型的整理任务，不适合需要复杂业务判断或跨目录语义映射的场景。使用 ext 规则时扩展名过滤不区分大小写；使用 serial 时仍会保留原文件名的一部分；正则替换基于 Python re.sub() 语法。由于默认会先预览并备份，生产环境批量整理前仍建议先检查目标目录、备份路径和规则示例。