Communitygithub.com

tzwkb/disk-cleanup

Herramienta de análisis y limpieza de disco para Windows, diseñada para asistentes de IA.

¿Qué es disk-cleanup?

Esta habilidad (skill) para agentes de IA se especializa en el análisis y la limpieza profunda de discos en Windows. Su propósito es guiar al agente para que realice una exploración agresiva y exhaustiva del espacio en disco, pero ejecute la eliminación de archivos de manera conservadora, siempre previa confirmación del usuario. La habilidad implementa un modelo de semáforo de seguridad (verde: seguro de eliminar, amarillo: requiere confirmación, rojo: prohibido) y proporciona estrategias para manejar software chino que usa rutas fijas (como WeChat, QQ, WPS). Incluye flujos de trabajo estandarizados: escaneo panorámico, clasificación de riesgos, presentación de informes, ejecución de limpieza y verificación posterior. Ofrece guías detalladas para limpiar la unidad C, incluyendo WinSxS, AppData, ProgramData y entornos Python, así como procedimientos para desinstalar aplicaciones grandes, migrar directorios de usuario, analizar bibliotecas de juegos (Steam, WeGame) y manejar trampas comunes como archivos bloqueados, nombres Unicode y procesos de desinstalación asíncronos (NSIS). Incluye un conjunto de scripts en Python y PowerShell para automatizar el escaneo, la limpieza y la eliminación de carpetas resistentes.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add tzwkb/disk-cleanup

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Disk Cleanup Master — Maestro de Limpieza de Disco en Windows

Principios Fundamentales (Inquebrantables)

  1. Escaneo Agresivo, Eliminación Conservadora
    • Escaneo: Itinerar con audacia, inspeccionar de forma exhaustiva, no temer a reportar de más.
    • Eliminación: Cada operación debe mostrar al usuario el contenido exacto, su tamaño y el riesgo asociado, y obtener su confirmación explícita antes de ejecutarse.
  2. Modelo de Seguridad Semáforo
    • 🟢 Verde (Seguro de eliminar): Temp, cachés del navegador, pip cache, __pycache__, residuos de instaladores antiguos, Cache/Log explícitos de aplicaciones, componentes antiguos de WinSxS.
    • 🟡 Amarillo (Requiere confirmación del usuario): Partidas guardadas, registros de WeChat/QQ, archivos en la nube de WPS, archivos personales en la carpeta de Descargas, datos globales de aplicaciones en ProgramData.
    • 🔴 Rojo (Prohibido eliminar sin autorización): Directorios del sistema de Windows, Program Files, archivos de proyecto en uso por el usuario, datos sin respaldo.
  3. Tratamiento Especial para Software Chino
    • Las aplicaciones del ecosistema Tencent (WeChat/QQ/WeCom), NetEase, WPS y Baidu generalmente usan rutas fijas y no siguen la API de Carpetas Conocidas de Windows.
    • Bajo ninguna circunstancia se deben cortar/renombrar sus carpetas directamente; se debe cambiar la ruta desde la configuración de la aplicación.
    • Ver detalles en references/chinese-app-special-cases.md.

Flujo de Trabajo Estándar

Paso 1: Escaneo Panorámico (Agresivo)

  • Usar Get-PSDrive para obtener una vista general del espacio en las unidades.
  • Usar scripts/tree_size_scanner.py para un escaneo jerárquico — comenzando desde el directorio raíz, ordenando por tamaño y profundizando en la carpeta más grande para localizar rápidamente las fuentes de consumo de espacio.
  • Realizar un escaneo dirigido a áreas problemáticas como AppData, Documents y ProgramData.
  • Objetivo: Proporcionar un mapa de ocupación del disco en 5 minutos.

Estrategia de Escaneo Jerárquico:

# Panorama de la unidad C (mostrar carpetas >500 MB, profundidad 4 niveles)
python scripts/tree_size_scanner.py "C:\\" 500 4

# Localización rápida de grandes consumidores en unidades D/E
python scripts/tree_size_scanner.py "D:\\" 5000 3
  • Escanear primero el directorio raíz para encontrar las carpetas más grandes.
  • Luego, escanear en profundidad cada una de las carpetas más grandes por separado.
  • Los directorios del sistema (Windows, Program Files) se omiten automáticamente para evitar operaciones incorrectas.

Búsqueda de aplicaciones/juegos específicos (no instalados por plataforma):

# Buscar por palabra clave en el nombre de la carpeta (profundidad 6 niveles, sin calcular tamaño, muy rápido)
python scripts/find_folders_by_keyword.py "D:\\" "Call of Duty|COD|Modern Warfare"

Paso 2: Clasificación y Evaluación de Riesgos

  • Clasificar los resultados del escaneo según 🟢🟡🔴.
  • Marcar los elementos amarillos con el riesgo específico (ej. "Copia de seguridad de WeChat 33 GB, no se podrá recuperar al cambiar de teléfono").
  • Excluir directamente los elementos rojos, sin realizar ninguna operación.

Paso 3: Presentación del Informe al Usuario

  • Usar una tabla para mostrar: Área, Tamaño, Nivel de Riesgo, Acción Sugerida.
  • Permitir que el usuario seleccione o indique explícitamente "cuáles eliminar".
  • Prohibido ejecutar una eliminación por lotes sin la confirmación individual de cada elemento.

Paso 4: Ejecutar la Limpieza

  • Elementos verdes: Se pueden ejecutar directamente, pero se debe informar el resultado después.
  • Elementos amarillos: El usuario confirma uno, se ejecuta uno.
  • Priorizar el uso de --dry-run o modo de vista previa antes de ejecutar.

Paso 5: Verificación

  • Revisar el espacio en disco después de la limpieza.
  • Para operaciones de migración (como migrar Documents), realizar una prueba de escritura para verificar la corrección de la ruta.

Guía de Limpieza Especializada para la Unidad C

Limpieza Segura a Nivel de Sistema (Verde)

# Archivos temporales
$env:TEMP                    # Archivos temporales del usuario
C:\Windows\Temp              # Archivos temporales del sistema
C:\Windows\SoftwareDistribution\Download  # Caché de Windows Update

# Cachés del navegador
$env:LOCALAPPDATA\Microsoft\Edge\User Data\Default\Cache
$env:LOCALAPPDATA\Google\Chrome\User Data\Default\Cache

# Papelera de reciclaje
C:\$Recycle.Bin

# Archivo de hibernación (si el usuario no usa la hibernación)
# powercfg /hibernate off

Limpieza del Almacén de Componentes WinSxS (Verde de Alto Valor)

WinSxS (C:\Windows\WinSxS) es el repositorio de componentes del sistema de Windows. Cada actualización conserva las versiones antiguas para permitir la reversión. La acumulación a largo plazo puede alcanzar 10-20 GB.

Analizar el espacio recuperable:

dism /Online /Cleanup-Image /AnalyzeComponentStore

Ejecutar limpieza (segura, recomendada):

dism /Online /Cleanup-Image /StartComponentCleanup
  • Después de la limpieza, no se pueden desinstalar las actualizaciones de Windows ya instaladas (el impacto real es mínimo).
  • Normalmente puede recuperar varios cientos de MB ~ varios GB.
  • Tarda de 3 a 10 minutos, puede ejecutarse en segundo plano.

Limpieza más agresiva (con precaución):

dism /Online /Cleanup-Image /StartComponentCleanup /ResetBase
  • Libera más espacio, pero impide completamente la reversión de cualquier actualización.
  • Considerar solo cuando el disco esté extremadamente ajustado.

Organización del Entorno Python Global

  • pip list --format=freeze para ver el número total de paquetes.
  • pip list --not-required para encontrar los paquetes de nivel superior instalados directamente por el usuario (generalmente mucho menos que el total).
  • pip check para verificar conflictos de dependencias.
  • pip cache purge para limpiar el caché de descarga de pip.
  • Limpiar los residuos de instalaciones dañadas que comienzan con ~ en site-packages.
  • Limpiar todas las carpetas __pycache__: Get-ChildItem -Path $sitePackages -Recurse -Directory -Filter "__pycache__" | Remove-Item -Recurse -Force.
  • Nota: Al reparar conflictos de dependencias, pueden encontrarse paquetes mutuamente excluyentes (ej. pyjwt requerido en diferentes rangos de versiones por dos paquetes), el usuario debe decidir cuál conservar.

Escaneo Dirigido de AppData

AppData es un gran consumidor oculto en la unidad C, generalmente dividido en:

  • Local: Cachés de programas, datos de ejecución (gran espacio de limpieza potencial).
  • Roaming: Configuración de usuario, registros de chat (manejar con cuidado).
  • LocalLow: Datos de aplicaciones de baja integridad (generalmente no grandes).

Elementos grandes comunes:

  • Local\Netease\CloudMusic\Cache — Caché de NetEase Cloud Music (eliminable).
  • Roaming\Kingsoft\office6\backup — Copias de seguridad de bloqueo de WPS (eliminable).
  • Roaming\Tencent — Datos de WeChat PC (amarillo, ver referencia).

Escaneo Dirigido de ProgramData

ProgramData es un gran consumidor de la unidad C que se pasa por alto fácilmente, almacena datos globales de aplicaciones, cachés de instalación y configuraciones de controladores de dispositivos.

Estrategia de Clasificación:

CategoríaRuta TípicaRiesgoEjemplo
Datos de controladoresNVIDIA, NVIDIA Corporation, LGHUB, ASUS🔴 No tocarEliminarlos podría causar fallos en dispositivos
Datos globales de aplicacionesTencent, anaconda3, 0install.net🟡 Confirmar antes de eliminarSe puede eliminar si no se usa la aplicación
Caché de instalaciónPackage Cache, Microsoft\VisualStudio🟡 Con precauciónEliminarlos puede impedir desinstalar/reparar programas
Datos del sistemaMicrosoft\Windows Defender, Microsoft\Search🔴 No tocarComponentes centrales del sistema

Comando de escaneo:

# Se recomienda usar el script para escanear, evitando tiempos de espera en comandos individuales
python scripts/scan_programdata.py

Elementos limpiables comunes:

  • anaconda3 — Si ya se ha cambiado a otro entorno Python, se puede desinstalar (normalmente 3-8 GB).
  • 0install.net — Datos del gestor de paquetes Zero Install, se puede eliminar si no se usa (normalmente cientos de MB).
  • Tencent\QQPCMgr — Datos del Administrador de PC de QQ (eliminable si no se usa).
  • Tencent\WeType — Datos del método de entrada WeChat (eliminable si no se usa).

Procedimiento de Desinstalación de Aplicaciones Grandes (Amarillo → Verde)

Para los residuos de aplicaciones grandes encontrados en ProgramData o Program Files, no eliminar las carpetas directamente, seguir el procedimiento de desinstalación estándar:

  1. Buscar el desinstalador en el registro

    Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*" |
      Where-Object { $_.DisplayName -match "Anaconda" }
    
  2. Desinstalación silenciosa (instalador NSIS)

    & "C:\ProgramData\anaconda3\Uninstall-Anaconda3.exe" /S
    
    • Nota: El parámetro /S puede hacer que el proceso vuelva inmediatamente sin esperar a que termine la desinstalación.
    • Se debe sondear si la carpeta desaparece:
    while (Test-Path "C:\ProgramData\anaconda3") { Start-Sleep -Seconds 10 }
    
  3. Limpiar residuos

    • Verificar y eliminar carpetas residuales.
    • Verificar la variable de entorno PATH:
    [Environment]::GetEnvironmentVariable("Path", "User") -split ";" | Select-String "anaconda"
    [Environment]::GetEnvironmentVariable("Path", "Machine") -split ";" | Select-String "anaconda"
    
  4. Último recurso para eliminar carpetas resistentes: Truco de Robocopy Vacío Cuando tanto Remove-Item -Force como takeown + icacls fallan:

    $empty = "C:\temp_empty_$(Get-Random)"
    New-Item -ItemType Directory -Path $empty -Force | Out-Null
    robocopy $empty "C:\ProgramData\0install.net" /MIR /R:1 /W:1 /NP /NFL /NDL
    Remove-Item $empty -Force
    Remove-Item "C:\ProgramData\0install.net" -Force
    
    • Principio: Sobrescribir el destino con una carpeta vacía para forzar el vaciado del contenido.
    • Advertencia: robocopy /MIR vaciará completamente el destino, ¡la dirección no debe invertirse!

Migración de Directorios de Usuario

Carpetas Estándar de Windows (Documents / Desktop / Downloads / Pictures / Videos)

  • Forma correcta: Hacer clic derecho en la carpeta → Propiedades → Ubicación → Mover.
  • Esto es un redireccionamiento a nivel de sistema. Cuando los programas obtienen la ruta a través de la API, se dirigirán automáticamente a la nueva ubicación.
  • Después de la migración, si la carpeta antigua no se puede eliminar por estar bloqueada, se puede reiniciar y luego procesar.

Datos de Aplicaciones de Terceros

  • Forma incorrecta: Cortar directamente las carpetas de la aplicación en AppData o Documents a la nueva unidad.
  • Forma correcta: Entrar en la configuración de cada software y modificar la "Ubicación de almacenamiento/archivos", permitiendo que el software realice la migración por sí mismo.
  • Excepción: Las bibliotecas de juegos de Steam se pueden agregar/migrar desde la configuración de Steam.

Análisis de Bibliotecas de Juegos

Steam

  • Carpeta de la biblioteca: steamapps\common\ (juego en sí).
  • Descargas incompletas: steamapps\downloading\ (se puede eliminar de forma segura).
  • Workshop: steamapps\workshop\ (se puede limpiar manualmente después de cancelar la suscripción).
  • Desinstalar juegos debe hacerse a través del cliente de Steam, no eliminar la carpeta directamente.

WeGame

  • Datos de la plataforma: WEGAME\.
  • Datos del juego: WeGameApps\rail_apps\.
  • Juegos grandes comunes: LOL (~40-50 GB), Valorant (~30 GB).

Trampas Comunes y Experiencia

  1. Riesgo de robocopy /MIR

    • /MIR es igual a la sincronización de espejo, eliminará los archivos sobrantes en el destino. Usar la dirección incorrecta puede vaciar los datos.
    • Las operaciones en directorios grandes pueden exceder el tiempo de espera, pero el proceso de robocopy continuará ejecutándose en segundo plano, causando que las E/S posteriores se bloqueen.
    • Solución: Después de la operación, verificar si hay residuos con Get-Process robocopy, y si es necesario, terminar el proceso a la fuerza.
  2. Truco de Robocopy Vacío (para eliminar carpetas resistentes)

    • Cuando el archivo está bloqueado, no se tienen permisos, o incluso takeown falla, se puede usar una carpeta vacía + /MIR para forzar el vaciado del destino.
    • Obligatorio: Primero crear una carpeta vacía independiente como origen, confirmar que la ruta de destino es correcta y luego ejecutar.
    • Nunca usar directorios del sistema (como C:\Windows) como destino.
  3. Contaminación de la Salida del Escaneo

    • Ejecutar múltiples Get-ChildItem | Format-Table en paralelo en un solo comando de Shell puede mezclar los flujos de salida (ej. resultados de NVIDIA Corporation mezclados con la carpeta Tencent).
    • Solución: Escanear solo un directorio a la vez, o usar scripts de Python para una salida unificada.
  4. Comportamiento Asíncrono del Desinstalador NSIS

    • Los desinstaladores silenciosos con el parámetro /S pueden volver inmediatamente después de iniciarse, sin bloquearse hasta que finalice.
    • Solución: Después de iniciarlo, sondear si el directorio de instalación ha desaparecido, o verificar la lista de procesos.
  5. Bloqueo de Archivos

    • WeChat, WPS, QQ y otras aplicaciones que se ejecutan en segundo plano bloquean sus propios archivos de datos, impidiendo que la carpeta se pueda renombrar/eliminar.
    • Solución: Primero cerrar el proceso correspondiente (incluyendo procesos residentes), luego operar.
  6. Nombres de Archivo Unicode

    • Los nombres de archivo en chino de Windows pueden causar errores de codificación en PowerShell/Python.
    • Solución: En scripts de Python, usar .encode('ascii', 'replace').decode('ascii') para una salida segura.
  7. Tiempo de Espera de Measure-Object -Sum

    • Para directorios que contienen cientos de miles de archivos (como cachés de WeChat, recursos de juegos), Get-ChildItem -Recurse junto con Measure-Object puede exceder el tiempo de espera.
    • Solución: Usar robocopy $path \NULL /L /S /NJH /NJS /BYTES para contar, o limitar la profundidad del escaneo.
  8. Estrategia Definitiva para Buscar en Directorios Grandes (Jerarquía + Palabras Clave)

    • Get-ChildItem -Recurse y robocopy /L /S pueden exceder el tiempo de espera en bibliotecas de juegos de Steam o en escaneos de discos completos.
    • Solución:
      1. Filtro grueso: Usar os.scandir para escanear solo las carpetas >5 GB en el directorio raíz, instantáneo.
      2. Profundizar: Usar tree_size_scanner.py para adentrarse capa por capa en los grandes consumidores.
      3. Búsqueda dirigida: Usar find_folders_by_keyword.py para una coincidencia de palabras clave en nombres de directorio con profundidad limitada (≤6 niveles), sin calcular tamaño, para evitar tiempos de espera.
      4. Solo si los tres pasos anteriores no encuentran nada, considerar la recursión completa del disco.

Lista de Herramientas de Script

  • scripts/tree_size_scanner.py <path> [min_mb] [max_depth] — Escaneo jerárquico, desde el directorio raíz profundizando en la carpeta más grande, generando un mapa de ocupación del disco.
  • scripts/scan_large_folders.py <path> — Escaneo rápido de carpetas grandes en una ruta específica (profundidad limitada para evitar tiempos de espera).
  • scripts/scan_programdata.py — Escaneo dirigido de C:\ProgramData, clasificando y mostrando carpetas grandes por nivel de seguridad.
  • scripts/find_folders_by_keyword.py <path> <pattern> — Búsqueda profunda de carpetas por palabra clave (profundidad 6 niveles, sin calcular tamaño, muy rápida).
  • scripts/find_zombie_packages.py — Analiza el entorno pip global, lista los paquetes de nivel superior y los conflictos de dependencias.
  • scripts/cleanup_temp.ps1 [-WhatIf] — Limpieza segura de Temp, cachés del navegador, pip cache, WinSxS (soporta modo de vista previa).
  • scripts/robocopy_wipe.py <target> — Elimina carpetas resistentes usando el truco de robocopy vacío (con verificación de seguridad de la ruta).

Plantilla de Salida

Al informar al usuario, usar la siguiente plantilla de tabla:

ÁreaTamañoRiesgoSugerencia
......🟢/🟡/🔴...

Informe posterior a la limpieza:

UnidadDisponible AntesDisponible DespuésEspacio Liberado
............

Skills relacionados