適用於 Openclaw 的 Disk Cleaner (disk-sweeper)

Disk Cleaner 是一套智慧命令列工具,旨在安全地分析磁碟使用情況、識別大型檔案、透過 SHA-256 哈希偵測重複項,並安全地清理應用程式快取。

harrylabsj
v1.0.0
Jun 14, 2026
0
568
0

安裝與下載

1. ClawHub CLI

從來源直接安裝技能的最快方式。

npx clawhub@latest install disk-sweeper

2. 手動安裝

將技能資料夾複製到以下位置之一

全域模式
~/.openclaw/skills/
工作區
<project>/skills/

優先級:工作區 > 本地 > 內建

3. 提示詞安裝

將此提示詞複製到 OpenClaw 即可自動安裝。

請幫我使用 Clawhub 安裝 disk-sweeper。如果尚未安裝 Clawhub,請先安裝(npm i -g clawhub)。

想要直接下載?

取得包含原生技能檔案的ZIP壓縮檔。

什麼是 Disk Cleaner (disk-sweeper)?

Disk Cleaner (disk-sweeper) 是一套透過 Openclaw Skills 提供的高效能系統分析與清理公用程式。該 CLI 工具專為開發人員與進階使用者設計,透過遞迴目錄掃描來按檔案類型、大小與使用時間分解儲存分配。其獨特之處在於嚴格的安全護欄:它保護系統關鍵目錄,並使用多級安全分級框架,確保您絕不會刪除重要檔案。

除了基本的清理功能外,該工具還能深入偵測應用程式快取,特別是針對佔用大量資源的程式,如 macOS 快取、Xcode、Docker、node_modules 以及主流的中文效率工具(微信、釘釘、QQ、百度、WPS)。它完全離線執行,確保零網路暴露,並利用智慧、多重 SHA-256 重複資料刪除演算法來定位並回收被重複檔案浪費的空間。

Disk Cleaner (disk-sweeper) 應用場景

以下是利用 Openclaw Skills 目錄中該公用程式的常見方式:

  • 回收開發者儲存空間:即時掃描並清除 Docker 映像檔、Xcode DerivedData、npm/yarn node_modules 以及 Homebrew 套件中積壓的大量快取。
  • 應用程式快取清理:識別並安全清除由微信、釘釘、QQ 等通訊工具所建立的大量快取目錄,且不會中斷聊天記錄。
  • 系統空間稽核:在您的主目錄下執行即時串流掃描,輸出大型檔案與整體磁碟使用情況的清晰視覺化報告。
  • 重複檔案偵測:使用基於大小的排序與分層 SHA-256 內容哈希來分組並偵測完全重複的檔案,從而安全地對封存與媒體檔案進行去重。
  • 自動化維護:設定每週定期的 cron 作業來追蹤磁碟健康狀況,並輸出結構化的 JSON 摘要以供監控。

Disk Cleaner (disk-sweeper) 運作原理

當透過 Openclaw Skills 觸發時,該工具遵循以下結構化的五步驟執行流程:

  1. 串流檔案系統掃描:scanner.py 引擎非同步掃描目標路徑,自動跳過系統保護目錄與無權存取的目錄。
  2. 多維度聚合:analyzer.py 引擎即時處理檔案,按類型、大小、目錄巢狀深度、副檔名與檔案時間進行分組。
  3. 去重檢查:對於重複偵測,該工具首先按大小對潛在匹配項進行分組,然後分析頭部哈希,最後完成完整的 SHA-256 內容哈希,以確保在無額外開銷的情況下實現完美匹配。
  4. 安全分級分析:安全引擎根據硬編碼的保護矩陣與模式評估路徑,使用顏色編碼的風險等級(安全、可清理、謹慎、受保護)標記檔案。
  5. 安全執行:預設執行預覽。確認後,檔案將安全地移動到系統垃圾桶(使用原生 API),而不是永久刪除,從而提供即時的安全保障。

Disk Cleaner (disk-sweeper) 設定指南

直接從 Openclaw Skills 的登錄檔開始使用 Disk Cleaner:

# 全域安裝 disk-sweeper 技能
clawhub install disk-sweeper

# 對您的主目錄進行快速、安全的掃描
clawhub run disk-sweeper scan --paths ~/

# 安全預覽可清理項目而不刪除任何內容
clawhub run disk-sweeper clean --mode preview

# 為標記為綠色(安全)的項目安全執行自動清理
clawhub run disk-sweeper clean --mode auto-safe --confirm

Disk Cleaner (disk-sweeper) 資料結構與分類體系

Disk Cleaner 技能採用模組化結構,將檔案系統操作、分析與規則定義解耦。以下是 Openclaw Skills 此條目中使用的專案檔案架構與中繼資料 schema:

專案目錄結構

disk-sweeper/
├── SKILL.md                 # 技能定義與文件
├── scripts/
│   ├── scanner.py           # 檔案系統掃描器(串流 + 進度)
│   ├── analyzer.py          # 空間分析引擎
│   ├── duplicates.py        # 重複檔案偵測 (SHA-256)
│   ├── caches.py            # 應用程式快取識別
│   ├── safety.py            # 安全分級 + 保護清單
│   ├── cleaner.py           # 清理執行器(垃圾桶/刪除/還原)
│   ├── formatter.py         # 報告格式化
│   └── progress.py          # 進度列 + 狀態輸出
└── references/
    ├── protected-paths.json # 系統路徑保護定義
    ├── cache-patterns.json  # 應用程式快取正規表達式與路徑
    └── file-types.json      # 副檔名到類別的對應

安全分級矩陣

等級 顏色指示 原理 / 操作
SAFE 綠色 可重建快取(例如 npm, pip),可以安全清除
CLEANABLE 黃色 未使用的開發資產(例如 Xcode DerivedData, Docker 映像檔)
CAUTION 橘色 包含使用者資料或附件的應用程式快取(例如微信, QQ)
PROTECTED 紅色 系統目錄、核心二進位檔案與作業系統關鍵檔案(無法覆蓋)

Disk Cleaner (disk-sweeper) 進階特性

探索作為 Openclaw Skills 生態系統一部分的該技能中內建的高級工程特性:

  • 硬編碼關鍵路徑保護:永久排除規則防止任何掃描或刪除操作觸及 /System、/bin、/sbin、/usr/bin、/etc 與 /dev 中的系統檔案。
  • 多輪重複偵測:透過先驗證檔案大小、接著僅檢查檔案頭哈希,最後僅作為最終驗證步驟執行完整的 SHA-256 哈希,避免在大容量媒體磁碟機上出現效能瓶頸。
  • 先移入垃圾桶的刪除協定:確保預設跳過物理刪除;相反地,原生作業系統命令會將檔案移動到使用者的垃圾桶(使用 'use_trash: true')。
  • 優雅的中斷處理:擷取 SIGINT (Ctrl+C) 中斷,以即時儲存進度、停止活動處理程序並輸出已完成操作的結構化記錄。
  • 零網路架構:完全在本地執行,不讀取檔案內容,且不透過網際網路傳送任何資料封包,保持您的系統使用設定檔的安全性。

SKILL.md


加載中

Openclaw 相關技能

METADATA

Github Stars: 0
forks: 0

精選*