一、用途与准备
批量修改父目录下的子文件夹名称，支持文字替换、完全匹配、统一名称、前后缀、位置插入、大小写转换和连续编号。可以复制后改名，或直接原地改名；支持递归处理及最近原地改名批次的撤销。
请使用工具箱 1.5.0 或更新版本，并联网登录有插件使用权的账号。首次打开需要联网确认授权；文件夹处理在本机完成，不上传文件内容，无需安装其他软件。
处理前请先备份重要文件夹，并关闭占用文件夹或内部文件的软件。 撤销不能代替备份。
插件不修改内部文件的名称和内容。文件夹没有扩展名，例如 项目.v2 中的 .v2 也属于名称，不会被单独拆开处理。
二、认识界面
操作页：选择父目录、选择处理模式、加载文件夹、查看实时预览、开始、暂停、继续、取消和撤销原地改名。
配置页：上方“名称组合”配置统一命名、插入、大小写、前后缀及编号；下方“规则列表”配置按顺序执行的文字替换。
配置项采用标签与控件同行的紧凑布局，数字框按内容收窄；窄窗口自动减少列数，配置区可滚动。
顶部保留返回、置顶和版本显示。操作按钮完整显示在列表上方；空间不足时按钮和模式开关自动换行，不与列表重叠。
三、选择父目录与处理模式
“待处理文件夹”应选择目标子目录的父目录。例如处理 D:\资料\旧项目，应选 D:\资料。父目录本身不改名，里面的普通文件不加入任务。
可以点击“选择”、输入绝对路径或拖入目录。拖入列表区域后会直接扫描。尚未配置规则也可以先加载，目标名称保持空白。
复制并重命名
关闭“原地改名”时使用此模式：
必须选择已经存在的“保存文件夹”。
只对源父目录第一层子文件夹应用名称规则。
完整复制内部内容，但不修改内部文件名和更深层目录名。
没命中规则、名称没有改变的目录也会复制。
源目录保持不变；保存目录不能等于源目录或位于源目录内部。
不覆盖已有目标，不合并同名目录。
已完成副本会保留；不提供通过删除副本来实现的撤销。
原地改名
开启“原地改名”后不需要保存目录，直接修改源目录中的子文件夹名称。名称未变的项目保留原名。
包含子文件夹
开启后自动开启并锁定“原地改名”，扫描各层子目录。执行时先处理最深层，再向上处理父目录，避免父目录先改名导致后续路径失效。递归模式不支持复制。
四、配置名称组合
至少设置一项有效命名能力即可开始，不必为了加前缀或编号而额外添加替换规则。
命名方式与大小写
保留原名称：在原名称上处理。
使用统一名称：先使用填写的统一文字，再执行替换、插入等规则。多个目录使用同一名称时通常应配合编号。
大小写：保持不变、全部大写、全部小写、首字符大写、首字符小写。
忽略匹配大小写：同时用于下方所有文字替换规则；默认关闭。
首字符转换只改变第一个字符，不改其余字符。例如 AbC 首字符小写后为 abC。
前后缀与位置插入
前缀添加到名称最前面；后缀添加到名称末尾。
插入文字可放在指定字符之前，位置从 1 开始。
开启“插入到末尾”后不再使用位置数值。
插入位置可以是名称长度加 1，即插入到最后；不能超过这个范围。
单个 emoji 按一个字符计算，超出位置会提示错误，不自动改变插入位置。
例如 ABC 第 2 个位置插入 新，得到 A新BC。
连续编号
支持起始值、正步长、补零位数、编号位置及连接符。
起始值：0～999999999 的整数。
步长：1～999999999 的整数。
补零：最少显示 1～12 位，不截断更长编号。
连接符：默认
-，可以留空。编号位置：整个名称前、整个名称后、主体后且位于后缀前。
编号范围可选：
编号在预览时固定，不会因为执行采用深层优先顺序而重新分配。 例如有 A/Child、A、B，整批按路径分配时 A 是 1、A/Child 是 2、B 是 3；实际仍先处理 Child。
五、配置文字替换规则
下方规则列表可添加多条规则。每条包含：顺序、匹配模式、关键词、替换内容和删除按钮。
关键词不能留空或全部为空白；替换内容留空表示删除命中的文字。
默认区分大小写，开启上方“忽略匹配大小写”后不区分。
不支持正则表达式或通配符。
首尾空格参与匹配，输入时注意不要误加空格。
从上到下逐条执行，后一条基于前一条处理后的结果继续判断。
例如第一条包含匹配“旧 → 新”，第二条完全匹配“新项目 → 完成”，则“旧项目”最终变为“完成”。较长、更具体的关键词通常应放前面，避免先被短关键词改写。
完整执行顺序
取原名或统一名称 → 从上到下执行文字替换 → 位置插入 → 大小写转换 → 组合前后缀与编号。
前后缀是最后添加的，不会被前面的大小写或替换规则再次改写。不会自动截断过长名称，也不会自动编号解决未开启编号时的目标重名。
六、加载、预览与开始
选择待处理父目录，设置递归和处理模式。
点击“加载文件夹”，确认列表范围。
在配置页设置命名组合和可选的文字替换规则。
回到操作页，已加载列表会随规则修改立即更新目标名，无需重新扫描。
检查目标名和错误提示，再点击“开始处理”。
确认窗口显示数量、模式、文字替换规则、名称组合与编号范围。确认已经完成备份后点击“我已备份”；取消不处理。
正式执行前会按最新配置重新扫描并进行完整预检。
改变源目录或递归范围后需重新加载；修改保存目录、处理模式或规则时会重新计算预览。清空只清任务列表，不删文件夹，也不清保存的规则。
七、暂停、继续、取消与失败
暂停、继续在可暂停操作边界生效，不强行中断单次系统操作。
取消停止后续处理；已完成的复制或改名保留，不自动整批恢复。
当前复制失败或取消时清理未完成的临时副本，已完成副本保留。
当前原地改名失败时尝试恢复该目录原名；恢复失败会显示具体原因。
单个项目失败会记录错误并继续后续项目；整批预检失败则不开始。
返回、切换插件或退出宿主时，由宿主提示中止未完成部分。
进度按目录处理阶段显示，不是按复制字节精确计量。状态筛选只改变显示，不改变本次队列。
八、撤销原地改名
点击“撤销原地改名”，再次确认后恢复最近原地改名批次的原名称。
包含正常完成批次，也包含取消或失败批次中已经成功改名的项目。
递归恢复先还原父目录，再还原其内部子目录，不丢失父子路径关系。
记录保存在插件数据中，重新打开后仍可撤销。
不修改文件内容；不提供多级撤销历史。
撤销过程中可暂停、继续或取消；已恢复的项目保留，剩余记录可继续撤销。
复制模式没有改动源目录，不提供删除已有副本的撤销。
撤销前会检查整个记录中的目录身份和恢复目标。原名称被占用，或目录被移动、删除、替换、变成链接时，会拒绝，不覆盖或合并其他内容。只编辑内部文件不会被当成文件夹身份替换，撤销仍只恢复目录名称。
撤销完成后，若需再处理，请重新加载目录。
九、安全限制与排错
以下情况会阻止预检或执行：
路径不是有效绝对目录，目录不存在，或扫描/复制遇到不允许的链接及特殊文件。
没有有效命名能力，或替换规则关键词为空。
目标名称为空、包含
< > : " / \ | ? *或控制字符，或以空格、点结尾。使用
CON、PRN、AUX、NUL、COM1、LPT1等保留名称。名称超过系统上限或完整路径过长；不会自动截断。
同一位置目标重复，包括只相差大小写；或目标已经存在。
开始前目录状态变化，撤销记录无法保存，或当前账号无修改权限。
不能通过规则直接交换两个已有目录的名称；目标被另一个目录占用时会拒绝。执行中不要手动移动、删除或重新命名任务目录。
十、旧配置升级
有效源目录、保存目录、处理模式和文字替换规则继续保留；新增命名组合默认保持原名称，编号默认关闭。早期全局匹配模式仍迁移到各条旧规则。
插件只使用手动规则，不读取旧 Excel 配置。早期 Excel 路径和名称截断设置不再生效。旧版本不认识本版新增命名组合及撤销记录，回退后应重新检查配置，不能直接沿用新规则执行。