dedup-finder SKILL.md skillA

This file is byte-identical to the first copy the registry indexed. Same content hash, so the same checks give both the same grade.

dedup-finder from skyzhao1223/zspace-cli is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add skyzhao1223/zspace-cli/dedup-finder@git:20261009.657293a

Pins git:20261009.657293a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
skyzhao1223/zspace-cli
Path
src/zspace_cli/skills/dedup-finder/SKILL.md
Versions recorded
6
Latest version
git:20261009.657293a, committed Oct 9, 2026
First version recorded
Sep 20, 2026
Size
22,633 bytes
Repository stars
27
License
MIT

Use when 用户想找 NAS 上的重复文件 — "哪些文件重复了"、"帮我找重复照片/视频/文档"、"磁盘被重复文件占满了"、"下载了好几次同一个东西"、"精确去重不要误删"。只读扫描用三级指纹(size → 头部64KB → 全量 sha1)做内容级精确去重,零误报;每组给出「保留哪个/删哪个」的启发式建议,LLM 出删除计划,用户确认后由 Agent 执行(优先 mv 到隔离目录而非直接 rm)。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Dedup Finder — 内容级精确去重

## 概述

**跨 NAS 通用**:扫描脚本跑在**本地挂载路径**上(SMB/NFS),纯 stdlib 零依赖。

与其他「弱指纹」去重不同,本 skill 用**三级指纹做内容级精确去重**:

```
size 分组  →  头部 64KB sha1  →  全量 sha1
(免费)        (只读开头)         (零误报)
```

只有三级全部相同才判为重复 — **不会误删内容不同的文件**。
**写操作不在脚本里** — 扫描出重复组后,LLM 生成删除计划(每组保留哪个),
经用户确认后由 Agent 执行(优先 `mv` 到隔离目录,人工核对后再真删)。

## Prerequisites

```bash
open smb://<NAS_IP>/data        # 挂载要扫描的共享
python3 --version               # ≥3.9,无第三方依赖
```

## 快速验证

```bash
python3 dedup_finder.py scan --root /Volumes/nas/data --max-files 2000
```

## 命令

| 命令 | 用途 |
|------|------|
| `scan --root PATH` | 三级指纹去重扫描(只读);`--root` 可重复传多个跨目录找重复 |
| `scan --root PATH --json --output F` | JSON 输出 |
| `--min-size N` | 忽略小于 N KB 的文件(默认 1) |
| `--max-files N` | 最多比对文件数(0=不限,大库先摸底) |
| `--max-depth N` / `--top N` | 递归深度 / 显示前 N 组 |
| 同目录 `config.json` | 可选覆盖层:`skip_dirs` + `prefer_keep_hints`(见下「配置覆盖」) |

```bash
# 全盘找重复,只看 ≥1MB 的文件
python3 dedup_finder.py scan --root /Volumes/nas/data --min-size 1024

# 跨两个目录找重复(照片库 vs 下载区)
python3 dedup_finder.py scan --root /Volumes/nas/照片 --root /Volumes/nas/下载
```

## 配置覆盖(`config.json`,可选)

「哪一份是正主」是**每个库自己的事**:有人把成品放 `终稿/`,有人放 `交付/`,有人
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add skyzhao1223/zspace-cli/dedup-finder@sha256:03381e180eaf2bbd

The line at the top of this page pins the label git:20261009.657293a, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_vocu4lhqfa526lhl.svg)](https://markdownregistry.com/a/art_vocu4lhqfa526lhl)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 6 versions of this file, between Sep 20, 2026 and Oct 9, 2026, about one every 4 days.

versioncommittedcommitsizeaudit
git:20261009.657293a latest2026-10-09 657293a 22,633 BA view · diff
git:20261009.510d1ca2026-10-09 510d1ca 22,043 BA view · diff
git:20261008.4665db02026-10-08 4665db0 7,529 BA view · diff
git:20261008.aae65c72026-10-08 aae65c7 7,483 BA view · diff
git:20261008.a310beb2026-10-08 a310beb 6,972 BA view · diff
git:20260920.d4bf53a2026-09-20 d4bf53a 6,883 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (22633 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

skyzhao1223/zspace-cli · 27 stars · license MIT · pushed 2026-10-09 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_vocu4lhqfa526lhl
GET https://markdownregistry.com/api/v1/resolve?ref=skyzhao1223/zspace-cli/dedup-finder
GET https://markdownregistry.com/api/v1/blob/03381e180eaf2bbd6899a2920463ba9a39076c6c740dc63d909e45e39f452bb9

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from skyzhao1223/zspace-cli

backup-auditor SKILL.md skill
skyzhao1223/zspace-cli · skills/backup-auditor/SKILL.md · Use when 用户想审计 NAS 上的备份 — "我的备份还新鲜吗"、"备份作业是不是挂了"、"哪些旧备份可以轮转删掉"、"关键目录都有备份吗"、"有没有孤儿备份/空备份"。只读审计:scan…
git:20261009.86c2bf8 · audit A · 27 stars
dedup-finder SKILL.md skill
skyzhao1223/zspace-cli · skills/dedup-finder/SKILL.md · Use when 用户想找 NAS 上的重复文件 — "哪些文件重复了"、"帮我找重复照片/视频/文档"、"磁盘被重复文件占满了"、"下载了好几次同一个东西"、"精确去重不要误删"。只读扫描用三级指纹(size → 头部64KB → 全量…
git:20261009.657293a · audit A · 27 stars
download-cleaner SKILL.md skill
skyzhao1223/zspace-cli · skills/download-cleaner/SKILL.md · Use when 用户想清理 NAS 下载目录 — "下载区太乱帮我清一下"、"哪些下载可以删了"、"安装包/种子/压缩包占空间"、"下载完的视频没归档"、"半截下载残留"、"重复下载了好几次"。只读扫描按类别分诊(未完成/种子/安装包/压…
git:20261009.88e9b2f · audit A · 27 stars
file-sorter SKILL.md skill
skyzhao1223/zspace-cli · skills/file-sorter/SKILL.md · Use when 用户想给 NAS 上一个「什么都往里丢」的乱目录做分类归档 — "帮我把文件分个类"、"图纸和文档混在一起"、"根目录一堆散文件"、"按类型建目录归档"、"dwg/pdf/图片全堆在一层"、"外置盘拷进来一堆东西没整理"。…
git:20261008.f01b099 · audit A · 27 stars
music-organizer SKILL.md skill
skyzhao1223/zspace-cli · skills/music-organizer/SKILL.md · Use when 用户想整理 NAS 上的音乐库 — "帮我整理音乐"、"歌曲散落一地"、"专辑没有封面"、"文件名带【FLAC】/320K 水印"、"曲目没有编号"、"路径和 ID3…
git:20261009.f321c25 · audit A · 27 stars
nas-report SKILL.md skill
skyzhao1223/zspace-cli · skills/nas-report/SKILL.md · Use when 用户想给 NAS 做整体存储体检 — "我 NAS 上都存了些啥"、"空间被什么占了"、"帮我做个存储报告"、"哪些数据该归档/清理"、"该用哪个整理…
git:20261008.f01b099 · audit A · 27 stars
photo-organizer SKILL.md skill
skyzhao1223/zspace-cli · skills/photo-organizer/SKILL.md · Use when 用户想整理 NAS/移动硬盘上的照片视频 — "帮我整理照片库"、"手机备份的照片太乱"、"截图和微信图片按日期归档"、"DCIM/IMG…
git:20261009.a9a41aa · audit A · 27 stars
portfolio-organizer SKILL.md skill
skyzhao1223/zspace-cli · skills/portfolio-organizer/SKILL.md · Use when 用户想整理 NAS 上的作品集 — "帮我整理作品集"、"设计项目文件太乱"、"源文件和成品混在一起"、"项目缺封面/说明"、"成品版本太多不知道哪个是最终版"、"大体积…
git:20261009.34b1347 · audit A · 27 stars
work-organizer SKILL.md skill
skyzhao1223/zspace-cli · skills/work-organizer/SKILL.md · Use when 用户想整理 NAS 上的工作文件 — "帮我整理工作目录"、"根目录一堆散文件"、"文档版本太乱(最终版/final/副本)"、"找临时文件和安装包"、"几年没动的文件归档"、"办公文档按项目/年份归位"。只读扫描(sca…
git:20261009.f321c25 · audit A · 27 stars
zspace-nas SKILL.md skill
skyzhao1223/zspace-cli · skills/zspace-nas/SKILL.md · Manage files on ZSpace (极空间) NAS through zspace-cli Python SDK and CLI. List, rename, move, copy, remove, search, and…
git:20261009.f7254dc · audit B · 27 stars
backup-auditor SKILL.md skill
skyzhao1223/zspace-cli · src/zspace_cli/skills/backup-auditor/SKILL.md · Use when 用户想审计 NAS 上的备份 — "我的备份还新鲜吗"、"备份作业是不是挂了"、"哪些旧备份可以轮转删掉"、"关键目录都有备份吗"、"有没有孤儿备份/空备份"。只读审计:scan…
git:20261009.86c2bf8 · audit A · 27 stars
download-cleaner SKILL.md skill
skyzhao1223/zspace-cli · src/zspace_cli/skills/download-cleaner/SKILL.md · Use when 用户想清理 NAS 下载目录 — "下载区太乱帮我清一下"、"哪些下载可以删了"、"安装包/种子/压缩包占空间"、"下载完的视频没归档"、"半截下载残留"、"重复下载了好几次"。只读扫描按类别分诊(未完成/种子/安装包/压…
git:20261009.88e9b2f · audit A · 27 stars

Every file in skyzhao1223/zspace-cli

Other files named dedup-finder

dedup-finder SKILL.md skill
skyzhao1223/zspace-cli · skills/dedup-finder/SKILL.md · Use when 用户想找 NAS 上的重复文件 — "哪些文件重复了"、"帮我找重复照片/视频/文档"、"磁盘被重复文件占满了"、"下载了好几次同一个东西"、"精确去重不要误删"。只读扫描用三级指纹(size → 头部64KB → 全量…
git:20261009.657293a · audit A · 27 stars

Browse by kind, by grade A, or by owner.