Disk Cleanup Master — Maestro de Limpieza de Disco en Windows
Principios Fundamentales (Inquebrantables)
- 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.
- 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.
- 🟢 Verde (Seguro de eliminar): Temp, cachés del navegador, pip cache,
- 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-PSDrivepara obtener una vista general del espacio en las unidades. - Usar
scripts/tree_size_scanner.pypara 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-runo 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=freezepara ver el número total de paquetes.pip list --not-requiredpara encontrar los paquetes de nivel superior instalados directamente por el usuario (generalmente mucho menos que el total).pip checkpara verificar conflictos de dependencias.pip cache purgepara limpiar el caché de descarga de pip.- Limpiar los residuos de instalaciones dañadas que comienzan con
~ensite-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ía | Ruta Típica | Riesgo | Ejemplo |
|---|---|---|---|
| Datos de controladores | NVIDIA, NVIDIA Corporation, LGHUB, ASUS | 🔴 No tocar | Eliminarlos podría causar fallos en dispositivos |
| Datos globales de aplicaciones | Tencent, anaconda3, 0install.net | 🟡 Confirmar antes de eliminar | Se puede eliminar si no se usa la aplicación |
| Caché de instalación | Package Cache, Microsoft\VisualStudio | 🟡 Con precaución | Eliminarlos puede impedir desinstalar/reparar programas |
| Datos del sistema | Microsoft\Windows Defender, Microsoft\Search | 🔴 No tocar | Componentes 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:
-
Buscar el desinstalador en el registro
Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*" | Where-Object { $_.DisplayName -match "Anaconda" } -
Desinstalación silenciosa (instalador NSIS)
& "C:\ProgramData\anaconda3\Uninstall-Anaconda3.exe" /S- Nota: El parámetro
/Spuede 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 } - Nota: El parámetro
-
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" -
Último recurso para eliminar carpetas resistentes: Truco de Robocopy Vacío Cuando tanto
Remove-Item -Forcecomotakeown + icaclsfallan:$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 /MIRvaciará 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
-
Riesgo de robocopy /MIR
/MIRes 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.
-
Truco de Robocopy Vacío (para eliminar carpetas resistentes)
- Cuando el archivo está bloqueado, no se tienen permisos, o incluso
takeownfalla, se puede usar una carpeta vacía +/MIRpara 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.
- Cuando el archivo está bloqueado, no se tienen permisos, o incluso
-
Contaminación de la Salida del Escaneo
- Ejecutar múltiples
Get-ChildItem | Format-Tableen paralelo en un solo comando de Shell puede mezclar los flujos de salida (ej. resultados deNVIDIA Corporationmezclados con la carpetaTencent). - Solución: Escanear solo un directorio a la vez, o usar scripts de Python para una salida unificada.
- Ejecutar múltiples
-
Comportamiento Asíncrono del Desinstalador NSIS
- Los desinstaladores silenciosos con el parámetro
/Spueden 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.
- Los desinstaladores silenciosos con el parámetro
-
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.
-
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.
-
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 -Recursejunto conMeasure-Objectpuede exceder el tiempo de espera. - Solución: Usar
robocopy $path \NULL /L /S /NJH /NJS /BYTESpara contar, o limitar la profundidad del escaneo.
- Para directorios que contienen cientos de miles de archivos (como cachés de WeChat, recursos de juegos),
-
Estrategia Definitiva para Buscar en Directorios Grandes (Jerarquía + Palabras Clave)
Get-ChildItem -Recurseyrobocopy /L /Spueden exceder el tiempo de espera en bibliotecas de juegos de Steam o en escaneos de discos completos.- Solución:
- Filtro grueso: Usar
os.scandirpara escanear solo las carpetas >5 GB en el directorio raíz, instantáneo. - Profundizar: Usar
tree_size_scanner.pypara adentrarse capa por capa en los grandes consumidores. - Búsqueda dirigida: Usar
find_folders_by_keyword.pypara una coincidencia de palabras clave en nombres de directorio con profundidad limitada (≤6 niveles), sin calcular tamaño, para evitar tiempos de espera. - Solo si los tres pasos anteriores no encuentran nada, considerar la recursión completa del disco.
- Filtro grueso: Usar
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:
| Área | Tamaño | Riesgo | Sugerencia |
|---|---|---|---|
| ... | ... | 🟢/🟡/🔴 | ... |
Informe posterior a la limpieza:
| Unidad | Disponible Antes | Disponible Después | Espacio Liberado |
|---|---|---|---|
| ... | ... | ... | ... |