ArmenSl/windows-debloat

Desinchar o Windows (debloat)

Esta skill transforma um PC Windows pessoal e bagunçado em uma máquina enxuta sem perder nada que o usuário considere importante. A maioria desses pedidos é vaga e emocional ("remova todas as coisas ruins, apague tudo que não precisamos"). Seu trabalho é transformá-los em uma lista concreta que o usuário aprove, executá-la de forma confiável e provar o resultado.

Existem duas regras rígidas. Arquivos pessoais nunca são destruídos nesta máquina antes que exista uma cópia em outro lugar. Nada é desinstalado ou excluído até que o usuário tenha visto a lista.

Fluxo de trabalho

1. Levantamento (somente leitura)

Execute o levantamento incluído; ele não altera nada:

powershell -NoProfile -ExecutionPolicy Bypass -File <skill-dir>/scripts/survey.ps1

Ele informa o disco, RAM e CPU, se você é administrador, os tamanhos das pastas do usuário (com os maiores itens da Área de Trabalho/Documentos/Downloads), tamanhos de cache temporário e de atualização, entradas de inicialização, aplicativos Win32 instalados com seus tamanhos, aplicativos da Store e os processos que usam mais memória. Leia e classifique o que viu nos grupos do references/bloat-catalog.md.

2. Pergunte uma vez, em grupos

Pergunte com uma ferramenta de múltipla escolha, se disponível, em linguagem simples, com tamanhos e números de RAM para que o usuário veja por que cada item é importante. Cubra estes tópicos e recomende um padrão para cada um:

• Arquivos pessoais. Mova-os para uma pasta de arquivo, C:\Archive\<YYYY-MM-DD>\ (o padrão: instantâneo no mesmo disco, nada perdido), compacte-os ou arquive e apague depois que o usuário tiver copiado o arquivo para fora da máquina.
• Grupos de aplicativos. Bloat pesado de terceiros; bloat do Windows/OEM; aplicativos pessoais (chat, jogos, emuladores, VMs); ferramentas de desenvolvimento. Mantenha as ferramentas de desenvolvimento por padrão para uma máquina servidora ou de agente, porque um host de agente precisa de Git, Node, Python, um editor e um JDK. Remova-as apenas se o usuário disser explicitamente.
• Inicialização. Desabilite tudo não essencial ou mantenha sincronização em nuvem como o OneDrive.

Se o usuário escrever "use max agents / swarm", explique brevemente que os instaladores do Windows travam uns aos outros (erro MSI 1618), portanto as desinstalações devem ser executadas uma de cada vez. Apenas o levantamento somente leitura pode ser dividido.

3. Arquivar arquivos pessoais

Use Move-Item dentro do mesmo volume. É uma renomeação: instantânea e os arquivos permanecem intactos. Deixe atalhos .lnk e desktop.ini no lugar. Conte os itens movidos e com falha e relate-os. Mantenha o arquivo na máquina, a menos que o usuário tenha confirmado que existe uma cópia em outro lugar (USB, nuvem). Só então ofereça-se para excluí-lo e confirme primeiro, porque a exclusão não pode ser desfeita.

4. Limpar lixo, sem prejudicar a si mesmo

• Em %TEMP%, exclua apenas itens com mais de 1 dia e pule qualquer coisa em uma pasta claude ou em seu próprio bloco de anotações. Limpar todo o %TEMP% pode excluir os arquivos de trabalho do próprio agente, incluindo scripts que você está prestes a executar.
• C:\Windows\Temp e C:\Windows\SoftwareDistribution\Download precisam de administrador, portanto coloque-os no lote elevado (etapa 6).
• Esvazie a Lixeira apenas se o usuário concordar.

5. Aparar a inicialização, com um backup

Antes de remover qualquer valor de chave Run, escreva linhas nome = comando para <arquivo>\startup-backup.txt, para que o usuário possa restaurar uma entrada que sentir falta. As entradas Run do HKCU funcionam sem administrador; as entradas Run do HKLM vão no lote elevado. Nunca toque em SecurityHealth (Segurança do Windows) ou em entradas de driver de áudio e vídeo.

6. Desinstalar

Faça nesta ordem:

1. Aplicativos da Store (sem administrador): Remove-AppxPackage para cada um. O erro 0x80073CFA significa que o aplicativo é protegido pelo sistema: relate e siga em frente.

2. Aplicativos Win32 por usuário (sem administrador): aplicativos registrados em HKCU (Discord, aplicativos Electron por usuário). Pare seus processos primeiro e depois execute seus QuietUninstallString.

3. Aplicativos de toda a máquina (administrador): use scripts/elevated-uninstall.ps1. Ele aceita padrões de nome de aplicativo, resolve cada comando de desinstalação do registro, escreve um script elevado e o executa, para que o usuário aprove um prompt UAC em vez de dez. Ele registra cada etapa e aguarda o resultado:

   powershell -NoProfile -ExecutionPolicy Bypass -File <skill-dir>/scripts/elevated-uninstall.ps1 `
     -Patterns 'BlueStacks,WebAdvisor,Duet Display' -RemoveHklmRun 'Opera Browser Assistant' `
     -WorkDir 'C:\Archive\2026-11-08' -CleanSystemTemp
   

   Os padrões são expressões regulares separadas por vírgula que correspondem ao nome de exibição do aplicativo. Torne-os específicos: Microsoft 365 corresponderia ao próprio Office.

   Execute-o com -DryRun primeiro para mostrar os comandos resolvidos sem executar nada. O script já lida com:

   • Aplicativos MSI: msiexec /x {GUID} /qn /norestart, usando o nome da chave do registro quando UninstallString está vazio (VMware Player não tinha string de desinstalação).
   • Código de saída 1618 (outro instalador em execução): ele tenta novamente após uma breve espera.
   • Office Click-to-Run (Project, Visio): o comando ARP mais DisplayLevel=False.
   • Inno Setup (unins000.exe): /VERYSILENT /NORESTART.
   • Desinstaladores sem modo silencioso (McAfee, Zotero, BlueStacks): ele os executa interativamente. Antes de iniciar, informe ao usuário para aprovar o prompt UAC e clicar nessas janelas.

4. Reconsulte o registro depois. Qualquer coisa que sobrou recebe uma nova tentativa direcionada. Relate o restante honestamente.

7. Configurações de servidor (o usuário as executa)

As configurações de energia, suspensão, tampa e serviço são configurações do sistema. Forneça-as ao usuário como comandos a serem executados em um PowerShell de administrador, um por bloco de código, e explique o que cada um faz:

powercfg /change standby-timeout-ac 0
powercfg /change hibernate-timeout-ac 0
powercfg /setacvalueindex SCHEME_CURRENT SUB_BUTTONS LIDACTION 0
powercfg /setactive SCHEME_CURRENT

Opcional, também para o usuário decidir: criar um ponto de restauração antes de uma grande limpeza, definir horas ativas do Windows Update, configurar login automático ou "reiniciar aplicativos após login" para uso sem cabeça, e escolher o plano de energia Balanceado ou Alto desempenho enquanto estiver conectado.

8. Verificar e relatar

Meça o espaço livre antes e depois, e verifique novamente as listas de aplicativos e inicialização. Em seguida, relate:

• Feito: local do arquivo e contagem de itens, aplicativos removidos, entradas de inicialização desabilitadas, espaço liberado (antes → depois).
• Mantido intencionalmente: ferramentas de desenvolvimento, navegadores, Office, software de segurança, drivers, runtimes.
• Deixado para o usuário: reiniciar o PC, as configurações do servidor e copiar o arquivo para fora da máquina.

Nunca remover

Defender / Microsoft.SecHealthUI; drivers e serviços de driver OEM para áudio, vídeo e touchpad; Microsoft.WindowsStore; Microsoft.DesktopAppInstaller (winget); Windows Terminal; redistribuíveis VC++, .NET e outras estruturas (IsFramework); Microsoft.XboxIdentityProvider (outros aplicativos dependem dele); a ferramenta de segurança do usuário (por exemplo, Malwarebytes); o navegador que o usuário está usando atualmente; qualquer coisa na qual o próprio agente está sendo executado.