回滚前提为确认move_log_*.json日志文件存在且完整；方法一用python paperclip.py --rollback命令一键还原；方法二手动提取路径、Excel排序后PowerShell批量逆向移动，并需手动重建缺失的父目录。
确认回滚前提：检查操作记录是否完整
自动整理工具运行失败后，必须先验证回滚依据是否存在——paperclip 工具会在执行前生成一份 JSON 格式的操作日志文件（如 【move_log_20261103_182245.json】），该文件必须未被删除、未被覆盖、且内容可读。若日志文件损坏或缺失，后续所有回滚操作将无法精准还原路径。
打开工具所在目录，查找以 move_log_ 开头、扩展名为 .json 的最新文件；用记事本双击打开，确认首行是 {，末行是 }，且中间包含 "action": "move" 和 "src"/"dst" 字段。没有这个文件，就等于没有“回形针的夹痕”，不能强行回滚。
方法一：使用 paperclip 自带的 rollback 命令一键还原
在终端中进入 paperclip 工具根目录，执行：python paperclip.py --rollback move_log_20261103_182245.json。
这一步会逐条读取日志中的 dst 路径，将文件移回 src 原位置；若原路径已被其他文件占用，工具会自动跳过并记录冲突到 rollback_conflict.log。注意：该命令不支持跨磁盘回滚，即 src 在 C:Desktop、dst 在 D:Docs 时，命令会报错退出，此时需改用方法二。
手动回滚三步走（适用于日志可用但自动回滚失败）
第一步：用 Python 快速提取所有原始路径对。
新建一个 extract_paths.py 文件，写入以下代码并运行：
import json<br>with open("move_log_20261103_182245.json") as f:<br> j = json.load(f)<br>for op in j.get("operations", []):<br> print(f'"{op["src"]}" -> "{op["dst"]}"')
第二步：复制全部输出，在 Excel 中粘贴为两列，A列为源路径，B列为目标路径；选中B列→右键→“排序”→升序，使同一目标文件夹的移动操作集中排列，避免重复创建空文件夹。
第三步：在 PowerShell 中批量执行逆向移动。以管理员身份运行 PowerShell，依次输入（替换为你实际的路径）：
cd /d "D:Docs"<br>Get-ChildItem -Recurse -File | ForEach-Object { $dst = $_.FullName; $src = $dst -replace 'D:\Docs','C:\Users\Me\Desktop'; Move-Item $dst $src -Force }。这一步依赖你准确替换路径前缀，【任何字符错误都会导致文件被移进错误目录甚至丢失】。
当原路径已不存在时：重建父目录再迁移
如果某文件原在 C:DesktopProjectX
eport.docx，但 ProjectX 文件夹已被删除，直接回滚会报错“系统找不到指定路径”。此时不能跳过，必须先恢复结构。
打开日志文件，找到该文件对应条目的 "src" 值，复制其父目录完整路径（不含文件名），例如 C:DesktopProjectX；在资源管理器地址栏中粘贴该路径并回车——Windows 会提示“此文件夹不存在”，点击“新建文件夹”按钮，名称自动填入 ProjectX，按回车确认。
这一步做完，再对该文件单独执行一次 Move-Item "D:Docs
eport.docx" "C:DesktopProjectX
eport.docx" -Force 即可。
