Skip to content

Latest commit

 

History

125 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

COMPARTDISK

License Release Changelog Platform PowerShell

Assistente de Reparo para Windows

Ferramenta de manutenção que reúne, em menus numerados, as tarefas de reparo, limpeza, diagnóstico e verificação de segurança do Windows. Usa exclusivamente componentes nativos do sistema operacional, sem instalação e sem dependências. Compatível atualmente com Windows 10 e Windows 11.

Desenvolvido por Edsilas

Important

Versão atual: 1.5.0. Baixe o pacote e leia as notas de lançamento em Releaseshttps://github.com/edsilas/COMPARTDISK/releases


Índice

Seção Conteúdo
1. Visão geral O que a ferramenta faz e a quem se destina
2. Como funciona Fluxo de execução, do comando ao relatório
3. Recursos Capacidades principais
4. Pré-requisitos O que é necessário antes de começar
5. Início rápido Executar em um comando ou instalar localmente
6. Interface Como a ferramenta se apresenta e o mapa dos menus
7. Desbloat do Windows Remover o que veio pré-instalado
8. Uso avançado Execução desassistida e parque de máquinas
9. Segurança e privacidade O que a ferramenta faz e não faz com seus dados
10. Documentação Índice completo dos guias e manuais
11. Solução de problemas Primeiros passos quando algo falha
12. Contribuindo Como relatar problemas e sugerir melhorias
13. Licença Termos de uso e distribuição
14. Marcas registradas Avisos legais

1. Visão geral

O COMPARTDISK reúne, em um único programa, as tarefas de manutenção que normalmente exigiriam dezenas de comandos digitados à mão: reparar o Windows, consertar a internet, liberar espaço em disco, verificar a saúde dos discos, revisar a segurança do computador e gerar um relatório completo do estado da máquina.

Você navega por menus numerados. Escolhe uma opção, aperta a tecla, e a ferramenta faz o resto — explicando na tela o que está acontecendo e registrando tudo em um arquivo de log.

A quem se destina

Perfil Como a ferramenta ajuda
Usuário doméstico Resolve problemas comuns sem precisar pesquisar comandos ou seguir tutoriais
Técnico de suporte Padroniza o diagnóstico e gera um relatório anexável ao chamado
Administrador de TI Executa auditorias desassistidas em parque de máquinas, com saída em CSV e JSON

Note

Não é preciso saber programar. Não é preciso conhecer PowerShell nem Batch.


2. Como funciona

O arquivo Launcher.bat é o programa: nele estão a interface, os menus, a autoelevação, a detecção de ambiente e o controle de fluxo. O PowerShell é um motor acoplável — quando existe, assume as operações complexas; quando não existe, o Batch executa a mesma funcionalidade por rotinas próprias.

Regra de ouro do projeto: nenhuma funcionalidade deixa de existir por ausência de PowerShell.

Fluxo de execução

flowchart TD
    R["<b>Execução remota</b><br/>um comando no PowerShell"]
    L["<b>Instalação local</b><br/>Launcher.bat"]

    R --> DL["Baixa o pacote, confere a assinatura ZIP<br/>e valida SHA-256 quando publicado"]
    DL --> P
    L --> P

    P{"Tem privilégio de<br/>administrador?"}
    P -- "não" --> UAC["Solicita elevação via UAC<br/>e relança com sentinela interna"]
    UAC --> P
    P -- "sim" --> BOOT

    BOOT["<b>Inicialização</b> — 12 etapas<br/>cada uma registrada em<br/>COMPARTDISK_Bootstrap.log"]
    BOOT --> ENG{"Seleção do motor<br/>validada na prática"}

    ENG -- "1º" --> PS7["PowerShell 7"]
    ENG -- "2º" --> PS5["Windows PowerShell 5.1"]
    ENG -- "nenhum responde" --> BAT["Batch puro"]

    PS7 --> MENU
    PS5 --> MENU
    BAT --> MENU

    MENU(["<b>Menu principal</b><br/>tecla numérica, sem Enter"])
    MENU --> MOD["Módulo correspondente<br/>em Modules"]
    MOD --> EXIT{"Código de saída"}

    EXIT -- "0 · 1 · 2 · 3" --> LOG["Resultado registrado no log<br/>e nas constatações da sessão"]
    EXIT -- "9001 · 9002" --> FB["<b>Rotina Batch equivalente</b><br/>PowerShell indisponível<br/>ou módulo ausente"]
    FB --> LOG
    LOG --> MENU

    MENU -- "tecla 0" --> FIM["Relatório salvo<br/>temporários removidos"]

    classDef entrada fill:#0078D4,stroke:#005A9E,color:#fff
    classDef fallback fill:#FFF4CE,stroke:#9D5D00,color:#3B2300
    classDef final fill:#DFF6DD,stroke:#107C10,color:#0B5A0B
    class R,L entrada
    class FB fallback
    class FIM final
Loading

Se a partida falhar, a última linha de %TEMP%\COMPARTDISK_Bootstrap.log aponta exatamente em qual das doze etapas o processo parou.

Detecção de privilégio

A verificação é feita em três camadas, nesta ordem: fltmc, net session e escrita de teste em HKLM. O net session não é usado isoladamente porque falha quando o serviço Server está parado — comum em Windows Home e imagens corporativas endurecidas, cenário em que um administrador legítimo seria classificado como usuário comum.

Detalhes completos em Arquitetura.


3. Recursos

Recurso Descrição
Reparo automático Corrige em sequência os problemas mais comuns do Windows, com uma única tecla
Diagnóstico completo Gera o retrato da máquina em quatro formatos: TXT, CSV, JSON e HTML
Rede e internet Restaura conectividade, DNS, Winsock e firewall; preserva IP fixo e proxy
Limpeza de disco Inclui modo de simulação, que mede o espaço recuperável antes de apagar
Segurança Revisa Defender, firewall, contas, BitLocker, TPM e Secure Boot
Hardware e discos Saúde física dos discos, desgaste da bateria, drivers e inventário completo
Diagnóstico e reparo de impressão Diagnostica impressora local, de rede e compartilhada antes de corrigir; toda correção tem backup e reversão
Desbloat do Windows Remove aplicativos pré-instalados, com simulação, três níveis de risco e reversão
Operação sem PowerShell Cada função possui rotina Batch equivalente para ambientes restritos
Execução remota Um único comando executa a versão mais recente, com validação de integridade

4. Pré-requisitos

Sistema operacional

  • Windows — compatível atualmente com Windows 10 (versão 1809 ou superior) e Windows 11
  • Edições Home, Pro, Education ou Enterprise
  • Arquitetura x64 ou ARM64

Permissões

  • Conta com privilégio de administrador

A ferramenta solicita a elevação automaticamente ao iniciar. Sem privilégio administrativo, o Windows recusaria a maior parte das operações.

Componentes opcionais

Nenhum é obrigatório. A ausência de qualquer um reduz a profundidade do diagnóstico, mas não remove funcionalidades.

Componente Se presente Se ausente
Windows PowerShell 5.1 Diagnóstico completo e relatórios nos quatro formatos Rotinas Batch assumem
PowerShell 7 O mesmo, com melhor desempenho O PowerShell 5.1 é utilizado
Winget Atualização de programas instalados e instalação de aplicativos pela Central O menu de aplicativos diagnostica e prepara o App Installer
PnPUtil Backup e inventário de drivers A opção informa indisponibilidade

Tip

Para verificar o que foi detectado na sua máquina, abra a opção [9] Ambiente de Execução e Capacidades no menu principal.

Detalhes completos em Requisitos do Sistema e Compatibilidade.


5. Início rápido

Há dois métodos de execução. Ambos rodam o mesmo programa, com os mesmos menus, módulos e fluxos.

Método A — Execução remota (um comando)

Sempre executa a versão estável mais recente, sem download manual e sem verificar atualizações. Abra o PowerShell como administrador e execute:

irm https://compartdisk.com.br/run | iex

O inicializador consulta a versão mais recente, baixa o pacote, confere a assinatura de arquivo ZIP e — quando a versão publica o valor nas notas da release — valida a integridade por SHA-256; se o valor não estiver publicado, o script avisa na tela e prossegue. Em seguida executa o Launcher.bat. Ao encerrar, remove todos os arquivos temporários — nada permanece no disco.

Endereço alternativo, direto pelo repositório

O endereço curto apenas encaminha para o script hospedado aqui no GitHub — nenhuma cópia é mantida fora do repositório. Se preferir não depender do domínio, ou se ele estiver indisponível, use a origem diretamente:

irm https://raw.githubusercontent.com/edsilas/compartdisk/main/remote.ps1 | iex

Os dois comandos executam exatamente a mesma coisa.

Tip

Indicado para uso pontual e atendimento de suporte. Para uso recorrente ou em máquinas com internet limitada, prefira o método B.

Detalhes, validação de integridade e configuração avançada em Guia de Execução Remota.

Método B — Instalação local

Passo 1 — Baixar e extrair

  1. Baixe o pacote mais recente em Releases.
  2. Clique com o botão direito no arquivo .zip, selecione Propriedades, marque Desbloquear e clique em OK.
  3. Extraia o conteúdo para uma pasta, por exemplo C:\COMPARTDISK.

Important

Não execute a ferramenta de dentro do arquivo compactado. O Windows abre o conteúdo em uma pasta temporária somente leitura, e os relatórios não poderão ser gravados.

Passo 2 — Executar

  1. Clique com o botão direito em Launcher.bat.
  2. Selecione Executar como administrador.
  3. Confirme a solicitação do Controle de Conta de Usuário.

Não há instalador, dependências para baixar ou alterações permanentes no sistema. Para desinstalar, apague a pasta.

Passo 3 — Primeiro diagnóstico

Comece por operações que não alteram nada no computador:

Ordem Caminho Resultado
1 Menu [9] Mostra o que a ferramenta detectou no seu Windows
2 Menu [8] → opção [2] Auditoria rápida, em menos de um minuto
3 Menu [8] → opção [1] Auditoria completa, com relatório HTML
4 Menu [4] → opção [4] Simula a limpeza e mede o espaço recuperável

Somente depois disso vale usar as opções que modificam o sistema.

Instruções detalhadas em Guia de Instalação.

Qual método usar

Critério Execução remota Instalação local
Versão executada Sempre a mais recente A que você baixou
Ocupa espaço em disco Não Menos de 1 MB
Funciona sem internet Não Sim
Indicado para Uso pontual, suporte técnico Uso recorrente, parque de máquinas

6. Interface

  COMPARTDISK  1.5.0
  Assistente de Reparo

  --------------------------------------------------------------------------

   [1]  Reparo Geral Automatico (One-Click Fix)
   [2]  Aplicativos: Atualizar e Instalar (Winget)
   [3]  Rede, Internet e Conectividade
   [4]  Otimizacao, Limpeza Profunda e Privacidade
   [5]  Reparo do Sistema, Windows Update e Explorer
   [6]  Contas, Permissoes e Seguranca
   [7]  Diagnostico e Reparo de Impressao
   [8]  Diagnostico Avancado e Relatorios (TXT/CSV/JSON/HTML)
   [9]  Ambiente de Execucao e Capacidades

   [0]  Sair e Salvar Relatorio

  --------------------------------------------------------------------------
  Motor: Windows PowerShell 5.1
  Log:   C:\COMPARTDISK\Relatorio_Manutencao.txt
  DESENVOLVIDO POR EDSILAS

  Opcao:

A navegação é feita por teclas numéricas, sem necessidade de pressionar Enter. A tecla 0 retorna à tela anterior — exceto na Central de Aplicativos, onde os números são dos aplicativos e a navegação usa P (nova pesquisa) e V (voltar) em todas as telas. O rodapé indica qual motor está em uso e onde o registro está sendo gravado.

Mapa dos menus

Uma opção executa direto; as demais abrem submenus. O número entre parênteses é a quantidade de opções de cada tela.

flowchart LR
    MP(["<b>Menu principal</b>"])

    MP --> M1["<b>1</b> · Reparo Geral Automático<br/><i>executa direto — 20 a 60 min</i>"]
    MP --> M2["<b>2</b> · Aplicativos<br/><i>3 opções — preparar, pesquisar e instalar, atualizar (WinGet)</i>"]
    MP --> M3["<b>3</b> · Rede, Internet e Conectividade<br/><i>7 opções — 4 leem, 3 alteram</i>"]
    MP --> M4["<b>4</b> · Otimização, Limpeza e Privacidade<br/><i>9 opções — 2 leem, 2 irreversíveis</i>"]
    MP --> M5["<b>5</b> · Reparo do Sistema e Update<br/><i>9 opções — 2 leem, 7 alteram</i>"]
    MP --> M6["<b>6</b> · Contas, Permissões e Segurança<br/><i>9 opções — 4 leem, 3 irreversíveis</i>"]
    MP --> M7["<b>7</b> · Diagnóstico e Reparo de Impressão<br/><i>10 opções — 5 leem, 5 pedem confirmação</i>"]
    MP --> M8["<b>8</b> · Diagnóstico e Relatórios<br/><i>9 opções — todas somente leitura</i>"]
    MP --> M9["<b>9</b> · Ambiente de Execução<br/><i>3 opções — inclui Discos, Drivers e Hardware</i>"]

    M2 --> WG["<b>2 › 1</b> · Verificar / preparar WinGet<br/><i>diagnóstico e recuperação oficial</i>"]
    M2 --> CA["<b>2 › 2</b> · Central de Aplicativos<br/><i>pesquisa por nome e instala</i>"]

    M4 --> DB["<b>4 › 9</b> · Desbloat do Windows<br/><i>9 opções — 3 níveis, 1 simula</i>"]
    DB --> BK["<b>4 › 9 › 9</b> · Backup e reversão<br/><i>4 opções</i>"]

    M9 --> HW["<b>9 › 3</b> · Discos, Drivers e Hardware<br/><i>9 opções — 8 leem, 1 grava</i>"]

    classDef leitura fill:#DFF6DD,stroke:#107C10,color:#0B5A0B
    classDef altera fill:#FFF4CE,stroke:#9D5D00,color:#3B2300
    classDef critico fill:#FDE7E9,stroke:#A4262C,color:#6E0811
    class M8,M9 leitura
    class M2,M3,M5,M7,WG,CA,DB,BK altera
    class M1,M4,M6 critico
    class HW leitura
Loading

🟩 somente leitura · 🟨 altera e é reversível · 🟥 contém operação definitiva

Mapa completo das telas, opção por opção, em Descrição dos Menus.


7. Desbloat do Windows

O Windows chega ao usuário com programas que ele não escolheu: jogos promocionais, testes de antivírus, aplicativos de fabricante, sugestões no menu Iniciar. Somam-se serviços e tarefas agendadas que rodam em segundo plano para funções que muita gente nunca usa.

O módulo de desbloat remove esses itens de forma controlada. Fica em [4] Otimização › [9] Desbloat do Windows.

Três níveis

Nível O que inclui Segurança Para quem
Seguro 104 itens promocionais ou descontinuados 🟢 Alto Qualquer pessoa. É o recomendado
Moderado 143 itens, somando Xbox, mídia, Fotos, Câmera, Email 🟡 Médio Quem sabe quais aplicativos usa
Avançado 150 itens, somando busca do Iniciar e /ResetBase 🔴 Baixo Administradores e usuários experientes

Os níveis são cumulativos.

Ordem recomendada

flowchart LR
    S1["<b>1.</b> Simular<br/><code>4 › 9 › 1</code>"]
    S2["<b>2.</b> Registrar estado<br/><code>4 › 9 › 9 › 2</code>"]
    S3["<b>3.</b> Executar nível Seguro<br/><code>4 › 9 › 2</code>"]
    S4["<b>4.</b> Reiniciar"]
    S1 --> S2 --> S3 --> S4
    S3 -.-> RV["Reverter, se necessário<br/><code>4 › 9 › 9 › 4</code>"]

    classDef seguro fill:#DFF6DD,stroke:#107C10,color:#0B5A0B
    classDef reverter fill:#EAF3FB,stroke:#0078D4,color:#00457A
    class S1,S2,S3,S4 seguro
    class RV reverter
Loading

A simulação lista item por item o que seria alterado, com o motivo técnico de cada um, sem tocar em nada.

O que o distingue

Proteções com precedência absoluta. Um conjunto de 48 aplicativos, 7 prefixos de família, 56 serviços e 4 ramos de registro nunca é tocado — Microsoft Store, Defender, bibliotecas de runtime, autenticação, codecs, Windows Update, rede. Essa verificação acontece depois de qualquer filtro do operador, de propósito: nem quem opera a ferramenta consegue contorná-la.

Reversão pelo estado anterior. Cada alteração grava como o item estava antes. Serviços, tarefas e ajustes de registro voltam ao valor exato de origem — inclusive removendo valores que não existiam, em vez de gravar zero.

Ponto de restauração como portão. A rotina completa cria um antes de qualquer alteração e se recusa a prosseguir se não conseguir.

O que não volta

Aplicativos removidos precisam ser reinstalados pela Microsoft Store: o Windows não retém o pacote no disco depois de removê-lo. A limpeza de componentes obsoletos também é definitiva. Por isso a simulação existe — use antes.

A referência completa — cada nível, cada submódulo, o que exatamente é alterado e como reverter — está no Módulo de Desbloat.


8. Uso avançado

Parâmetros de linha de comando

Launcher.bat /autofix    :: reparo geral automático e encerra
Launcher.bat /audit      :: auditoria completa com os quatro relatórios
Launcher.bat /report     :: consolida e gera apenas os relatórios
Launcher.bat /clean      :: limpeza profunda
Launcher.bat /?          :: exibe a ajuda

Em modo desassistido não há menus nem pausas. O processo encerra com um código de saída semântico, no mesmo vocabulário dos módulos: 0 tudo concluído, 1 concluído com atenção, 2 houve erro. O diagnóstico de cada execução fica no log de texto e nos relatórios da sessão — no JSON, o campo Findings traz a severidade de cada constatação.

Em /autofix, o código 1 também cobre a execução que o Launcher não conseguiu medir — quando as etapas foram desviadas para as rotinas Batch de contingência, por exemplo. 2 cobre a etapa que falhou e a execução recusada por falta de privilégio administrativo. No modo interativo o código continua sendo 0: ali quem encerra é o operador e o valor não é consumido por ninguém.

Coleta centralizada

set "COMPARTDISK_LOGDIR=\\servidor\inventario\%COMPUTERNAME%\"
\\servidor\ferramentas\compartdisk\Launcher.bat /audit

Cada máquina grava em sua própria subpasta. Os arquivos .csv e .json são destinados a consumo automatizado; no JSON, filtre Findings por Severity = "CRIT" para identificar as máquinas que exigem atenção.

Orientações completas em Manual do Administrador.


9. Segurança e privacidade

Transparência

  • Todo o código é aberto e legível: são arquivos de texto, sem binários compilados.
  • Utiliza apenas componentes que já acompanham o Windows. Nada é baixado da internet.
  • Não cria serviços, tarefas agendadas próprias ou entradas de inicialização.
  • Não permanece em execução após ser fechada.

Proteções

  • Antes de operações destrutivas é feito backup automático: arquivo hosts, regras de firewall, diretivas de grupo e logs de eventos.
  • Operações sensíveis exigem confirmação explícita.
  • A remoção de arquivos recusa caminhos críticos do sistema.

Dados nos relatórios

Os relatórios contêm nome do computador, nome de usuário, número de série do equipamento, configuração de rede e lista de programas instalados. Não contêm senhas, arquivos pessoais ou histórico de navegação.

Warning

Chaves de recuperação do BitLocker podem ser exibidas na tela quando solicitadas, mas nunca são gravadas em arquivo. Trate os relatórios conforme a política de classificação de informação da sua organização.


10. Documentação

Introdução

Documento Conteúdo
Guia de Instalação Baixar, descompactar e executar pela primeira vez
Guia de Execução Remota Executar em um comando, sempre na versão mais recente
Guia de Configuração Onde ficam os logs e como ajustar o comportamento padrão
Guia de Utilização Como navegar pelos menus no dia a dia
Manual do Usuário Explicação de cada opção, em linguagem simples

Referência

Documento Conteúdo
Descrição dos Menus Mapa completo de todas as telas e opções
Módulo de Desbloat Referência completa: níveis, submódulos, proteções e reversão
Funcionalidades Descrição técnica de cada recurso
Requisitos do Sistema O que é necessário para executar
Compatibilidade Edições do Windows e comportamento em cada uma
Limitações Conhecidas O que a ferramenta não faz, e por quê
Boas Práticas Como utilizar com segurança

Suporte

Documento Conteúdo
Perguntas Frequentes Dúvidas comuns respondidas de forma objetiva
Solução de Problemas Diagnóstico organizado por sintoma

Avançado

Documento Conteúdo
Manual do Administrador Parque de máquinas, GPO e execução desassistida
Manual Técnico Estrutura interna, API dos módulos e como estender
Arquitetura Como o Batch e o PowerShell se combinam
Estrutura do Projeto Função de cada arquivo e pasta
Política de Atualização Como atualizar e o que muda entre versões

Projeto

Documento Conteúdo
Histórico de Mudanças O que mudou em cada versão
Licença Termos de uso e distribuição
Créditos Autoria e reconhecimentos

11. Solução de problemas

Sintoma Primeira verificação
A janela abre e fecha imediatamente Consulte %TEMP%\COMPARTDISK_Bootstrap.log; a última linha indica o estágio em que a inicialização parou
Aparece "O Windows protegeu o computador" É o SmartScreen. Clique em Mais informações e depois em Executar assim mesmo
O rodapé indica "Motor: Batch" O PowerShell está indisponível ou bloqueado. Todas as funções continuam acessíveis
Uma opção informa "recurso não suportado" O hardware ou a edição do Windows não possui aquele recurso
A tela parece travada Reparo profundo e varreduras levam de 15 minutos a 4 horas, sem exibir progresso
A execução remota falha ao baixar Verifique proxy e firewall; o script exibe a causa e as alternativas

Guia completo em Solução de Problemas.


12. Contribuindo

Relatos de problema, sugestões e melhorias são bem-vindos em Issues.

Ao relatar um problema, inclua:

  1. A versão da ferramenta (visível no menu [9])
  2. A edição e a versão do Windows
  3. O arquivo %TEMP%\COMPARTDISK_Bootstrap.log
  4. O relatório HTML, se for possível gerá-lo

13. Licença

Distribuído sob a Licença Apache 2.0. Consulte o arquivo LICENSE para os termos completos.


14. Marcas registradas

Windows, Windows 10, Windows 11, PowerShell, Microsoft Defender e BitLocker são marcas registradas da Microsoft Corporation. Este projeto não é afiliado, patrocinado ou endossado pela Microsoft.


COMPARTDISK 1.5.0 — Desenvolvido por Edsilas

https://github.com/edsilas/COMPARTDISK

Releases · Changelog · Documentação

About

COMPARTDISK reúne limpeza, manutenção, diagnóstico, reparo e Desbloat do Windows em uma interface simples e guiada, para usuários e profissionais de TI.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages