Ferramenta de diagnóstico e reparo automático para Windows com inteligência artificial usando Google Gemini. Detecte falhas, otimize o desempenho, verifique malware e gere scripts de correção PowerShell. Suporte universal de hardware (1-128+ núcleos). Gratuito e de código aberto.
Ferramenta de Diagnóstico e Autocorreção para Windows com IA
O SuperDiagnosticTool é um utilitário de diagnóstico inteligente para sistemas que combina telemetria de hardware em tempo real com o Google Gemini AI para analisar, diagnosticar e corrigir automaticamente problemas do sistema Windows. Construído com uma arquitetura focada em segurança, oferece diagnósticos de nível profissional para qualquer configuração Windows.
Capturas de Tela
Interface principal mostrando a seleção do modo de verificação e a descrição do problema
Principais Funcionalidades
Suporte Universal de Hardware
Escalonamento Dinâmico: Adapta-se automaticamente a qualquer configuração de CPU (1-128+ núcleos)
Lógica Agnóstica de Hardware: Funciona perfeitamente em sistemas legados (Intel Pentium) até estações de trabalho de alto desempenho (AMD Threadripper, Intel Xeon)
Fallbacks Elegantes: Tratamento seguro de recursos não suportados (frequência da CPU, detecção de bateria, memória swap)
Otimizado para Baixo Desempenho: Execução leve evita lentidão no sistema, mesmo em hardware com recursos limitados
Análise Inteligente com IA
Integração com Google Gemini: Análise e diagnóstico avançados do sistema com IA
Recomendações Contextuais: Correlaciona problemas relatados pelo usuário com a telemetria do sistema
Auditoria de Segurança: Verifica processos suspeitos, vazamentos de recursos e possíveis malwares
Verificação Pós-Correção: Gera relatórios de conclusão mostrando o que foi corrigido vs. o que requer atenção manual
Arquitetura Focada em Segurança
Segurança de Nível Profissional (85%)
Validação em Múltiplas Camadas
Correspondência com Base de Conhecimento: Valida soluções da IA contra 5 soluções testadas conhecidas com taxas de sucesso
Simulação Dry-Run: Visualize todas as alterações antes da execução (serviços, arquivos, registro)
Validação de Script em Múltiplos Níveis: Lista negra, lista branca e pontuação de risco (0-100)
Pontos de Restauração do Sistema: Criação automática de ponto de restauração antes de qualquer modificação
Monitoramento Aprimorado
Instantâneos Pré/Pós Execução: Captura completa do estado do sistema antes e depois das alterações
Detecção de Alterações: Rastreamento automático de todas as modificações (serviços, registro, itens de inicialização)
Geração de Rollback: Scripts gerados automaticamente para desfazer alterações, se necessário
Registro de Execução: Logs abrangentes de todas as operações
Segurança do PowerShell
Verificação de Privilégios de Administrador: Todos os scripts de correção incluem verificações de elevação
Sanitização de Variáveis: Escape baseado em regex evita erros preservando variáveis $env:
Verificações de Segurança de Serviços: Verifica a existência do serviço antes das operações
Execução em Sandbox: Ambiente monitorado com proteção de tempo limite
Tratamento de Erros: Blocos try-catch abrangentes com salvaguardas
Verificação Abrangente do Sistema
Métricas de Desempenho: Uso da CPU (geral + por núcleo), detalhamento da memória, principais consumidores de recursos
Inteligência de Rede: Interfaces ativas, configuração de DNS, intensidade do sinal Wi-Fi, testes de conectividade
Integridade de Segurança: Status do antivírus, perfis de firewall, histórico do Windows Update
Saúde do Hardware: Status SMART do disco, informações da GPU, status da bateria (laptops)
Serviços do Sistema: Aplicativos de inicialização, serviços com falha, logs de eventos críticos
Auditoria de Processos: Identifica processos suspeitos com base no uso de recursos e localização
Relatórios Centrados no Ser Humano
Relatórios HTML Profissionais: Relatórios de diagnóstico responsivos com tema escuro e métricas visuais
Linguagem de Conclusão no Passado: Relatórios usam tags [CORRIGIDO], [LIMPO], [DESATIVADO] para mostrar ações concluídas
Seção de Atenção Manual: Separa claramente as correções automatizadas dos itens que exigem intervenção do usuário
Arquivos com Carimbo de Data/Hora: Todos os relatórios salvos no diretório AI_Reports/ para rastreamento histórico
Insira sua chave da API do Google Gemini quando solicitado
Descreva o problema do seu sistema
Selecione o modo de verificação (Rápido/Profundo/Completo)
Revise a análise da IA e o script de correção
Execute as correções ou visualize o relatório HTML detalhado
Instalação (Para Desenvolvedores)
Pré-requisitos
Python 3.8 ou superior
Gerenciador de pacotes pip
Instalar Dependências
root@kitploit:~
pip install psutil google-generativeai rich
Executar a Partir do Código Fonte
root@kitploit:~
python super_diagnose_v2.py
Uso
Configuração da Chave de API
Opção A: Entrada Interativa (Recomendado para usuários iniciantes)
A ferramenta solicitará que você insira sua chave de API na primeira execução
A chave é salva localmente em gemini.key para uso futuro
Opção B: Variável de Ambiente
root@kitploit:~
set GEMINI_API_KEY=sua_chave_api_aqui
Opção C: Arquivo de Chave Manual
Crie gemini.key no mesmo diretório:
root@kitploit:~
sua_chave_api_aqui
Modos de Verificação
Modo
Verificações
Caso de Uso
Verificação Rápida
CPU, RAM, Informações Básicas
Verificação rápida de desempenho
Verificação Profunda
Sistema, Rede, Segurança, Logs, Bluetooth, Processos
Solução de problemas abrangente
Verificação Completa
Tudo acima + Saúde do Disco, GPU, Aplicativos de Inicialização
Auditoria completa do sistema
Exemplo de Fluxo de Trabalho
root@kitploit:~
# 1. Execute a ferramenta
SuperDiagnosticTool.exe
# 2. Descreva seu problema
> Alto uso de CPU e desempenho lento
# 3. Selecione o modo de verificação
> 3 (Verificação Completa do Sistema)
# 4. Aguarde a análise da IA
[Verificando camadas do sistema...]
[Processando lógica de telemetria...]
# 5. Revise o script de correção
[Script PowerShell exibido]
> Executar? (s/n)
# 6. Visualize o relatório HTML
> Abrir relatório detalhado? (s/n)
Detalhes Técnicos
Arquitetura do Código
Design modular com funções separadas para cada categoria de diagnóstico
Tratamento de erros abrangente com blocos try-except
Consultas agnósticas de hardware com fallbacks elegantes
Docstrings profissionais e nomenclatura clara de variáveis
Geração de Scripts PowerShell
Verificação de privilégios de administrador antes da execução
Escape de variáveis baseado em regex para evitar erros de sintaxe
Variáveis de ambiente ($env:TEMP, $env:PATH) preservadas corretamente
Gerenciamento seguro de serviços com verificações de existência
Supressão de erros usando -ErrorAction SilentlyContinue
Integração com Gemini AI
Prompts estruturados para análise de saída consistente
Seções delimitadas ([ANALYSIS_START], [FIX_START]) para extração confiável
Análise contextual baseada na telemetria do sistema
Relatórios no passado para ações de correção concluídas
Segurança e Privacidade
Sem Coleta de Dados: Toda a análise ocorre localmente; apenas a telemetria do sistema é enviada para a API Gemini
Segurança da Chave de API: As chaves são armazenadas localmente e nunca são enviadas para o controle de versão
Transparência do Administrador: O usuário deve aprovar explicitamente todos os scripts de correção
Não Destrutivo: Nenhuma exclusão de arquivo ou modificação no registro sem consentimento do usuário
Código Aberto: Código fonte completo disponível para auditoria de segurança
Consulte SECURITY.md para informações detalhadas de segurança.
Solução de Problemas
Erro "Chave de API Inválida"
Verifique se sua chave de API está correta e ativa
Verifique se há caracteres ocultos ou espaços em branco
Certifique-se de que a chave tenha acesso à API Gemini ativado
Isso cria dist/SuperDiagnosticTool.exe com ícone e dependências incorporados.
Nota: Se você vir um aviso "O Windows protegeu seu PC", leia TRUST_GUIDE.md para uma correção rápida ou como adicionar o aplicativo à lista de permissões permanentemente.
Nota: A compilação no Linux/Mac criará binários específicos da plataforma, não arquivos .exe do Windows. Use o GitHub Actions para releases oficiais do Windows.
Estrutura de Arquivos
root@kitploit:~
SuperDiagnosticTool/
├── super_diagnose_v2.py # Script de diagnóstico principal
├── build.py # Script de compilação para criar EXE
├── icon.ico # Ícone do aplicativo
├── .github/workflows/ # Fluxos de trabalho do GitHub Actions
│ └── release.yml # Compilação e release automatizados
├── docs/
│ ├── icon.png # Ícone para o README
│ └── screenshot_main.png # Captura de tela da interface principal
├── src/ # Módulos fonte
│ ├── safety/ # Módulos de segurança e validação
│ └── security/ # Recursos de segurança
├── AI_Reports/ # Relatórios HTML gerados
├── README.md # Este arquivo
├── RELEASE_PROCESS.md # Documentação do processo de release
├── LICENSE # Licença GPL-3.0
├── SECURITY.md # Documentação de segurança
└── .gitignore # Regras de ignorar do Git
Aviso Legal
IMPORTANTE: Aviso de Modificação do Sistema
Esta ferramenta gera e executa scripts PowerShell que modificam serviços, configurações e definições do sistema. Embora projetada com princípios de segurança em primeiro lugar:
Sempre revise o script PowerShell gerado antes da execução
Faça backup de dados críticos antes de executar a correção automatizada
Teste em sistemas não produtivos primeiro, se possível
Entenda as alterações que estão sendo feitas no seu sistema
O autor não é responsável por qualquer dano ao sistema, perda de dados ou consequências não intencionais resultantes do uso desta ferramenta. Use por sua conta e risco.
Contribuição
Contribuições são bem-vindas! Por favor:
Faça um fork do repositório
Crie um branch de funcionalidade (git checkout -b feature/melhoria)
Faça commit das suas alterações (git commit -m 'Adicionar melhoria')
Envie para o branch (git push origin feature/melhoria)
Abra um Pull Request
Licença
Este projeto está licenciado sob a GNU General Public License v3.0 - consulte o arquivo LICENSE para detalhes.
Copyright (C) 2026 GUETTAF HOUSSEM EDDINE
Autor
Knight
Estudante de Engenharia Eletrotécnica
Universidade Akli Mohand Oulhadj, Bouira, Argélia
Email: [email protected]
GitHub: @Guettaf-hossam
Agradecimentos
Google Gemini AI pela análise inteligente do sistema
Biblioteca psutil para monitoramento de sistema multiplataforma
Biblioteca Rich pela bela saída no terminal
Versão 1.0 | Última Atualização: Janeiro de 2026
Feito com dedicação por Knight | Universidade Akli Mohand Oulhadj
guettaf-hossam/superdiagnostictool
