重复文件清理大师

技能文档

---
name: duplicate-cleaner-pro
title: 重复文件清理大师
category: 开发工具
description: "智能重复文件扫描与清理工具，支持按内容MD5/SHA256哈希、文件名相似度、文件大小等多维度检测重复文件。提供安全删除、移动到回收站、保留最优版本等策略。覆盖照片去重、文档整理、音乐库清理等场景。当用户需要查找重复文件、清理磁盘空间、整理照片库或去重文档时触发。触发词：重复文件、去重、磁盘清理、重复照片、文件整理、空间释放、重复检测。"
---

# 重复文件清理大师

智能扫描并清理重复文件，安全释放磁盘空间。

## 核心能力

### 1. 多维度重复检测
- **内容哈希**：MD5/SHA256精确匹配，确保内容完全一致
- **文件名相似度**：基于编辑距离识别相似文件名
- **文件大小**：快速预筛选相同大小的文件
- **图片感知**：对照片进行视觉相似度比对（分辨率、EXIF信息）
- **音频指纹**：识别不同编码但内容相同的音频文件

### 2. 智能扫描
- **指定目录**：扫描单个或多个指定目录
- **全盘扫描**：扫描整个磁盘（排除系统目录）
- **文件类型过滤**：按扩展名筛选扫描范围
- **大小范围**：仅扫描指定大小范围的文件
- **深度控制**：限制递归扫描的目录层级
- **排除规则**：排除特定目录或文件模式

### 3. 清理策略
- **保留最新**：保留修改时间最新的版本
- **保留最优**：保留分辨率最高/质量最好的版本
- **保留最短路径**：保留路径最短的版本
- **自定义规则**：用户指定保留策略
- **安全删除**：移入回收站而非永久删除
- **批量操作**：一键清理所有标记的重复文件

### 4. 报告与分析
- **空间占用报告**：可释放空间总量统计
- **重复分布**：哪些目录重复最严重
- **文件类型分布**：哪类文件重复最多
- **时间趋势**：重复文件的创建时间分布
- **可视化图表**：树状图展示重复关系

### 5. 安全机制
- **预览模式**：先扫描后确认，不自动删除
- **保留清单**：明确标记哪些文件会被保留
- **删除确认**：逐批确认删除操作
- **撤销支持**：可从回收站恢复误删文件
- **系统保护**：自动排除系统关键目录

## 工作流程

1. 用户指定扫描目录和过滤条件
2. 快速预扫描：按文件大小分组
3. 精确扫描：对同大小文件计算哈希
4. 生成重复文件报告
5. 用户选择清理策略
6. 执行清理（安全删除/移动）
7. 输出清理结果报告

## 输出格式

### 扫描报告
```
【扫描目录】/Users/kele/Documents
【扫描文件数】12,458
【重复组数】342
【可释放空间】8.7 GB

重复组 #1 (3个文件, 共释放 450MB)
├── [保留] /Documents/video_final.mp4 (150MB, 最新)
├── [删除] /Downloads/video_final.mp4 (150MB)
└── [删除] /Desktop/video_副本.mp4 (150MB)

重复组 #2 (2个文件, 共释放 1.2GB)
├── [保留] /Photos/IMG_0001.HEIC (原图)
└── [删除] /Downloads/IMG_0001.JPG (压缩版)
```

### 清理结果
```
【清理完成】
├── 已删除文件：684 个
├── 释放空间：8.7 GB
├── 耗时：3分42秒
└── 文件已移入回收站，可随时恢复
```

## 扫描性能优化

- 两阶段扫描：先按大小分组，再计算哈希
- 增量扫描：记住已扫描文件，下次只扫描新增
- 并行计算：多核并行计算文件哈希
- 缓存机制：缓存文件哈希避免重复计算

## 注意事项

- 大文件哈希计算可能耗时较长
- 照片去重建议先预览确认
- 系统目录（/System, /usr等）自动排除
- 建议定期扫描防止重复积累
- 重要数据清理前建议备份

如何安装此技能？

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