业务背景

业务文件分散在多个子文件夹时，逐层打开目录并手工移动文件操作重复，也容易遗漏。为便于后续集中查看和处理，需要将各级子文件夹中的文件统一汇总到当前根目录，同时确保文件复制完整后再清理原目录。

需求设计

使用者将程序放入需要整理的专用文件夹并双击运行，核对文件汇总预览和同名覆盖提示后确认执行。完成后在根目录查看汇总文件，并根据程序提示确认原子文件夹的清理结果。

核心业务逻辑

1. 限定处理范围。 程序以自身所在目录为处理根目录；如位于磁盘根目录则禁止执行，避免处理范围过大。
2. 递归盘点文件。 遍历根目录下的全部子文件夹及其下级目录，统计需要汇总的文件数量，并展示每个文件的来源路径和目标位置。
3. 提示覆盖风险。 当根目录已经存在同名文件时，在预览阶段明确标记为覆盖，由使用者决定是否继续。
4. 确认后统一复制。 使用者确认后，将所有子文件夹中的文件按原文件名复制到根目录；任一文件复制失败即停止后续清理。
5. 执行二进制校验。 每次复制后比较源文件与目标文件，并在全部复制结束后再次逐个校验。发现文件缺失或内容不一致时保留原子文件夹并提示失败。
6. 校验通过后清理。 仅在所有源文件都通过最终校验后删除原子文件夹；如删除失败，保留未成功删除的目录并提示使用者处理。

数据安全与权责边界

• 本程序属于桌面小程序，以简易命令行界面存在，已设计最终确认和处理预览以及多重必要的安全拦截逻辑，使用人至少需要做到遵循操作方式以及阅读处理预览并确认，否则程序无法通过枚举穷尽拦截使用人意想不到的不当操作。
• 程序安装并运行在使用者自身计算机，文件读取、处理和结果生成均在本地完成。

交互与业务价值

对比项	原处理方式	程序处理
操作方式	人工逐层打开子文件夹，将文件移动到根目录后再清理目录	将程序放入目标目录，查看预览并确认一次
处理时间	以20个子文件夹估算，人工逐层移动和检查约需20至60分钟	同等目录在5秒以内完成复制校验和清理
差错风险	多层目录操作可能出现文件遗漏、同名覆盖或原目录提前删除	执行前提示覆盖风险，复制后执行两轮二进制校验，通过后才清理目录
结果查看	人工核对根目录文件数量并检查空目录	在预览和完成提示中查看文件来源、目标位置及清理结果