前言¶
下載目錄、微信/QQ 文件、網盤同步盤裏，同一份 Office 文檔或安裝包往往被複制多份。直接刪重複項容易誤傷「同名不同內容」的版本，也會讓聊天或網盤裏的記錄指向失效路徑。下面介紹社區 Skill「重複文件清理·硬鏈接去重」：在 Agent 對話裏觸發掃描與整理，用 MD5 識別真重複，並用硬鏈接合併數據塊，路徑與文件名保持不變。
這是什麼¶
重複文件清理·硬鏈接去重（座標 @user_37b3d0df/duplicate-file-cleaner，當前版本 1.3.0）是 SkillHub 上的社區 Skill，分類爲 it-ops-security，發佈者爲 user_37b3d0df，無需 API Key（requires_api_key=false）。
它面向辦公與日常文件場景：掃描 Office/Word/Excel/PPT/WPS、PDF、txt/csv/md、圖片、安裝包、壓縮包等，並覆蓋微信/QQ/釘釘文件目錄、下載目錄、網盤同步目錄、素材庫中的重複副本。核心思路是用硬鏈接回收空間——磁盤只保留一份內容，各路徑仍可照常打開；按 MD5 判定重複，同名但內容不同的文件不會誤判爲重複。
官方頁面：SkillHub - 重複文件清理·硬鏈接去重
線索入口：api.skillhub.cn 頁面
核心功能¶
掃描與去重¶
- 按 MD5 精確識別內容完全相同的文件。
- 默認「辦公文件掃描」檔位（v1.2），支持快速模式（v1.1）。
- 支持停止掃描（v1.2）。
- 安裝包場景：已安裝檢測、安裝包與已解壓軟件目錄配對（v1.2）；解壓軟件目錄可搬移或刪除（v1.1）。
- 微信/QQ 文件目錄一鍵定位（v1.1）。
硬鏈接與空間回收¶
去重執行採用硬鏈接，而非簡單刪除副本。執行後路徑、文件名、大小對外仍一致，微信/網盤側原有打開方式不受影響，底層數據塊合併爲一份。
安全邊界與 v1.3 可信機制¶
硬邊界（掃描與執行時跳過或拒絕）：代碼文件、庫文件、開發目錄（含 .git / node_modules / venv）、虛擬磁盤、郵件庫、臨時文件等。
v1.3 安全與可信（據官方簡介）：
- 三層 CSRF 防護：啓動隨機 token、Host 頭與 Origin 頭校驗，降低任意網頁/插件遠程觸發刪除的風險。
- 硬鏈接可撤銷：執行時寫入
logs/undo_*.tsv，UI 提供撤銷按鈕做原子還原。 - 執行前預演：
/api/preview返回影響數量、釋放字節、卷類型、跨卷配對及前 3 個樣本，彈窗二次確認。 - 日誌目錄在需要時退化到
%TEMP%，失敗有顯式提示。 - NTFS / 跨卷前置檢查：非 NTFS 整批拒絕。
實現爲純 Python 標準庫、零依賴，提供圖形界面與命令行兩種用法。
安裝與啓用¶
安裝前需本機已有 SkillHub CLI。若未安裝，可先按官方文檔檢查版本：
command -v skillhub && skillhub --version
未安裝時可執行完整安裝（含 CLI 與默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
將本 Skill 裝到當前 Agent 的 skills 目錄（必須使用 --dir，否則默認 ./skills/ 可能不被 Agent 識別）。SkillHub 頁面要求安裝：
@user_37b3d0df/duplicate-file-cleaner
Cursor 示例：
skillhub install @user_37b3d0df/duplicate-file-cleaner --dir ~/.cursor/skills/
Claude Code 示例：
skillhub install @user_37b3d0df/duplicate-file-cleaner --dir ~/.claude/skills/
Codex 示例（用戶級或項目級二選一）：
skillhub install @user_37b3d0df/duplicate-file-cleaner --dir ~/.codex/skills/
# 或項目內
skillhub install @user_37b3d0df/duplicate-file-cleaner --dir .agents/skills/
安裝完成後按所用客戶端要求重啓或刷新 Agent，使 Skill 被加載。更完整的 CLI 安裝與優先源說明見：SkillHub 安裝與優先源配置。
典型用法¶
本 Skill 通過自然語言觸發。在已啓用該 Skill 的 Agent 中，可用官方列出的觸發詞描述需求，例如：
- 磁盤與盤符：
磁盤空間不夠、清理磁盤、C盤滿了、D盤滿了、掃描C盤、掃描D盤、整盤掃描、磁盤瘦身 - 重複與辦公：
重複文件、重複文件清理、文件去重、硬鏈接去重、辦公文件去重、Office文件重複、文檔重複了、表格重複、PPT重複、txt重複 - 安裝包與軟件目錄：
安裝包清理、裝完的安裝包、解壓的軟件、軟件目錄搬移 - 即時通訊與目錄：
微信文件太佔空間、微信去重、清理微信文件、msg/file 太大、文件夾裏有重複
建議流程：
- 說明要掃描的目錄或場景（如下載目錄、微信文件目錄、某盤辦公文檔）。
- 等待掃描結果；需要時可使用停止掃描。
- 在 GUI 或對話引導下查看 預演（
/api/preview相關能力）：影響文件數、可釋放空間、卷類型與樣本。 - 確認後執行硬鏈接去重；如需回退，使用撤銷並依賴
logs/undo_*.tsv記錄。
具體界面按鈕與 CLI 子命令以 Skill 包內 SKILL.md 與自帶程序爲準；本文僅歸納官方頁面已公開的行爲。
適用場景與注意¶
適合：Windows 環境下以 NTFS 爲主、重複副本集中在辦公文檔、聊天附件、下載與網盤同步目錄；希望在 Agent 裏用對話完成掃描、預演與去重，且希望保留原路徑的場景。
限制與注意：
- 平臺與文件系統：v1.3 對非 NTFS 整批拒絕；跨卷配對有前置檢查，跨卷硬鏈接能力受系統限制，預演結果中的「跨卷配對」需認真閱讀後再確認。
- 開發與安全目錄：勿指望清理
.git、node_modules、venv 等；Skill 設計上會跳過並在執行時二次拒絕。 - 「刪除」表述：用戶說「刪除重複文件」時，Skill 實際路徑是硬鏈接去重；撤銷依賴 undo 日誌，重要數據仍建議先備份或先完整走預演。
- 環境：圖形界面與本地 Web/API（含 CSRF 校驗）通常在用戶本機運行；在遠程或沙箱 Agent 中可能無法直接訪問本機磁盤，需在裝有該 Skill 且能訪問目標路徑的環境中使用。
結尾¶
重複文件清理·硬鏈接去重把「找重複 → 風險評估 → 預演確認 → 硬鏈接合併 → 可撤銷」串成一條可在 Agent 裏觸發的流程，適合日常辦公與聊天目錄佔滿磁盤時的規範化整理。安裝與詳情以 SkillHub 爲準：
- https://www.skillhub.cn/skills/user_37b3d0df/duplicate-file-cleaner
- https://api.skillhub.cn/user_b3d06a4a/duplicate-file-cleaner
