name: file-organizer description: 文件管理助手：整理杂乱文件夹/文件、查找定位文件、检测重复文件、分析磁盘空间、批量重命名、清理垃圾文件与空文件夹、归档压缩。当用户说"帮我整理文件/桌面太乱/找不到文件/有重复文件/磁盘空间不够/文件太多/统一命名/清理下载文件夹"等时使用。所有改动类操作都支持一键回退。

文件管理助手（File Organizer）

用途

帮用户把杂乱的文件夹和文件整理清晰、快速找到想要的东西。核心承诺：所有改动类操作都可回退，绝不破坏用户数据。

能力总览

通用工作流程（所有功能遵循）

第 1 步：明确目标

• 确认用户要整理/处理的目标目录和具体诉求（乱？找东西？重复？空间？）。
• 目标目录不确定时，列出候选并让用户选，不擅自扫描整个磁盘。

第 2 步：扫描与分析

• 用 find/tree/du 查看目标目录结构（排除隐藏目录、系统目录、.git、node_modules）。
• 统计文件类型分布、大小、重复情况等，作为方案依据。

第 3 步：制定方案 → 必须先让用户确认

• 生成「操作计划」：完整列出每条操作（源路径 → 目标路径 / 原文件名 → 新文件名）。
• 展示给用户，等用户明确同意或提出修改，未经确认不得动手。

第 4 步：创建回退快照（所有改动类功能强制）

1. 在目标目录下创建隐藏快照目录：<目标目录>/.file-org-undo/<时间戳>/。
2. 写入操作日志 operations.tsv，每行：<操作类型>\t<源路径>\t<目标路径>（操作类型：move / rename / trash / archive）。
3. 生成回退脚本 undo.sh：逐条反向执行（移回原处、改回原名、从回收区取回）。
4. 保存整理前目录树快照 before.txt。

第 5 步：执行操作

• 严格按已确认的方案执行；任何一步失败立即停止并报告，不继续剩余操作。
• 遇到重名冲突：不覆盖，自动追加后缀（如 报告 (1).pdf）并记入日志。
• 改动类操作一律不永久删除，统一移入 <目标目录>/.file-org-trash/（回收区），用户确认后才可真正删除。

第 6 步：验证与报告

• 校验：操作数 = 计划数、无遗漏、无错误。
• 输出报告：执行数量、新目录结构、回退方法、回收区位置。

各功能细则

① 安全整理（核心）

• 默认按类型分类（见下表），用户可自定义规则（按项目、按日期等）。
• 只做移动，不做删除、不修改文件内容。

② 快速查找定位

• 用 find/mdfind(macOS) 按文件名/类型/时间搜索，列出匹配文件的完整路径。
• 纯查询，无需回退。

③ 重复文件检测

• 先按文件大小分组，再对同组计算哈希（md5/shasum）确认真正重复。
• 输出重复组清单（路径、大小），只报告不处理；用户确认后，把多余副本移入回收区（保留最早/路径最深的一份）。

④ 大文件/空间分析

• 用 du -sh/ncdu 统计目录与文件占用，列出 Top N（默认 Top 20）大文件/大目录。
• 给出建议（可归档/可清理），是否处理由用户决定。

⑤ 批量重命名/命名规范化

• 支持：统一前缀（如按项目名）、补序号、去多余空格/特殊字符、统一日期格式、统一扩展名大小写。
• 必须先生成「重命名预览」全列表（原名 → 新名）给用户确认；重命名记录同样可回退。

⑥ 垃圾文件与空文件夹识别

• 常见垃圾文件：.DS_Store(macOS)、Thumbs.db/desktop.ini(Windows)、~$ 开头的 Office 临时文件、.tmp、日志残留。
• 垃圾文件与空文件夹：先列出清单给用户确认，确认后移入回收区（不直接删除），空文件夹移入回收区同理。

⑦ 下载文件夹专项整理

• 适合高频杂乱场景：先按类型归类大文件，再清理垃圾文件，最后按日期归档旧文件（如 >90 天未修改的移入 归档/<年份>/）。
• 整套流程仍走「方案确认 → 快照 → 可回退」。

⑧ 归档与压缩

• 按日期/项目把旧文件移到 归档/<年份>/，或压缩为 zip（保留目录结构）。
• 压缩前先确认：压缩后是否删除原文件（默认保留原文件，或移入回收区）。

⑨ 整理报告导出

• 整理完成后，在目标目录生成 整理报告.md（操作摘要、新结构图、回退命令、回收区位置）。
• 同时把 operations.tsv 保留在快照目录内，供回退使用。

回退机制（必须）

• 全部回退：运行 bash "<目标目录>/.file-org-undo/<时间戳>/undo.sh"，恢复整理前状态（含移动、重命名、回收区取回）。
• 部分回退：用户指定某个文件/文件夹，按 operations.tsv 对应条目反向操作。
• 回退后：询问用户是否删除该次快照（默认保留，便于二次回退）。
• 每次报告末尾，用醒目一行给出回退命令。

安全红线（违反即停止）

• 绝不永久删除、覆盖、截断任何文件——一律走回收区，用户确认后才清空。
• 默认不动：.git、node_modules、系统目录、隐藏文件/目录；用户明确要求时才处理。
• 每次改动前必须展示方案并得到用户确认，不得直接动手。
• 只在用户指定范围内操作，不跨盘符/越权；无权限时报错并停止。
• 文件多时（>100 个）按批次执行并每批汇报进度。
• 涉及 rm 等危险命令：除非用户反复明确要求，否则一律禁用，改用移动/回收区方案。

分类规则模板（默认，可自定义）

这个 Skill 质量很好，特别注重数据安全，所有改动操作都能一键回退，不会误删文件。它会在执行前先把方案列出来等你确认，完全掌控整个过程。功能覆盖很全面，从整理文件到清理垃圾、归档压缩都有。不过因为主要靠描述而非脚本实现，个别复杂场景下表现可能不够稳定。