WizTree Disk Cleaner

O que WizTree Disk Cleaner faz?

Use o WizTree como fonte de fatos de uso de disco e mantenha análise, aprovação, execução e verificação separadas. Corresponda ao idioma do usuário nos relatórios.

Portões de segurança não negociáveis

• Padrão: apenas análise. Não modifique o disco durante a importação ou revisão de dados CSV.
• Trate o Nível 1 como baixo risco, não como isento de aprovação. Exija aprovação explícita do usuário antes de cada exclusão.
• Nunca infira aprovação a partir de um pedido genérico como "limpe meu disco". Mostre primeiro os alvos e ações exatos.
• Nunca execute comandos de exclusão copiados de prosa de modelo. Construa um plano com scripts/New-CleanupPlan.ps1, mostre seu plan_id e execute somente após o usuário confirmar aquele plano exato.
• Rejeite curingas, caminhos relativos, raízes de unidades, raízes amplas de perfil de usuário, diretórios do sistema, diretórios de programas e alvos de Nível 3.
• Não limpe uma máquina ativa a partir de um CSV exportado em outra máquina. Analise apenas, a menos que a existência do caminho local e o escopo da máquina estejam estabelecidos.
• Não baixe nem instale o WizTree sem solicitação do usuário. Não redistribua o executável do WizTree com esta skill.
• Use apenas operações nativas de arquivo no PowerShell do início ao fim. Revalide caminhos canônicos imediatamente antes da exclusão recursiva.

Leia references/safety-policy.md antes de classificar ou aprovar alvos. Leia references/wiztree-csv.md ao exportar ou analisar dados do WizTree.

Fluxo de trabalho

1. Adquirir um CSV atual

Prefira um CSV exportado da máquina atual e do estado atual do disco.

• Se o usuário já tiver uma exportação, registre seu caminho absoluto e timestamp.
• Se o WizTree estiver instalado e o usuário quiser automação, execute scripts/Export-WizTree.ps1.
• Caso contrário, instrua o usuário a escanear a unidade alvo no WizTree e usar sua exportação CSV oficial.

Não use capturas de tela como inventário canônico quando uma exportação CSV estiver disponível.

2. Produzir o primeiro relatório

Execute:

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/Analyze-WizTreeCsv.ps1 `
  -CsvPath <caminho-absoluto-do-csv> `
  -OutputDirectory <diretório-absoluto-para-relatorio>

Use o JSON gerado como evidência legível por máquina e o relatório Markdown como registro voltado para o usuário. Copie a estrutura em assets/cleanup-report-template.md se for necessária narrativa adicional.

Verifique estes pontos antes de recomendar limpeza:

• Conte bytes alocados das linhas de arquivo; não some totais de pastas aninhadas.
• Trate valores de alocação de hard link com o marcador de zero inicial do WizTree como alocação adicional zero.
• Diferencie um cache de conteúdo criado pelo usuário meramente armazenado sob um nome de cache.
• Marque incerteza explicitamente. Mova um item para um nível de risco mais alto quando a evidência estiver incompleta.

3. Investigar Nível 2

Inspecione cada candidato material de Nível 2 antes de apresentá-lo. Verifique, quando disponível:

• aplicativo proprietário ou componente do Windows;
• se o aplicativo ou serviço está atualmente em execução;
• recência de modificação e se os arquivos estão mudando ativamente;
• se o aplicativo fornece seu próprio comando de limpeza;
• custo de regeneração, impacto de login, impacto offline e opções de recuperação;
• caminho exato, ação proposta, bytes estimados e efeitos colaterais esperados.

Prefira limpeza nativa do aplicativo, configurações de armazenamento do Windows, Limpeza de Disco, comandos de cache do gerenciador de pacotes ou procedimentos documentados com reconhecimento de serviço em vez de exclusão bruta.

4. Obter aprovação itemizada

Apresente o Nível 1 primeiro. Para cada item selecionável, inclua:

• caminho exato;
• ação: clear_directory_contents ou delete_file;
• nível e motivo;
• bytes recuperáveis estimados;
• efeitos colaterais notáveis.

Crie um manifesto de aprovação a partir de assets/approval-manifest.example.json. Inclua apenas itens que o usuário selecionou explicitamente e defina approved como true.

5. Pré-visualizar e vincular o plano

Execute:

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/New-CleanupPlan.ps1 `
  -ApprovalFile <aprovacao-json> `
  -PlanFile <plano-json>

Mostre os itens validados, total estimado, itens rejeitados e plan_id. Pare se algum alvo for mais amplo que a seleção do usuário ou diferente do relatório.

6. Executar apenas o plano confirmado

Após o usuário confirmar o plan_id exibido, execute:

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/Invoke-ApprovedCleanup.ps1 `
  -PlanFile <plano-json> `
  -ConfirmPlanId <id-do-plano-confirmado> `
  -Execute

Sem -Execute, o script permanece uma simulação. Nunca adicione -Execute antes que a confirmação exata do plano esteja visível na conversa.

7. Verificar e atualizar o relatório

• Registre sucessos, pulos, falhas e o caminho do log de auditoria.
• Registre bytes de exclusão estimados e mudança de espaço livre observada separadamente; atividade de fundo pode fazê-los diferir.
• Re-exporte ou escaneie novamente com o WizTree quando praticável.
• Atualize o histórico de execução do relatório Markdown e as escolhas restantes de Nível 2.
• Repita o ciclo de aprovação para o Nível 2. Nunca promova Nível 3 para um plano executável.

Mapa de recursos

• scripts/Export-WizTree.ps1: invocar a exportação CSV oficial do WizTree.
• scripts/Analyze-WizTreeCsv.ps1: processar o fluxo da exportação e gerar JSON e Markdown.
• scripts/New-CleanupPlan.ps1: validar alvos selecionados e criar um plano com integridade vinculada.
• scripts/Invoke-ApprovedCleanup.ps1: revalidar e executar o plano confirmado com log de auditoria JSONL.
• references/safety-policy.md: limites de classificação e exclusão.
• references/wiztree-csv.md: semântica de exportação oficial e expectativas do analisador.
• assets/cleanup-report-template.md: estrutura do relatório.
• assets/approval-manifest.example.json: esquema de entrada para aprovação.