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
- 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
Início Rápido
Download
Baixar SuperDiagnosticTool.exe - Executável autônomo (não requer Python)
Requisitos
- Windows 10 ou Windows 11
- Privilégios de administrador
- Chave de API do Google Gemini (Obter chave gratuita)
Primeira Execução
- Baixe e execute
SuperDiagnosticTool.exe
- 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
pip install psutil google-generativeai rich
Executar a Partir do Código Fonte
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
set GEMINI_API_KEY=sua_chave_api_aqui
Opção C: Arquivo de Chave Manual
Crie gemini.key no mesmo diretório:
Modos de Verificação
| Modo | Verificações | Caso de Uso |
|---|
Exemplo de Fluxo de Trabalho
# 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
- 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
- Regere a chave em https://makersuite.google.com/app/apikey
"Não está executando como Administrador"
- Clique com o botão direito no executável e selecione "Executar como administrador"
- Ou permita o prompt do UAC quando a ferramenta for elevada automaticamente
Erro "Módulo Não Encontrado" (versão Python)
pip install --upgrade psutil google-generativeai rich
Falha no Script PowerShell
- Certifique-se de estar executando o Windows PowerShell 5.1 ou posterior
- Verifique se a política de execução permite a execução de scripts
- Revise o script em
AI_Reports/remediation.ps1 para erros
Compilação a Partir do Código Fonte
Compilações Automatizadas (Recomendado)
O projeto usa GitHub Actions para compilar automaticamente executáveis Windows quando uma tag de versão é enviada:
- Envie suas alterações para o branch principal
- Crie e envie uma tag de versão:
git tag -a v1.0.2 -m "Notas de lançamento" && git push origin v1.0.2
- O GitHub Actions compilará automaticamente o .exe e criará um release
- Baixe na página de Releases
Consulte RELEASE_PROCESS.md para instruções detalhadas.
Compilação Manual (Para Testes)
No Windows:
pip install pyinstaller
pip install -r requirements.txt
python build.py
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
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
