Communitygithub.com

memory-cleanup-master

Skill para agente — limpieza de memoria en Windows y corrección de fugas en el pool no paginado.

¿Qué es memory-cleanup-master?

Este skill permite a un agente de IA (como Claude Code) realizar un análisis exhaustivo de la memoria en sistemas Windows, identificar y corregir fugas de memoria en el pool no paginado (non-paged pool), y desactivar servicios y tareas innecesarias. Está diseñado para sistemas Windows 10/11 y cubre desde la detección de bloatware hasta la reparación de fugas conocidas como las causadas por el controlador NDU o el driver Wi-Fi MediaTek MT7921. El flujo de trabajo incluye cinco pasos: escaneo, análisis, presentación al usuario, limpieza y verificación post-reinicio. Genera automáticamente un script de restauración único en el escritorio del usuario para deshacer cualquier cambio. Soporta la desactivación segura de servicios, tareas programadas y claves de ejecución automática, clasificando cada elemento en niveles de riesgo (verde/amarillo/rojo) para evitar tocar procesos del sistema o del usuario. Incluye más de 15 scripts auxiliares para auditoría, eliminación de bloatware, desactivación permanente de widgets y más. Es compatible con PowerShell y utiliza exclusivamente archivos `.ps1` para evitar problemas de escape de variables del shell.

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

Preguntar en tu IA favorita

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

Documentación

Memory Cleanup Master — Limpieza de Memoria en Windows

Principios Fundamentales

  1. Escaneo agresivo, desactivación conservadora
    • Escaneo: capturar todos los procesos, servicios, tareas programadas, claves Run y el pool no paginado
    • Desactivación: solo desactivar bloatware conocido y elementos sin riesgo, no tocar procesos de trabajo del usuario
  2. Actualizar el script de restauración inmediatamente después de cada cambio
    • Ruta fija del script de restauración: $env:USERPROFILE\Desktop\memory_restore.ps1
    • Después de cualquier operación de desactivación/modificación, actualizar el script de restauración sincrónicamente, cubriendo todos los cambios históricos
    • El script de restauración cubre: servicios (incluyendo NDU), tareas programadas, claves Run, registro (compresión de memoria, archivo de paginación)
    • No crear otros archivos de restauración como restore_services.ps1, todo se fusiona en memory_restore.ps1
  3. No informar resultados finales antes del reinicio
    • Las operaciones de desactivación requieren reinicio para que surtan efecto; antes del reinicio se muestra el estado actual

Niveles de Riesgo

NivelSignificadoEjemplo
🟢 SeguroConocido como inútil, desactivarlo no afecta la funcionalidadASUS bloat, DiagTrack, DoSvc, PnkBstrA, corrección NDU
🟡 Con impactoDesactivarlo pierde funcionalidad, pero quizás no se necesitaWSearch (búsqueda más lenta), SysMain (SSD sin impacto), Windows Hello
🔴 ProhibidoEl usuario lo está usando o es parte del sistemaClaude, WSL, scripts de Python abiertos por el usuario, RpcSs, DcomLaunch

Flujo de Trabajo Estándar

Paso 1: Escaneo

powershell -NoProfile -ExecutionPolicy Bypass -File .claude/skills/memory-cleanup-master/scripts/scan_memory.ps1

Salida incluye:

  • Memoria total/disponible/uso
  • Tamaño del pool no paginado y advertencia de fuga (>500MB)
  • Estado de NDU
  • Memoria de VM WSL
  • Top 25 procesos por memoria privada
  • Lista de servicios bloatware conocidos
  • Servicios de autoinicio no clasificados que no son de MS
  • Claves Run
  • Tareas programadas que no son de MS

Paso 2: Análisis

Consultar references/known_bloat.md para clasificar:

  • Coincidencia con patrón conocido → 🟢 o 🟡
  • Servicios no clasificados → revisar DisplayName y PathName, determinar si son seguros
  • Procesos de trabajo del usuario → 🔴 excluir

Pool no paginado > 500 MB → Priorizar corrección:

  1. Revisar estado de NDU
  2. Si NDU ya está desactivado pero la fuga persiste → revisar controlador Wi-Fi/tarjeta de red (MediaTek MT7921, Killer conocidos por fugas)

Paso 3: Presentar al usuario

Usar tabla para mostrar:

  • Procesos que más memoria consumen (cuáles están comiendo memoria)
  • Estado del pool no paginado
  • Servicios que se pueden desactivar (clasificados por 🟢🟡)
  • Tareas programadas que se pueden desactivar
  • Claves Run que se pueden eliminar

Dejar que el usuario decida cuáles procesar. Una instrucción por lotes "desactivar todo" puede ejecutar todos los elementos 🟢, y los elementos 🟡 requieren confirmación uno por uno.

Paso 4: Ejecutar limpieza

# Desactivar servicios específicos
powershell -NoProfile -ExecutionPolicy Bypass -File .claude/skills/memory-cleanup-master/scripts/cleanup_memory.ps1 -Services 'ASUS','NVIDIA','QQ' ...

# Desactivar NDU
powershell -NoProfile -ExecutionPolicy Bypass -File .claude/skills/memory-cleanup-master/scripts/cleanup_memory.ps1 -DisableNdu

# Modo de vista previa
powershell -NoProfile -ExecutionPolicy Bypass -File .claude/skills/memory-cleanup-master/scripts/cleanup_memory.ps1 -DryRun -Services 'ASUS'

Parámetros de cleanup_memory.ps1:

  • -Services — Lista de nombres de servicio, admite alias de categoría (ASUS/NVIDIA/QQ/WPS/Logitech/Other para expansión por lotes)
  • -Tasks — Lista de nombres de tareas programadas
  • -RunKeyNames — Lista de nombres de claves Run
  • -DisableNdu — Corregir fuga de NDU
  • -DryRun — Modo de vista previa
  • -RestoreScriptPath — Ruta del script de restauración

Paso 5: Verificación

  • Volver a escanear después del reinicio, comparar antes y después de la desactivación
  • Confirmar que el pool no paginado haya bajado a menos de 500 MB
  • Confirmar que la memoria en reposo haya disminuido

Lista de Verificación Post-Reinicio

Algunos servicios pueden volver al estado Auto después del reinicio, es necesario volver a escanear para confirmar:

ElementoMétodo de verificación
RadeonSoftware.exeNo debe aparecer en la lista de procesos
DoSvcA menudo Windows lo restaura a Auto
AMD External Events UtilityLa instalación del controlador puede reactivarlo
WidgetsNo debe haber procesos relacionados
Propagación de msedgewebview2No debe haber más de 3 instancias
Tareas programadasNo debe haber nuevas tareas Ready
Pool no paginadoNDU desactivado + controlador MT7921 nuevo → debe ser < 500MB

Corrección de Fuga de NDU (Problema Frecuente)

El controlador de uso de datos de red de Windows Ndu.sys es la causa principal de fugas en el pool no paginado.

Síntomas: Pool no paginado de 1-3+ GB, el Administrador de tareas no lo atribuye a ningún proceso, comienza a crecer desde el arranque.

Corrección:

reg add "HKLM\SYSTEM\CurrentControlSet\Services\Ndu" /v Start /t REG_DWORD /d 4 /f

Reinicie para que surta efecto. Impacto: las estadísticas de tráfico en Configuración se vuelven en blanco, la funcionalidad de red no se ve afectada.

Fuga del Controlador Wi-Fi MT7921 (Frecuente en Laptops ASUS TUF/ROG)

Las versiones antiguas del controlador MediaTek MT7921 pueden provocar una fuga continua del pool no paginado. Si después de desactivar NDU sigue siendo >500 MB, priorizar la revisión de esto.

Verificación:

Get-NetAdapter | Where-Object { $_.InterfaceDescription -match 'MT7921' }

Si la versión actual es < 25.x, necesita actualización.

Proceso de corrección:

  1. Abrir Catálogo de Actualizaciones de Microsoft
  2. Ordenar por Última actualización, descargar el archivo .cab más reciente
  3. Desempaquetar e instalar:
C:\Windows\System32\expand.exe <archivo.cab> -F:* C:\MT7921_Driver
pnputil /add-driver C:\MT7921_Driver\mtkwl6ex.inf /install
  1. Reiniciar para que surta efecto. Nota: El desempaquetado del CAB debe usar la ruta completa C:\Windows\System32\expand.exe, de lo contrario el expand de bash puede causar conflictos.

Purificación del Controlador de GPU AMD (Eliminar Adrenalin)

RadeonSoftware (~250 MB) es iniciado directamente por el controlador del kernel de AMD, desactivar servicios no sirve. La solución definitiva:

  1. Descargar el último controlador Adrenalin .exe desde el sitio web de AMD
  2. Ejecutar el instalador una vez para que desempaquete en C:\AMD\ (cerrar cuando aparezca el asistente de instalación)
  3. Encontrar C:\AMD\...\Packages\Drivers\Display\WT6A_INF\*.inf
  4. Inyectar solo el controlador:
pnputil /add-driver C:\AMD\AMD-Software-Installer\Packages\Drivers\Display\WT6A_INF\u*.inf /install
  1. Después de reiniciar, RadeonSoftware ya no se inicia. Si se necesita el panel, reinstalar el Adrenalin completo.

Alcance del Script de Restauración

Desktop/memory_restore.ps1 debe cubrir todos los tipos de modificaciones:

Tipo de modificaciónMétodo de restauración
Desactivar servicio (Set-Service)Set-Service -StartupType Automatic
Desactivar NDU (registro)reg add ... Ndu ... /d 2
Habilitar compresión de memoria (registro)Set-ItemProperty ... EnableCompression -Value 0
Migración de archivo de paginación (CIM)Remove-CimInstance C: + Set-CimInstance E:
Desactivar tarea programadaEnable-ScheduledTask -TaskName (con ruta completa)
Eliminar claves RunSet-ItemProperty restaurar valor original

Lista de Scripts

ScriptPropósito
scripts/scan_memory.ps1Escaneo completo, genera informe panorámico de memoria
scripts/cleanup_memory.ps1Ejecuta limpieza de servicios/tareas/claves Run, genera automáticamente script de restauración
scripts/kill_bloat.ps1Mata procesos bloatware conocidos
scripts/kill_search.ps1Mata procesos perezosos como SearchHost / StartMenu / TextInputHost
scripts/audit_full.ps1Auditoría profunda: compresión de memoria, archivo de paginación, servicios no MS, elementos de inicio, árbol de procesos
scripts/squeeze.ps1Escanea objetivos de optimización restantes (procesos >20MB, procesos padre de webview, detección de resurrección de ASUS)
scripts/squeeze_kill.ps1Mata por lotes cadena webview + Widgets + PhoneExperienceHost + modificar FontCache/CDP/transparencia
scripts/permanent_disable.ps1Desactivación permanente de Widgets mediante directiva de grupo + desinstalación de Phone Link + reiniciar explorer
scripts/find_respawns.ps1Diagnóstico de origen de resurrección de procesos (clave Run / tarea / servicio)
scripts/check_gpu.ps1Consulta modelo de GPU y versión del controlador
scripts/download_amd.ps1Descargar controlador AMD (puede ser bloqueado por CDN)
scripts/install_amd_driver_only.ps1Extraer paquete de controlador AMD, inyectar solo el controlador con pnputil (sin Adrenalin)
scripts/update_driver.ps1Verificar estado del controlador Wi-Fi MT7921
references/known_bloat.mdPatrones de bloatware conocidos + explicación de mecanismos de resurrección + referencias técnicas de optimización
Desktop/memory_restore.ps1Único script de restauración, actualizado sincrónicamente después de cada modificación

Plantillas de Salida

Informe de Escaneo

========== Memory Scan Report ==========
Total RAM: 15.2 GB | Available: 2.1 GB | Usage: 86%
Non-Paged Pool: 1680 MB *** WARNING: >500MB ***
NDU: auto  *** FIX REQUIRED ***
WSL VM Memory: 4100 MB

--- Top 10 Processes ---
(lista completa)

--- Known Bloatware (X servicios) ---
| Service | Category | Risk |
(lista completa)

--- Run Keys (Y entradas) ---
(lista completa)
========== End Report ==========

Tabla de Sugerencias de Limpieza

CategoríaElementoRiesgoDescripción
......🟢/🟡...

Resumen Post-Limpieza

OperaciónCantidad
Servicios desactivadosN
Tareas desactivadasN
Claves Run eliminadasN
Correcciones de registroN
Liberación estimada~X GB
Script de restauraciónDesktop/memory_restore.ps1

Mecanismos de Resurrección de Procesos y Soluciones Definitivas

Esta sección documenta los procesos recalcitrantes encontrados y sus principios de resurrección.

ProcesoMecanismo de resurrecciónSolución definitiva
RadeonSoftware (~250 MB)El controlador del kernel de GPU AMD (amdwddmg.sys) inicia directamente el panel de control en modo usuario. Desactivar el servicio AMD External Events Utility no sirve, la capa del controlador ignora el estado del servicioAl instalar el controlador AMD, seleccionar Solo controlador (inyectar el INF del controlador puro con pnputil), no instalar el panel de control Adrenalin
asus_framework (~90 MB ×4)ArmourySocketServer.exe es el proceso padre guardián. asus_framework es una aplicación Electron, ArmourySocketServer la monitorea y la resucitaPrimero matar ArmourySocketServer y luego asus_framework; desactivar la tarea programada \ASUS\ArmourySocketServer
msedgewebview2 (puede alcanzar 500 MB+)Widgets / SearchHost inician un webview padre cada uno, y el webview padre inicia varios webview hijos en cadenaDesactivar Widgets (directiva de grupo HKLM\SOFTWARE\Policies\Microsoft\Dsh); SearchHost no tiene solución (búsqueda de barra de tareas)
Widgets (~17 MB + cadena webview)El host de experiencia de shell de Windows se activa según la interacción del usuarioRegistro de directiva de grupo AllowNewsAndInterests=0, desactivación permanente
PhoneExperienceHost (~48 MB)Aplicación Phone Link preinstalada, se inicia automáticamente en segundo plano al iniciar sesiónDesinstalar AppxPackage: Remove-AppxPackage *YourPhone*
SearchHost (~47 MB)Cuadro de búsqueda de la barra de tareas, cualquier interacción del usuario con la barra de tareas lo reiniciaNo se puede solucionar definitivamente. Si se mata, al hacer clic en la barra de búsqueda resucita inmediatamente
StartMenuExperienceHost (~67 MB)Menú de inicio, se reinicia al hacer clicLo mismo
TextInputHost (~28 MB)Entrada de texto/teclado táctil, se reinicia al enfocar un cuadro de textoLo mismo

Normas de Invocación de PowerShell

Prohibido usar -Command con código que contenga $_ / $_. / $( , porque bash se comerá estas variables.

# ❌ Incorrecto: bash interpreta $_ como su propia variable especial
powershell -Command "Get-Process | Where-Object { $_.Name -match 'foo' }"

# ✅ Correcto: archivo de script, PowerShell lo analiza directamente
powershell -File script.ps1

Si la lógica es simple, se puede usar -Command pero evitando $_ y $ dentro de {}. Cuando se necesite filtrado complejo, siempre escribir un archivo .ps1 y luego ejecutarlo con -File.

Limitaciones de Descarga CDN

Los enlaces de descarga de controladores de AMD (Akamai) y ASUS (CDN de Alibaba Cloud) pueden ser bloqueados/403 al descargarlos directamente desde el terminal:

FuenteCDNcurlwgetIWRBITS
AMD drivers.amd.comAkamai❌ 403❌ 403❌ 403❌ 403
ASUS dlcdnets.asus.comAlibaba Cloud❌❌❌No probado

Única forma confiable: Start-Process <url> para abrir el navegador, el usuario hace clic en el botón de descarga manualmente. Una vez descargado, el script se encarga de las operaciones posteriores.

Grandes Optimizaciones (Prioridad de Mayor a Menor)

PrioridadOperaciónBeneficio esperadoRiesgo
🔴 Más altaHabilitar compresión de memoriaEquivalente a +2-3 GBCero (Windows 10/11 debería tenerlo activado por defecto)
🔴 Más altaDesactivar NDUCorrige la causa principal de la fuga del pool no paginadoMuy bajo (las estadísticas de tráfico se vuelven en blanco)
🟡 AltaMatar RadeonSoftware~250 MBSin panel no se puede ajustar el modo de conexión directa de la GPU dedicada, etc.
🟡 AltaMigrar archivo de paginación HDD→SSDMejora de rendimiento de E/SCero (beneficio puro)
🟢 MediaLimpieza de msedgewebview2100-500 MBLa interfaz web de aplicaciones relacionadas deja de funcionar
🟢 MediaDesactivar Widgets~20 MB + cadena webviewNo se ven las tarjetas de noticias
🟢 MediaDesinstalar Phone Link~50 MBNo se puede conectar el PC al teléfono
🔵 BajaDesactivar tareas programadas/servicios50-200 MBPérdida de funcionalidad de actualizaciones/componentes varios

Skills relacionados