前言¶
重复文件是悄悄积累的：同一份文档保存了多份，同一个安装包下载了多次，微信、QQ 目录里同一份资料被反复备份。直接删除有风险——可能删掉的是仅存的一份，也可能动到程序正在用的路径。普通重复文件工具通常把多余副本移走，移动之后原路径失效，原来的程序可能打不开。
下面介绍的这个 Skill 换了思路：不删除、不移动，而是用硬链接让多个「文件」指向磁盘上的同一份数据。文件名、路径、大小全部不变，原程序照常打开，磁盘上实际只存一份。
这是什么¶
面向 Windows 本机磁盘与移动硬盘的重复文件清理 Skill，发布在 SkillHub 上，来源为 community，纯 Python 标准库实现，零第三方依赖。SkillHub 评分 96792，分类 dev-programming，下载 9294 次。
它解决的问题是：安全地找出重复的办公文件并回收磁盘空间。默认只扫办公文件（Office/Excel/PPT/WPS/PDF/文本/图片/安装包），代码与系统文件自动跳过。
核心功能¶
扫描策略¶
1、默认扫描范围限定办公文件：Office/Excel/PPT/WPS/PDF/文本/图片/安装包。
2、代码与系统文件自动跳过。
3、快速模式加并发哈希，支持整盘快扫。
4、微信、QQ 目录一键定位。
5、安装包自动判断是否已安装、是否已解压。
6、解压后的软件目录可一键搬移或删除。
硬链接去重与安全¶
去重后在重复文件之间建立硬链接：
- 文件名、路径、大小全部不变，原程序照常打开。
- 磁盘上实际只存一份数据，空间被回收。
- 硬链接可一键撤销，回到去重前的状态。
- 执行前弹出预演窗口，列出影响数量与卷类型，确认后再执行。
- v1.3 起提供三层 CSRF 防护：启动 token + Host + Origin 头校验，任意网页无法远程触发删除。
识别隐形重复¶
有一部分重复是「隐形」的：文件名不同，内容完全相同。
1、v1.4 起新增 Office 正文指纹，用于识别这类隐形重复。
2、版本链折叠：V1/V2/终版 一屏决策，不用逐个文件对比。
3、一键并排打开对比，确认后再清理。
效率与报告¶
1、v1.5 起新增 sqlite 增量扫描，二次扫描秒开。
2、HTML/MD 报告导出，便于留档。
3、桌面、文档、下载、OneDrive 一键定位。
4、按文件类型智能默认清理策略。
5、日志自动轮转；日志无法写入时自动退化到 %TEMP%（v1.3 起）。
安装与启用¶
官方页面未提供独立的安装命令。该 Skill 基于通用 SKILL.md 格式，纯 Python 标准库，零第三方依赖，无需 pip 安装第三方包。启用方式取决于所用宿主环境的 Skill 加载方式（IDE 或 CLI 的 Skill 管理入口），具体以官方地址页面为准。
典型用法¶
以下流程依据官方功能说明整理，具体命令以官方页面为准。
1、选择扫描对象：使用默认办公文件范围，或开启快速模式整盘快扫。
2、添加常用目录：用一键定位加入微信、QQ 目录，或桌面、文档、下载、OneDrive。
3、查看结果：版本链折叠后一屏浏览；对可疑项一键并排打开对比确认。
4、处理安装包与软件目录：安装包自动判断是否已安装、已解压；已解压的软件目录可选择搬移或删除。
5、确认执行：预演弹窗列出影响数量与卷类型，确认后以硬链接去重。
6、收尾：需要时一键撤销硬链接；可导出 HTML/MD 报告留档。
适用场景与注意¶
适合：
- 办公文档、PDF、图片、文本有多份副本占用空间。
- 移动硬盘或本地磁盘空间紧张，又不想改变现有文件组织方式。
- 微信、QQ 目录里同一份资料被反复备份。
- 同一安装包有多份副本，想判断是否已安装、已解压后再清理。
注意：
- 硬链接去重意味着多个路径指向磁盘上的同一份数据；删除多余链接不影响数据本身，但清理前仍建议先确认重要文件。
- Skill 提供预演弹窗与一键撤销，但大规模目录清理前建议先导出报告留档。
- SkillHub 上另有一个名称相近的 community 条目（@user_2afa4478/duplicate-file-cleaner，v1.0.0，office-efficiency 分类），与本 Skill 不是同一条目，使用前以官方地址为准。
结尾¶
这个 Skill 的价值在于保留使用者侧：文件名、路径、程序调用都不变，磁盘侧只存一份数据。配合预演弹窗、一键撤销和 CSRF 防护，清理过程是可控、可回退的。
官方地址：https://api.skillhub.cn/user_37b3d0df/duplicate-file-cleaner
