Communitygithub.com

tzwkb/memory-cleanup

Skill para agente — limpeza de memória no Windows e correção de vazamentos do pool não paginado.

O que é memory-cleanup?

Este skill capacita um agente de IA (como Claude Code, Cursor ou Codex) a diagnosticar e resolver problemas de memória no Windows, focando especialmente em vazamentos do pool não paginado causados pelo driver Ndu.sys (Network Data Usage) e por drivers de Wi-Fi como o MediaTek MT7921. Ele realiza uma varredura completa de processos, serviços, tarefas agendadas, chaves Run e pool não paginado, classificando cada item como seguro (🟢), impactante (🟡) ou proibido (🔴). A execução da limpeza desabilita apenas itens conhecidos como bloatware ou sem risco, gera automaticamente um script de restauração unificado (`memory_restore.ps1`) na área de trabalho do usuário, e segue uma política de 'não relatar resultados finais antes da reinicialização'. O skill é compatível com qualquer sistema Windows 10/11 e oferece scripts auxiliares para análise detalhada, eliminação de processos reincidentes e instalação limpa de drivers de GPU (sem o painel Adrenalin).

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add tzwkb/memory-cleanup

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Memory Cleanup Master — Mestre de Limpeza de Memória para Windows

Princípios Fundamentais

  1. Varredura agressiva, desabilitação conservadora
    • Varredura: captura completa de processos, serviços, tarefas agendadas, chaves Run, pool não paginado
    • Desabilitação: apenas bloatware conhecido e itens sem risco, não mexe em processos de trabalho do usuário
  2. Atualizar imediatamente o script de restauração após cada modificação
    • Caminho fixo do script de restauração: $env:USERPROFILE\Desktop\memory_restore.ps1
    • Após qualquer operação de desabilitação/modificação, sincronizar e atualizar o script de restauração, cobrindo todas as alterações históricas
    • Escopo do script de restauração: serviços (incluindo NDU), tarefas agendadas, chaves Run, registro (compactação de memória, arquivo de paginação)
    • Não criar vários arquivos de restauração como restore_services.ps1; tudo unificado em memory_restore.ps1
  3. Não relatar resultado final antes da reinicialização
    • Operações de desabilitação precisam de reinicialização para surtir efeito; antes dela, exibe-se o estado atual

Classificação de Segurança

NívelSignificadoExemplo
🟢 SeguroSabidamente inútil, desabilitar não afeta funcionalidadesBloat ASUS, DiagTrack, DoSvc, PnkBstrA, correção NDU
🟡 ImpactanteDesabilitar perde funcionalidade, mas esta pode não ser necessáriaWSearch (busca mais lenta), SysMain (sem impacto em SSD), Windows Hello
🔴 ProibidoEm uso pelo usuário ou essencial ao sistemaClaude, WSL, scripts Python abertos pelo usuário, RpcSs, DcomLaunch

Fluxo de Trabalho Padrão

Etapa 1: Varredura

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

Saída inclui:

  • Total de RAM / RAM disponível / Uso
  • Tamanho do pool não paginado e alerta de vazamento (>500 MB)
  • Status do NDU
  • Memória VM do WSL
  • Top 25 processos por memória privada
  • Lista de serviços bloatware conhecidos
  • Serviços de inicialização automática não MS não classificados
  • Chaves Run
  • Tarefas agendadas não MS

Etapa 2: Análise

Conferir com references/known_bloat.md para classificar:

  • Corresponde a padrão conhecido → 🟢 ou 🟡
  • Serviço não classificado → verificar DisplayName e PathName, decidir se seguro
  • Processos de trabalho do usuário → 🔴 excluir

Pool não paginado > 500 MB → priorizar correção:

  1. Verificar status do NDU
  2. Se NDU já desabilitado mas vazamento persiste → verificar driver Wi-Fi/placa de rede (MediaTek MT7921, Killer são vazamentos conhecidos)

Etapa 3: Apresentar ao Usuário

Usar tabela para exibir:

  • Processos pesados (quais estão consumindo memória)
  • Status do pool não paginado
  • Serviços que podem ser desabilitados (classificados por 🟢🟡)
  • Tarefas agendadas que podem ser desabilitadas
  • Chaves Run que podem ser removidas

Deixar o usuário decidir o que processar. Instrução em lote "desabilitar todos" pode executar todos os itens 🟢, itens 🟡 confirmar um por um.

Etapa 4: Executar Limpeza

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

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

# Modo de pré-visualização
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 nomes de serviços, suporta aliases de categoria (ASUS/NVIDIA/QQ/WPS/Logitech/Other expansão em lote)
  • -Tasks — Lista de nomes de tarefas agendadas
  • -RunKeyNames — Lista de nomes de chaves Run
  • -DisableNdu — Corrigir vazamento NDU
  • -DryRun — Modo de pré-visualização
  • -RestoreScriptPath — Caminho do script de restauração

Etapa 5: Verificação

  • Após reinicialização, executar nova varredura e comparar com antes da desabilitação
  • Confirmar que pool não paginado caiu para abaixo de 500 MB
  • Confirmar que memória em espera diminuiu

Lista de Verificação Pós-Reinicialização

Alguns serviços podem voltar ao estado Automático após reinicialização, é preciso re-escaneá-los:

ItemMétodo de Verificação
RadeonSoftware.exeNão deve aparecer na lista de processos
DoSvcFrequentemente restaurado ao Auto pelo Windows
AMD External Events UtilityA instalação do driver pode reativá-lo
WidgetsNão deve haver processos relacionados
Dispersão de msedgewebview2Não deve exceder 3 instâncias
Tarefas agendadasNão deve haver novas tarefas Ready
Pool não paginadoNDU desabilitado + driver MT7921 novo → deve ser < 500 MB

Correção de Vazamento NDU (Problema Frequente)

O driver Windows Network Data Usage Ndu.sys é a principal causa de vazamento do pool não paginado.

Sintomas: Pool não paginado de 1-3+ GB, Gerenciador de Tarefas não atribui a nenhum processo, começa a crescer desde a inicialização.

Correção:

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

Reiniciar para aplicar. Impacto: estatísticas de tráfego nas Configurações ficam em branco, funcionalidade de rede não é afetada.

Vazamento do Driver Wi-Fi MT7921 (Frequente em Notebooks ASUS TUF/ROG)

Drivers antigos do MediaTek MT7921 vazam pool não paginado continuamente. Priorizar investigação quando NDU estiver desabilitado e ainda >500 MB.

Verificar:

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

Se versão atual < 25.x, precisa atualizar.

Procedimento de Correção:

  1. Abrir Catálogo de Atualizações da Microsoft
  2. Ordenar por Última Atualização, baixar o arquivo .cab mais recente
  3. Extrair e instalar:
C:\Windows\System32\expand.exe <arquivo.cab> -F:* C:\MT7921_Driver
pnputil /add-driver C:\MT7921_Driver\mtkwl6ex.inf /install
  1. Reiniciar para aplicar. Observação: A extração do CAB deve usar o caminho completo C:\Windows\System32\expand.exe, caso contrário o comando expand do bash pode conflitar.

Purificação do Driver de Vídeo AMD (Remover Adrenalin)

RadeonSoftware (~250 MB) é iniciado diretamente pelo driver de kernel AMD, desabilitar o serviço é inútil. Solução definitiva:

  1. Baixar o driver Adrenalin mais recente .exe do site oficial AMD
  2. Executar o instalador uma vez para extrair em C:\AMD\ (fechar quando aparecer o assistente)
  3. Localizar C:\AMD\...\Packages\Drivers\Display\WT6A_INF\*.inf
  4. Injetar apenas o driver:
pnputil /add-driver C:\AMD\AMD-Software-Installer\Packages\Drivers\Display\WT6A_INF\u*.inf /install
  1. Após reinicialização, RadeonSoftware não inicia mais. Para ter o painel de controle, reinstale o Adrenalin completo.

Escopo do Script de Restauração

Desktop/memory_restore.ps1 deve cobrir todos os tipos de modificação:

Tipo de ModificaçãoForma de Restauração
Desabilitar serviço (Set-Service)Set-Service -StartupType Automatic
Desabilitar NDU (registro)reg add ... Ndu ... /d 2
Habilitar compactação de memória (registro)Set-ItemProperty ... EnableCompression -Value 0
Migração de arquivo de paginação (CIM)Remove-CimInstance C: + Set-CimInstance E:
Desabilitar tarefa agendadaEnable-ScheduledTask -TaskName (com caminho completo)
Remover chaves RunSet-ItemProperty restaurar valor original

Lista de Scripts

ScriptFinalidade
scripts/scan_memory.ps1Varredura completa, gera relatório panorâmico de memória
scripts/cleanup_memory.ps1Executa limpeza de serviços/tarefas/chaves Run, gera automaticamente script de restauração
scripts/kill_bloat.ps1Mata processos bloatware conhecidos
scripts/kill_search.ps1Mata SearchHost / StartMenu / TextInputHost e outros processos ociosos
scripts/audit_full.ps1Auditoria profunda: compactação de memória, arquivo de paginação, serviços não MS, itens de inicialização, árvore de processos
scripts/squeeze.ps1Varre alvos de otimização restantes (processos >20 MB, processo pai webview, detecção de ressurgimento ASUS)
scripts/squeeze_kill.ps1Mata em lote cadeia webview + Widgets + PhoneExperienceHost + altera FontCache/CDP/transparência
scripts/permanent_disable.ps1Desabilitação permanente via Política de Grupo para Widgets + desinstalação do Phone Link + reiniciar explorer
scripts/find_respawns.ps1Diagnostica fonte de renascimento de processos (chave Run / tarefa / serviço)
scripts/check_gpu.ps1Consulta modelo da GPU e versão do driver
scripts/download_amd.ps1Baixa driver AMD (pode ser bloqueado por CDN)
scripts/install_amd_driver_only.ps1Extrai pacote AMD, injeta apenas o driver com pnputil (sem Adrenalin)
scripts/update_driver.ps1Verifica status do driver Wi-Fi MT7921
references/known_bloat.mdPadrões de bloatware conhecidos + explicação de mecanismos de renascimento + referência de técnicas de otimização
Desktop/memory_restore.ps1Script de restauração único, atualizado após cada modificação

Modelo de Saída

Relatório de Varredura

========== 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 serviços) ---
| Service | Category | Risk |
(lista completa)

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

Tabela de Sugestões de Limpeza

CategoriaItemRiscoDescrição
......🟢/🟡...

Resumo Pós-Limpeza

OperaçãoQuantidade
Serviços desabilitadosN
Tarefas desabilitadasN
Chaves Run removidasN
Correções de registroN
Liberação estimada~X GB
Script de restauraçãoDesktop/memory_restore.ps1

Mecanismo de Renascimento de Processos e Soluções Definitivas

Esta seção documenta processos teimosos já encontrados e seus princípios de renascimento.

ProcessoMecanismo de RenascimentoSolução Definitiva
RadeonSoftware (~250 MB)Driver de kernel AMD (amdwddmg.sys) inicia diretamente o painel de controle no espaço do usuário. Desabilitar o serviço AMD External Events Utility não adianta; a camada de driver ignora o estado do serviçoAo instalar driver AMD, escolher Driver Only (injetar INF do driver puro com pnputil), sem instalar o painel Adrenalin
asus_framework (~90 MB ×4)ArmourySocketServer.exe é o processo pai que o protege. asus_framework é um aplicativo Electron; ArmourySocketServer monitora e o reviveMatar ArmourySocketServer primeiro, depois matar asus_framework; desabilitar a tarefa agendada \ASUS\ArmourySocketServer
msedgewebview2 (pode chegar a 500 MB+)Widgets / SearchHost iniciam cada um um webview pai; o webview pai inicia em cadeia vários webviews filhosDesabilitar Widgets (Política de Grupo HKLM\SOFTWARE\Policies\Microsoft\Dsh); SearchHost não tem solução (busca na barra de tarefas)
Widgets (~17 MB + cadeia webview)Host de experiência do Shell do Windows é acionado por interação do usuárioRegistro de Política de Grupo AllowNewsAndInterests=0, desabilitação permanente
PhoneExperienceHost (~48 MB)Aplicativo Phone Link pré-instalado, inicia automaticamente em segundo plano no login do usuárioDesinstalar AppxPackage: Remove-AppxPackage *YourPhone*
SearchHost (~47 MB)Caixa de pesquisa da barra de tarefas; qualquer interação com a barra de tarefas o reiniciaSem solução definitiva. Se matar, ao clicar na caixa de pesquisa ele renasce
StartMenuExperienceHost (~67 MB)Menu Iniciar; clicar nele o reiniciaIdem
TextInputHost (~28 MB)Entrada de texto/teclado touch; quando o foco vai para uma caixa de texto, ele renasceIdem

Normas de Chamada do PowerShell

Proibido usar -Command com código contendo $_ / $_. / $(; o bash pode consumir essas variáveis.

# ❌ Errado: bash interpreta $_ como sua própria variável especial
powershell -Command "Get-Process | Where-Object { $_.Name -match 'foo' }"

# ✅ Correto: arquivo de script, PowerShell interpreta diretamente
powershell -File script.ps1

Se a lógica for simples, pode usar -Command mas evite $_ e $ dentro de {}. Quando precisar de filtros complexos, sempre escreva um arquivo .ps1 e execute com -File.

Limitações de Download de CDN

Links de download de drivers da AMD (Akamai) e ASUS (CDN Alibaba Cloud) são bloqueados/retornam 403 quando baixados diretamente do terminal:

FonteCDNcurlwgetIWRBITS
AMD drivers.amd.comAkamai❌ 403❌ 403❌ 403❌ 403
ASUS dlcdnets.asus.comAlibaba Cloud❌❌❌Não testado

Única forma confiável: Start-Process <url> para abrir o navegador, o usuário clica no botão de download manualmente. Após o download, o script assume as operações subsequentes.

Grandes Otimizações (Prioridade do Mais Alto para o Mais Baixo)

PrioridadeOperaçãoBenefício EsperadoRisco
🔴 Mais AltaAtivar compactação de memóriaEquivalente a +2-3 GBZero (Windows 10/11 já deveria vir ativado por padrão)
🔴 Mais AltaDesabilitar NDUCorrige principal causa de vazamento do pool não paginadoMuito Baixo (estatísticas de tráfego ficam em branco)
🟡 AltaMatar RadeonSoftware~250 MBSem painel não é possível configurar modos como Alternate Mode Direct Graphics
🟡 AltaMigrar arquivo de paginação de HDD para SSDGanho de desempenho de IOZero (benefício puro)
🟢 MédiaLimpeza de msedgewebview2100-500 MBInterface web de aplicativos relacionados pode parar de funcionar
🟢 MédiaDesabilitar Widgets~20 MB + cadeia webviewCartões de notícias não aparecem
🟢 MédiaDesinstalar Phone Link~50 MBNão é possível conectar celular ao PC
🔵 BaixaDesabilitar tarefas agendadas/serviços50-200 MBPerda de funcionalidades de atualização/componentes

Habilidades Relacionadas