WizTree Disk Cleaner (Limpiador de Disco WizTree)

¿Qué hace WizTree Disk Cleaner (Limpiador de Disco WizTree)?

Utiliza WizTree como fuente de hechos sobre el uso del disco y mantiene separados el análisis, la aprobación, la ejecución y la verificación. Adapta el idioma de los informes al del usuario.

Compuertas de seguridad no negociables

• Por defecto, solo realizar análisis. No modifiques el disco mientras importas o revisas datos CSV.
• Trata el Nivel 1 como de bajo riesgo, no como libre de aprobación. Requiere la aprobación explícita del usuario antes de cada eliminación.
• Nunca infieras aprobación a partir de una solicitud general como "limpia mi disco". Muestra primero los objetivos y acciones exactos.
• Nunca ejecutes comandos de eliminación copiados de la prosa del modelo. Construye un plan con scripts/New-CleanupPlan.ps1, muestra su plan_id, y ejecuta solo después de que el usuario confirme ese plan exacto.
• Rechaza comodines, rutas relativas, raíces de unidades, raíces amplias de perfiles de usuario, directorios del sistema, directorios de programas y objetivos de Nivel 3.
• No limpies una máquina en vivo desde un CSV exportado en otra máquina. Solo realiza análisis a menos que se establezca la existencia de la ruta local y el alcance de la máquina.
• No descargues ni instales WizTree sin la solicitud del usuario. No redistribuyas el ejecutable de WizTree con esta habilidad.
• Utiliza únicamente operaciones nativas de PowerShell de principio a fin. Vuelve a validar los destinos canónicos inmediatamente antes de la eliminación recursiva.

Lee references/safety-policy.md antes de clasificar o aprobar objetivos. Lee references/wiztree-csv.md al exportar o analizar datos CSV de WizTree.

Flujo de trabajo

1. Adquirir un CSV actual

Prefiere un CSV exportado desde la máquina actual y el estado actual del disco.

• Si el usuario ya tiene una exportación, registra su ruta absoluta y marca de tiempo.
• Si WizTree está instalado y el usuario desea automatización, ejecuta scripts/Export-WizTree.ps1.
• De lo contrario, indica al usuario que escanee la unidad de destino en WizTree y use su exportación CSV oficial.

No uses capturas de pantalla como inventario canónico cuando haya una exportación CSV disponible.

2. Generar el primer informe

Ejecuta:

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/Analyze-WizTreeCsv.ps1 `
  -CsvPath <ruta-absoluta-csv> `
  -OutputDirectory <directorio-absoluto-informe>

Usa el JSON generado como evidencia legible por máquina y el informe Markdown como registro para el usuario. Copia la estructura de assets/cleanup-report-template.md si se necesita narrativa adicional.

Verifica estos puntos antes de recomendar la limpieza:

• Cuenta los bytes asignados de las filas de archivos; no sumes totales de carpetas anidadas.
• Trata los valores de asignación de enlaces duros con el marcador de cero inicial de WizTree como asignación cero adicional.
• Distingue una caché del contenido creado por el usuario que simplemente se almacena bajo un nombre similar a caché.
• Marca la incertidumbre explícitamente. Mueve un elemento a un nivel de riesgo más alto cuando la evidencia sea incompleta.

3. Investigar el Nivel 2

Inspecciona cada candidato material de Nivel 2 antes de presentarlo. Comprueba, cuando esté disponible:

• la aplicación propietaria o el componente de Windows;
• si la aplicación o el servicio se está ejecutando actualmente;
• la actualización reciente y si los archivos están cambiando activamente;
• si la aplicación proporciona su propio comando de limpieza;
• el costo de regeneración, el impacto en el inicio de sesión, el impacto sin conexión y las opciones de recuperación;
• la ruta exacta, la acción propuesta, los bytes estimados y los efectos secundarios esperados.

Prefiere la limpieza nativa de la aplicación, la configuración de almacenamiento de Windows, la herramienta Liberar espacio, los comandos de caché del administrador de paquetes o los procedimientos documentados conscientes del servicio en lugar de la eliminación directa.

4. Obtener aprobación detallada

Presenta primero el Nivel 1. Para cada elemento seleccionable incluye:

• ruta exacta;
• acción: clear_directory_contents o delete_file;
• nivel y motivo;
• bytes recuperables estimados;
• efectos secundarios notables.

Crea un manifiesto de aprobación a partir de assets/approval-manifest.example.json. Incluye solo los elementos que el usuario seleccionó explícitamente y establece approved en true.

5. Previsualizar y vincular el plan

Ejecuta:

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

Muestra los elementos validados, el total estimado, los elementos rechazados y el plan_id. Detente si algún objetivo es más amplio que la selección del usuario o difiere del informe.

6. Ejecutar solo el plan confirmado

Después de que el usuario confirme el plan_id mostrado, ejecuta:

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

Sin -Execute, el script sigue siendo una simulación (dry run). Nunca agregues -Execute antes de que la confirmación del plan exacto sea visible en la conversación.

7. Verificar y actualizar el informe

• Registra los éxitos, saltos, fallos y la ruta del registro de auditoría.
• Registra los bytes de eliminación estimados y el cambio de espacio libre observado por separado; la actividad en segundo plano puede hacer que difieran.
• Vuelve a exportar o a escanear con WizTree cuando sea práctico.
• Actualiza el historial de ejecución del informe Markdown y las opciones restantes de Nivel 2.
• Repite el ciclo de aprobación para el Nivel 2. Nunca promuevas el Nivel 3 a un plan ejecutable.

Mapa de recursos

• scripts/Export-WizTree.ps1: invoca la exportación CSV oficial de WizTree.
• scripts/Analyze-WizTreeCsv.ps1: procesa la exportación y genera JSON y Markdown.
• scripts/New-CleanupPlan.ps1: valida los objetivos seleccionados y crea un plan con integridad.
• scripts/Invoke-ApprovedCleanup.ps1: vuelve a validar y ejecuta el plan confirmado con registro de auditoría JSONL.
• references/safety-policy.md: límites de clasificación y eliminación.
• references/wiztree-csv.md: semántica de exportación oficial y expectativas del analizador.
• assets/cleanup-report-template.md: estructura del informe.
• assets/approval-manifest.example.json: esquema de entrada de aprobación.