AI File Sorter 安全操作手册：Dry Run 预览与持久撤销 Undo 全解

AI 应用大模型本地部署桌面应用【免费下载链接】ai-file-sorterCross-platform desktop application for content-aware file organization and renaming. Supports local and remote LLMs, preview-based workflows, and fully user-controlled changes.项目地址https://gitcode.com/gh_mirrors/ai/ai-file-sorter点击查看免费下载AI File Sorter 是一款跨平台的AI 文件整理桌面应用支持本地与远程 LLM对文件进行分类和重命名。它的核心安全设计是Dry Run 预览与持久撤销 Undo任何文件移动之前都可以先空跑一遍查看计划每次真实排序都会自动生成撤销计划即使关闭对话框甚至重启应用随时都能一键还原。三层安全网先预览再执行可撤销AI File Sorter 把改错文件的风险拆成了三道防线新手记住这张表即可安全层入口位置作用️ Dry Run 预览审查确认对话框中的 Dry run 复选框只生成 From → To 计划一个文件都不动 逐项人工审查同一对话框的表格每行可单独勾选/取消分类和文件名可手工改↩️ 持久撤销 Undo顶部菜单 Edit → Undo last run依据已保存的撤销计划把文件移回原处官方对这三者的定位很明确AI 只给出建议和分类在你确认之前不会发生任何移动或重命名见 README.md 开头的说明。如何开启 Dry Run 预览勾选一个复选框零文件移动完成分析后弹出的Review and Confirm审查确认对话框就是安全操作的指挥中心。开启预览只需两步勾选左上角的Dry run (preview only, do not move files)复选框照常点击Confirm and Process按钮。此时程序会完整走一遍整理流程包括目标路径冲突处理、唯一化命名但所有移动都被替换为记录。执行结束后它会弹出一个专门的Dry run preview对话框展示全部计划日志中同样只记录 Dry run completed. No files were moved.。 预览模式结束后对话框保持可操作状态你可以取消勾选 Dry run 直接转为真实执行也可以先在表格上微调分类再重跑一次预览。如何读懂 Dry Run 预览表From 与 To 两列预览表结构极简每行一个待移动文件From 列当前文件名悬停可看完整源路径To 列目标位置形如类别\子类别\建议文件名悬停可看完整目标路径。建议的读表方法先看To 列的目录前缀是否都落在你预期的类别下对图片文件注意区分仅重命名目标与源在同一目录与移动重命名目标带类别目录发现某行分类不满意别点 Close直接回到审查表格修改该行后重新预览。真实排序之后撤销计划是如何自动保存的一旦你未勾选 Dry Run完成了真实排序程序会为本次运行写下一份持久化的撤销计划文件undo_plan_日期_时间.json存放在配置的 undo 目录中。计划里每个文件都记录了源路径与目标路径文件大小与修改时间mtime稳定标识stable identity与修订标记revision token用于跨存储后端如 OneDrive识别文件。保存逻辑见 UndoManager.cpp。这份计划不随对话框关闭而失效——这就是持久撤销的含义。撤销时程序采用best-effort尽力而为策略对每个文件做多重校验见 UndoManager.cpp校验项不通过时的行为目标位置文件仍存在跳过该文件写入原因原位置没有被同名新文件占用跳过避免覆盖大小、修改时间一致跳过防止还原已被改动过的文件标识/修订标记一致跳过任何跳过的文件都不会被强行移动结果汇总为 Restored X file(s). Skipped Y.并逐条列出原因——安全优先宁可不动。撤销最后一次运行三步完成还原打开顶部菜单Edit → Undo last run对应 MainApp.cpp 中的undo_last_run确认对话框会显示即将使用的计划文件路径点 OK弹窗汇总恢复/跳过的文件数量与明细。几个实用细节✅关闭对话框、关闭应用、重启电脑后依然可用撤销读取的是最近一份计划文件审查确认对话框内还提供Undo this change按钮可在当次操作后立刻反悔实现见 CategorizationDialog.cpp若某次运行有文件被跳过如冲突撤销计划仍然会保存可稍后重试应用还内置审查历史库SQLite按文件名/类别检索每次已应用的整理操作并支持标记已撤销源码见 ReviewHistoryStore.hpp。安全使用 Dry Run 与 Undo 的最佳实践清单第一次处理新文件夹永远先跑一次 Dry Run——预览是免费的错了不花钱 大目录先挑一个子文件夹试跑确认类别语言、子类别开关符合预期再全量执行✋ 执行后不要手动移动被整理过的文件否则撤销校验会跳过它这是保护机制不是故障; 撤销结果里有 Skipped 时逐条读完原因再手动补位 更多上手内容可看应用内Help → Quick Start Guide本地化涵盖安全试跑、审查、撤销流程与 TROUBLESHOOTING.md。相关源码与文档路径模块路径Dry Run 预览对话框DryRunPreviewDialog.cppDry Run 计划构建逻辑CategorizationDialog.cpp持久撤销管理器UndoManager.cpp撤销计划落盘CategorizationDialog.cpp用户手册dry run 与 undo 章节README.md测试用例说明TESTS.md掌握Dry Run 预览 持久撤销这两个机制你就拥有了对 AI File Sorter 的完全控制权AI 负责出方案落盘与否、何时还原决定权始终在你手上。赞分享AI 应用大模型本地部署桌面应用【免费下载链接】ai-file-sorterCross-platform desktop application for content-aware file organization and renaming. Supports local and remote LLMs, preview-based workflows, and fully user-controlled changes.项目地址https://gitcode.com/gh_mirrors/ai/ai-file-sorter点击查看免费下载相关推荐Mole安全使用指南如何通过dry-run模式预览清理操作Mole安全使用指南如何通过dry run模式预览清理操作 想要安全地使用Mole清理工具释放Mac磁盘空间dry run模式就是你的终极安全网这个强大的CLI开发工具运维观测git undo 完全指南用 git-extras 安全撤销最新提交git undo 完全指南用 git extras 安全撤销最新提交 git undo 是 git extras 工具集 项目介绍见 Readme http开发工具CLI版本控制Git 中的 Dry Run安全预览命令执行效果的实战指南Git 中的 Dry Run安全预览命令执行效果的实战指南 导读 git clean 、 git commit 等命令都支持 dry run 干跑模式G文档教程知识库创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考