Strumento Diagnostico e Auto-Riparazione per Windows basato su IA
SuperDiagnosticTool è un'utilità diagnostica di sistema intelligente che combina la telemetria hardware in tempo reale con Google Gemini AI per analizzare, diagnosticare e risolvere automaticamente i problemi di sistema di Windows. Costruito con un'architettura incentrata sulla sicurezza, fornisce diagnostica di livello produttivo per qualsiasi configurazione Windows.
Schermate
Interfaccia principale che mostra la selezione della modalità di scansione e l'inserimento della descrizione del problema
Caratteristiche Principali
Supporto Hardware Universale
- Scalabilità Dinamica: Si adatta automaticamente a qualsiasi configurazione CPU (1-128+ core)
- Logica Hardware-Agnostica: Funziona perfettamente su sistemi legacy (Intel Pentium) fino a workstation di fascia alta (AMD Threadripper, Intel Xeon)
- Fallback Efficienti: Gestione sicura di funzionalità non supportate (frequenza CPU, rilevamento batteria, memoria di swap)
- Ottimizzato per Bassa Specifica: Esecuzione leggera per evitare rallentamenti di sistema anche su hardware con risorse limitate
Analisi IA Intelligente
- Integrazione Google Gemini: Analisi e diagnostica di sistema avanzate basate su IA
- Raccomandazioni Contestuali: Correla i problemi segnalati dall'utente con la telemetria di sistema
- Audit di Sicurezza: Scansiona processi sospetti, perdite di risorse e potenziali malware
- Verifica Post-Riparazione: Genera report di completamento che mostrano cosa è stato riparato rispetto a ciò che richiede attenzione manuale
Architettura incentrata sulla Sicurezza
Sicurezza di Livello Produttivo (85%)
Validazione a Più Livelli
- Corrispondenza Knowledge Base: Valida le soluzioni AI rispetto a 5 soluzioni note testate con percentuali di successo
- Simulazione Dry-Run: Anteprima di tutte le modifiche prima dell'esecuzione (servizi, file, registro)
- Validazione Script a Più Livelli: Blacklist, whitelist e punteggio di rischio (0-100)
- Punti di Ripristino di Sistema: Creazione automatica di punti di ripristino prima di qualsiasi modifica
Monitoraggio Avanzato
- Snapshot Pre/Post Esecuzione: Acquisizione completa dello stato del sistema prima e dopo le modifiche
- Rilevamento Modifiche: Tracciamento automatico di tutte le modifiche (servizi, registro, elementi di avvio)
- Generazione Rollback: Script generati automaticamente per annullare le modifiche se necessario
- Registrazione Esecuzione: Log completi di tutte le operazioni
Sicurezza PowerShell
- Verifica Privilegi Amministratore: Tutti gli script di riparazione includono controlli di elevazione
- Sanificazione Variabili: Escape basato su regex per prevenire errori preservando le variabili
$env:
- Controlli di Sicurezza dei Servizi: Verifica l'esistenza del servizio prima delle operazioni
- Esecuzione in Sandbox: Ambiente monitorato con protezione timeout
- Gestione Errori: Blocchi try-catch completi con salvaguardie
Scansione Completa del Sistema
- Metriche di Prestazione: Utilizzo CPU (globale + per core), ripartizione memoria, principali consumatori di risorse
- Intelligenza di Rete: Interfacce attive, configurazione DNS, potenza segnale Wi-Fi, test di connettività
- Integrità di Sicurezza: Stato antivirus, profili firewall, cronologia Windows Update
- Salute Hardware: Stato SMART del disco, informazioni GPU, stato batteria (laptop)
- Servizi di Sistema: Applicazioni di avvio, servizi non riusciti, log eventi critici
- Audit Processi: Identifica processi sospetti in base all'utilizzo delle risorse e alla posizione
Reportistica Centrata sull'Umano
- Report HTML Professionali: Report diagnostici reattivi con tema scuro e metriche visive
- Linguaggio di Completamento al Passato: I report usano tag
[FIXED], [CLEANED], [DISABLED] per mostrare le azioni completate
- Sezione Attenzione Manuale: Separa chiaramente le correzioni automatiche dagli elementi che richiedono intervento dell'utente
- Archivi con Timestamp: Tutti i report salvati nella directory
AI_Reports/ per tracciamento storico
Avvio Rapido
Download
Scarica SuperDiagnosticTool.exe - Eseguibile autonomo (non richiede Python)
Requisiti
Primo Avvio
- Scarica ed esegui
SuperDiagnosticTool.exe
- Inserisci la tua chiave API Google Gemini quando richiesto
- Descrivi il tuo problema di sistema
- Seleziona la modalità di scansione (Veloce/Approfondita/Completa)
- Rivedi l'analisi AI e lo script di riparazione
- Esegui le correzioni o visualizza il report HTML dettagliato
Installazione (Per Sviluppatori)
Prerequisiti
- Python 3.8 o superiore
- Gestore pacchetti pip
Installa Dipendenze
pip install psutil google-generativeai rich
Esegui da Sorgente
python super_diagnose_v2.py
Utilizzo
Impostazione Chiave API
Opzione A: Input Interattivo (Consigliato per utenti alle prime armi)
- Lo strumento ti chiederà di inserire la tua chiave API al primo avvio
- La chiave viene salvata localmente in
gemini.key per utilizzi futuri
Opzione B: Variabile d'Ambiente
set GEMINI_API_KEY=your_api_key_here
Opzione C: File Chiave Manuale
Crea gemini.key nella stessa directory:
your_api_key_here
Modalità di Scansione
| Modalità | Scansioni | Caso d'Uso |
|---|
| Scansione Veloce | CPU, RAM, Info Base | Controllo rapido delle prestazioni |
| Scansione Approfondita | Sistema, Rete, Sicurezza, Log, Bluetooth, Processi | Risoluzione dei problemi completa |
| Scansione Completa | Tutto quanto sopra + Salute Disco, GPU, App di Avvio | Audit completo del sistema |
Esempio di Flusso di Lavoro
# 1. Esegui lo strumento
SuperDiagnosticTool.exe
# 2. Descrivi il tuo problema
> Utilizzo CPU elevato e prestazioni lente
# 3. Seleziona la modalità di scansione
> 3 (Scansione completa del sistema)
# 4. Attendi l'analisi AI
[Scansione livelli di sistema...]
[Elaborazione logica di telemetria...]
# 5. Rivedi lo script di riparazione
[Script PowerShell visualizzato]
> Eseguire? (s/n)
# 6. Visualizza report HTML
> Aprire report dettagliato? (s/n)
Dettagli Tecnici
Architettura del Codice
- Design modulare con funzioni separate per ogni categoria diagnostica
- Gestione completa degli errori con blocchi try-except
- Query hardware-agnostiche con fallback efficienti
- Docstring professionali e nomi di variabili chiari
guettaf-hossam/superdiagnostictool
