文件管理助手

技能文档

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

# 文件管理助手

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

## 能力总览

| 功能 | 触发场景举例 | 是否改动文件 |
|------|-------------|-------------|
| ① 安全整理 | "帮我整理一下桌面/下载文件夹，太乱了" | ✅ 移动 |
| ② 快速查找定位 | "我那个 xxx 文件放哪了？帮我找一下" | ❌ 只查询 |
| ③ 重复文件检测 | "我好像有两个一样的文件" | ⚠️ 只报告，处理需确认 |
| ④ 大文件/空间分析 | "磁盘空间不够了，什么东西占地方" | ❌ 只报告 |
| ⑤ 批量重命名 | "这些文件名乱七八糟，统一一下格式" | ✅ 重命名 |
| ⑥ 垃圾文件与空文件夹 | "清理一下垃圾文件" | ✅ 移入回收区 |
| ⑦ 下载文件夹专项整理 | "把下载文件夹整理一下" | ✅ 移动/归类 |
| ⑧ 归档与压缩 | "把去年的项目收起来" | ✅ 移动/压缩 |
| ⑨ 整理报告导出 | "整理完给我一份报告" | ✅ 新增报告文件 |

---

## 技能工作流（所有功能遵循）

### 第 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` 等危险命令：除非用户反复明确要求，否则一律禁用，改用移动/回收区方案。

## 分类规则模板（默认，可自定义）
| 类别 | 目标文件夹 | 匹配示例 |
|------|-----------|---------|
| 图片 | `图片` | .jpg .png .gif .webp .heic |
| 文档 | `文档` | .pdf .docx .xlsx .pptx .txt .md |
| 视频 | `视频` | .mp4 .mov .mkv .avi |
| 音频 | `音频` | .mp3 .wav .flac .m4a |
| 压缩包 | `压缩包` | .zip .rar .7z .tar.gz |
| 安装包 | `安装包` | .dmg .pkg .exe .msi |
| 代码 | `代码` | .py .js .ts .java .go .c .cpp .html .css .json |
| 其他 | `其他` | 无法归类的文件 |

使用说明

# 文件管理助手

整理杂乱文件夹、查找文件、检测重复、分析磁盘空间、批量重命名、清理垃圾文件、归档压缩。所有改动类操作支持一键回退。

## 适用场景

- 「桌面太乱了帮我整理」「找不到那个文件」「有重复文件」「磁盘空间不够」
- 批量统一命名、清理下载文件夹、归档旧项目

## 最简用法

```text
帮我整理一下下载文件夹，太乱了
这些文件统一改成「项目名-序号」格式
```

## 说明

- 改动前先出操作计划，确认后执行；未经确认不动手
- 所有移动/重命名先建回退快照（.file-org-undo/），可整体或部分回退
- 不永久删除：垃圾文件一律移入回收区，用户确认后才清空

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。