文件去重 · 哈希精确识别与回收【律令·本地零联网】

重复文件查找：扫描目录按内容哈希精确识别重复文件，支持预览、移动回收、删除三档处置，是磁盘清理与文件清理前的第一步。

这个技能做什么

本地运行，零网络、免 API Key、数据不出电脑。 四项诚实承诺：① 算不出就说算不出，绝不编造数字；② 高危动作强制人工确认；③ 幂等断点，绝不重复副作用；④ 全程留痕可审计。

文件去重

子命令（全部实测通过）

scan — 扫描重复文件（只读）

file_dedup.py scan "D:/下载" --min-size 1048576

实测输出（自造 3 组重复数据的测试目录，--min-size 100）：

[组1] 内容相同 x2  单文件 1.9MB
  正本: ...\dedup\a1.bin
  重复: ...\dedup\sub\a2.bin

[组2] 内容相同 x2  单文件 1.4MB
  正本: ...\dedup\c1.bin
  重复: ...\dedup\c2.bin

===== 汇总 =====
重复组数: 2  重复文件数: 2  可释放空间: 3.3MB

判定规则：每组保留 mtime 最旧 的为正本，其余为重复项；只有一份的文件不进组。--min-size 默认 1MB，跳过小文件加速扫描。

clean — 处置重复文件（默认预览）

# 预览（不动任何文件）
file_dedup.py clean "D:/下载" --to "D:/dedup_trash" --min-size 1048576
# 确认后执行
file_dedup.py clean "D:/下载" --to "D:/dedup_trash" --min-size 1048576 --yes

--mode move（默认）把重复文件移入回收目录，实测闭环：完成：处置 2/2 项，正本与单份文件原地保留；--mode delete 直接删除，务必先预览。

工作流建议

1. 先 scan 看分组是否合理，特别核对正本是不是用户想留的那份
2. 用 clean --mode move 而非 delete，移入回收目录确认无误后再手动清空
3. 系统目录（Windows/Program Files）不要直接 clean；扫描前确认目录范围

自检清单

• 扫描目录范围与用户意图一致（没有误扫系统盘根）
• 正本选择（最旧优先）符合用户预期
• clean 只在用户确认后加 --yes 执行
• 输出汇总中的可释放空间已向用户报告

---

本 Skill 采用 BUSL-1.1 许可（源码可见，可自由使用）。

版权所有 © 2026 律令科技（深圳）有限公司（@lexord-technology）。

允许个人及企业内部免费使用、复制、修改，包括内部生产环境。 未经书面许可，不得将本 Skill 或其修改版作为商业服务对外销售、转售或提供托管服务。 各版本发布之日起 4 年后自动转为 Apache License 2.0。详见随包 LICENSE.md。

与相邻技能的关系

本包只做自己职责范围内的事，遇到下列情形直接转给兄弟技能：

反向边界：按内容哈希精确识别，默认只预览、移动回收，不直接删除。物理删除需二次确认。

你是一个文件/数据自动化助手：用脚本精确完成确定性操作，危险操作默认只读预览、确认后才执行，所有文档中的示例均来自真实运行输出。核心原则：先预览后执行、只动确认过的文件、诚实报告失败项。

标签

重复文件文件去重重复文件查找磁盘清理文件清理

安装方式

1. 打开 SkillHub 上的技能页，点击安装；
2. 技能文件落在本机技能目录，SKILL.md 全文可在安装前预览；
3. 在你的 Agent 里直接说出使用场景即可触发，例如「文件重复了、清理重复文件、磁盘满了想去重」。

同类技能

常见问题

按真实会被问到的顺序排。每条答案都给得出可核对的依据——触发词、文件名、路径、源码，全部来自技能包里的真实内容，不是宣传话术。