Disk Cleaner (disk-sweeper) para Openclaw

O Disk Cleaner é uma ferramenta de linha de comando inteligente projetada para analisar com segurança o uso do disco, identificar arquivos grandes, detectar duplicatas via hash SHA-256 e limpar com segurança caches de aplicativos.

harrylabsj
v1.0.0
Jun 14, 2026
0
568
0

Instalar e Baixar

1. ClawHub CLI

A maneira mais rápida de instalar uma habilidade diretamente do registro.

npx clawhub@latest install disk-sweeper

2. Instalação Manual

Copie a pasta da habilidade para um desses locais

Global
~/.openclaw/skills/
Espaço de trabalho
<project>/skills/

Prioridade: Espaço de Trabalho > Local > Integrado

3. Instalação do Prompt

Copie este prompt para o OpenClaw para instalá-lo automaticamente.

Ajude-me a instalar o disk-sweeper usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).

Prefere baixar?

Obtenha os arquivos originais da habilidade em um arquivo ZIP.

O que é Disk Cleaner (disk-sweeper)?

O Disk Cleaner (disk-sweeper) é um utilitário de análise e limpeza de sistema de alto desempenho disponível através do Openclaw Skills. Projetada para desenvolvedores e usuários avançados, esta ferramenta CLI executa varreduras recursivas de diretório para detalhar a distribuição de armazenamento por tipo de arquivo, tamanho e idade. O que a torna única são suas rígidas salvaguardas de segurança: ela protege diretórios críticos do sistema e utiliza uma estrutura de classificação de segurança multinível para garantir que você nunca exclua arquivos essenciais.

Além da limpeza básica, a ferramenta se destaca na capacidade de detectar caches profundos de aplicativos, visando especificamente grandes consumidores de recursos como caches do macOS, Xcode, Docker, node_modules e importantes ferramentas de produtividade chinesas (WeChat, DingTalk, QQ, Baidu, WPS). Ela funciona inteiramente offline, garante exposição zero à rede e aproveita um algoritmo inteligente de desduplicação SHA-256 de várias passagens para localizar e recuperar espaço desperdiçado por arquivos duplicados.

Casos de uso do Disk Cleaner (disk-sweeper)

Aqui estão formas comuns de utilizar este utilitário a partir do diretório do Openclaw Skills:

  • Recuperar Armazenamento de Desenvolvedor: Escaneie instantaneamente e limpe acúmulos de cache pesados de imagens Docker, Xcode DerivedData, node_modules do npm/yarn e pacotes Homebrew.
  • Limpeza de Cache de Aplicativo: Identifique e purgue com segurança diretórios de cache massivos criados por ferramentas de comunicação como WeChat, DingTalk e QQ sem interromper seus registros de chat.
  • Auditoria de Espaço do Sistema: Execute varreduras de streaming em tempo real em seus diretórios pessoais para gerar relatórios visuais claros de arquivos grandes e uso geral do disco.
  • Detecção de Arquivos Duplicados: Agrupe e detecte arquivos exatamente duplicados usando classificação por tamanho e hash de conteúdo SHA-256 em camadas para desduplicar arquivos e mídias com segurança.
  • Manutenção Automatizada: Configure cron jobs de varredura semanal agendada para rastrear a integridade do disco e gerar resumos JSON estruturados para monitoramento.

Como o Disk Cleaner (disk-sweeper) funciona

Esta ferramenta segue um pipeline de execução estruturado de cinco etapas quando acionada via Openclaw Skills:

  1. Varredura de Sistema de Arquivos em Streaming: O motor scanner.py escaneia o caminho de destino de forma assíncrona, ignorando automaticamente diretórios protegidos pelo sistema e diretórios sem permissões de acesso.
  2. Agregação Multidimensional: O motor analyzer.py processa os arquivos em tempo real, agrupando-os por tipo, tamanho, profundidade do diretório, extensão e idade do arquivo.
  3. Verificação de Desduplicação: Para detecção de duplicatas, a ferramenta agrupa potenciais correspondências por tamanho primeiro, depois analisa hashes de cabeçalho e conclui hashes de conteúdo SHA-256 completos para garantir correspondências perfeitas sem sobrecarga.
  4. Análise de Classificação de Segurança: O motor de segurança avalia caminhos contra uma matriz de proteção e padrões codificados para marcar arquivos com graus de risco codificados por cores (Seguro, Limpável, Cuidado, Protegido).
  5. Execução Segura: Realiza visualizações por padrão. Após confirmação, os arquivos são enviados com segurança para a Lixeira do sistema (usando APIs nativas) em vez de exclusão permanente, fornecendo uma rede de segurança instantânea.

Configuração do Disk Cleaner (disk-sweeper)

Comece com o Disk Cleaner diretamente do registro do Openclaw Skills:

# Instale a skill disk-sweeper globalmente
clawhub install disk-sweeper

# Execute uma varredura rápida e segura do seu diretório pessoal
clawhub run disk-sweeper scan --paths ~/

# Visualize itens limpáveis com segurança sem excluir nada
clawhub run disk-sweeper clean --mode preview

# Execute com segurança a limpeza automatizada para itens marcados como verdes (Seguro)
clawhub run disk-sweeper clean --mode auto-safe --confirm

Esquema de Dados e Taxonomia de Disk Cleaner (disk-sweeper)

A skill Disk Cleaner é estruturada de forma modular para desacoplar operações de sistema de arquivos, análise e definições de regras. Abaixo está a arquitetura de arquivos do projeto e o schema de metadados usado nesta entrada do Openclaw Skills:

Estrutura do Diretório do Projeto

disk-sweeper/
├── SKILL.md                 # Definições e documentação da Skill
├── scripts/
│   ├── scanner.py           # Scanner de sistema de arquivos (streaming + progresso)
│   ├── analyzer.py          # Motor de análise de espaço
│   ├── duplicates.py        # Detecção de arquivos duplicados (SHA-256)
│   ├── caches.py            # Reconhecimento de cache de aplicativo
│   ├── safety.py            # Classificação de segurança + lista de proteção
│   ├── cleaner.py           # Executor de limpeza (lixeira/excluir/desfazer)
│   ├── formatter.py         # Formatação de relatório
│   └── progress.py          # Barra de progresso + status de saída
└── references/
    ├── protected-paths.json # Definições de proteção de caminho do sistema
    ├── cache-patterns.json  # Regex e caminhos de cache de aplicativo
    └── file-types.json      # Mapeamentos de extensão para categoria

Matriz de Classificação de Segurança

Grau Indicador de Cor Racional / Ação
SAFE Verde Caches reconstruíveis (ex: npm, pip) que podem ser limpos com segurança
CLEANABLE Amarelo Ativos de desenvolvimento não utilizados (ex: Xcode DerivedData, imagens Docker)
CAUTION Laranja Caches de aplicativos contendo dados do usuário ou anexos (ex: WeChat, QQ)
PROTECTED Vermelho Diretórios do sistema, binários principais e arquivos críticos do SO (não pode substituir)

Recursos avançados do Disk Cleaner (disk-sweeper)

Explore a engenharia avançada incorporada nesta skill como parte do ecossistema Openclaw Skills:

  • Proteção de Caminho Crítico Hardcoded: Regras de exclusão permanente impedem que quaisquer varreduras ou exclusões toquem em arquivos do sistema em /System, /bin, /sbin, /usr/bin, /etc e /dev.
  • Detecção de Duplicatas Multi-pass: Evita gargalos de desempenho em grandes unidades de mídia verificando primeiro o tamanho dos arquivos, verificando em seguida apenas o hash do cabeçalho do arquivo e executando um hash SHA-256 completo apenas como um passo final de verificação.
  • Protocolo de Exclusão 'Lixeira Primeiro': Garante que exclusões físicas sejam ignoradas por padrão; em vez disso, comandos nativos do sistema operacional movem os arquivos para a lixeira do usuário (usando 'use_trash: true').
  • Tratamento de Interrupção Gracioso: Captura interrupções SIGINT (Ctrl+C) para salvar instantaneamente o progresso, cessar processos ativos e gerar um log estruturado das operações concluídas.
  • Arquitetura Zero-Network: Funciona inteiramente local, não lendo conteúdos de arquivos e enviando zero pacotes de dados pela internet, mantendo os perfis de uso do seu sistema seguros.

SKILL.md


Carregamento

Habilidades relacionadas do Openclaw

METADATA

Github Stars: 0
forks: 0

Apresentou*