展开知识库目录
批量改名文件：先预览映射、试跑 10 个、再全量
不要直接遍历目录执行重命名。
批量改名前先生成新旧映射
不要直接遍历目录执行重命名。先解析规则、检测重复和非法名称，输出预览；在副本或小批次试跑后再全量，并保留可逆映射。
冻结文件清单
记录绝对或相对路径、大小、时间和必要哈希，排除隐藏、系统、生成和无授权目录。
把涉及的文件、目录、版本、命令和实际输出写进记录；代码变化同时保留 diff 与测试结果。
生成纯映射
只计算旧路径到新路径，不写文件；检查空名、保留字、非法字符、长度和大小写冲突。
确认“生成纯映射”已经有可回查结果，再进入“检测碰撞与链式覆盖”；依据仍然来自猜测时，把缺口单列并停在当前步骤。
检测碰撞与链式覆盖
多个源指向同一目标、A 改 B 而 B 改 C 时使用临时唯一名或分阶段执行。
确认“检测碰撞与链式覆盖”已经有可回查结果，再进入“先试跑 10 个”；依据仍然来自猜测时，把缺口单列并停在当前步骤。
先试跑 10 个
在可恢复副本执行，检查引用、排序和应用兼容；用户确认映射后再扩大。
确认“先试跑 10 个”已经有可回查结果，再进入“全量与回滚”；依据仍然来自猜测时，把缺口单列并停在当前步骤。
全量与回滚
逐项记录成功失败，失败不中途猜修；用反向映射恢复并核对数量。
需要修改时先限定文件和行为范围，无法说明回滚方式或影响面的动作先不执行。 完成后把证据归入“新旧名称映射、试跑和回滚结果”。
完成后应能在“新旧名称映射、试跑和回滚结果”中找到与这一步对应的记录；仍需靠猜测补全，就停在这里。
结果包含映射、异常和回滚验证
脚本幂等且不会重复改已处理文件，目标已存在时停止。没有反向映射和试跑记录，不执行全量。