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:
Modalità di Scansione
| Modalità | Scansioni | Caso d'Uso |
|---|
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
Generazione Script PowerShell
- Verifica privilegi amministratore prima dell'esecuzione
- Escape variabili basato su regex per prevenire errori di sintassi
- Variabili d'ambiente (
$env:TEMP, $env:PATH) preservate correttamente
- Gestione sicura dei servizi con controlli di esistenza
- Soppressione errori usando
-ErrorAction SilentlyContinue
Integrazione Gemini AI
- Prompt strutturati per parsing coerente dell'output
- Sezioni delimitate (
[ANALYSIS_START], [FIX_START]) per estrazione affidabile
- Analisi contestuale basata sulla telemetria di sistema
- Report al passato per azioni di riparazione completate
Sicurezza e Privacy
- Nessuna Raccolta Dati: Tutte le analisi avvengono localmente; solo la telemetria di sistema viene inviata all'API Gemini
- Sicurezza Chiave API: Le chiavi sono memorizzate localmente e mai inviate al version control
- Trasparenza Amministratore: L'utente deve approvare esplicitamente tutti gli script di riparazione
- Non Distruttivo: Nessuna eliminazione di file o modifiche al registro senza consenso dell'utente
- Open Source: Codice sorgente completo disponibile per audit di sicurezza
Vedi SECURITY.md per informazioni dettagliate sulla sicurezza.
Risoluzione dei Problemi
Errore "Chiave API Non Valida"
- Verifica che la tua chiave API sia corretta e attiva
- Controlla la presenza di caratteri nascosti o spazi
- Assicurati che la chiave abbia l'accesso all'API Gemini abilitato
- Rigenera la chiave su https://makersuite.google.com/app/apikey
"Non in Esecuzione come Amministratore"
- Fai clic con il tasto destro sull'eseguibile e seleziona "Esegui come amministratore"
- Oppure consenti il prompt UAC quando lo strumento si eleva automaticamente
Errore "Modulo Non Trovato" (versione Python)
pip install --upgrade psutil google-generativeai rich
Lo Script PowerShell Fallisce
- Assicurati di eseguire Windows PowerShell 5.1 o successivo
- Controlla che la policy di esecuzione consenta l'esecuzione degli script
- Rivedi lo script in
AI_Reports/remediation.ps1 per errori
Compilazione dal Sorgente
Build Automatici (Consigliati)
Il progetto usa GitHub Actions per compilare automaticamente gli eseguibili Windows quando viene pushato un tag di versione:
- Fai il push delle tue modifiche al branch principale
- Crea e pusha un tag di versione:
git tag -a v1.0.2 -m "Note di rilascio" && git push origin v1.0.2
- GitHub Actions compilerà automaticamente il .exe e creerà una release
- Scarica dalla pagina Releases
Vedi RELEASE_PROCESS.md per istruzioni dettagliate.
Build Manuale (Per Test)
Su Windows:
pip install pyinstaller
pip install -r requirements.txt
python build.py
Questo crea dist/SuperDiagnosticTool.exe con icona e dipendenze incorporate.
Nota: Se vedi un avviso "Windows ha protetto il tuo PC", consulta TRUST_GUIDE.md per una correzione rapida o per come inserire l'app nella whitelist in modo permanente.
Nota: La compilazione su Linux/Mac creerà binari specifici per piattaforma, non file .exe per Windows. Usa GitHub Actions per le release ufficiali Windows.
Struttura dei File
SuperDiagnosticTool/
├── super_diagnose_v2.py # Script diagnostico principale
├── build.py # Script di build per creare EXE
├── icon.ico # Icona dell'applicazione
├── .github/workflows/ # Flussi di lavoro GitHub Actions
│ └── release.yml # Build e rilascio automatico
├── docs/
│ ├── icon.png # Icona per il README
│ └── screenshot_main.png # Schermata interfaccia principale
├── src/ # Moduli sorgente
│ ├── safety/ # Moduli di sicurezza e validazione
│ └── security/ # Funzionalità di sicurezza
├── AI_Reports/ # Report HTML generati
├── README.md # Questo file
├── RELEASE_PROCESS.md # Documentazione del processo di rilascio
├── LICENSE # Licenza GPL-3.0
├── SECURITY.md # Documentazione sulla sicurezza
└── .gitignore # Regole Git ignore
Disclaimer
IMPORTANTE: Avviso di Modifica del Sistema
Questo strumento genera ed esegue script PowerShell che modificano servizi, configurazioni e impostazioni di sistema. Sebbene sia progettato con principi di sicurezza:
- Rivedi sempre lo script PowerShell generato prima dell'esecuzione
- Esegui il backup dei dati critici prima di eseguire riparazioni automatiche
- Testa su sistemi non di produzione se possibile
- Comprendi le modifiche apportate al tuo sistema
L'autore non è responsabile per danni al sistema, perdita di dati o conseguenze indesiderate derivanti dall'uso di questo strumento. Usalo a tuo rischio.
Contribuire
I contributi sono benvenuti! Per favore:
- Fai il fork del repository
- Crea un branch per le funzionalità (
git checkout -b feature/miglioramento)
- Effettua il commit delle tue modifiche (
git commit -m 'Aggiunto miglioramento')
- Spingi il branch (
git push origin feature/miglioramento)
- Apri una Pull Request
Licenza
Questo progetto è concesso in licenza con GNU General Public License v3.0 - consulta il file LICENSE per i dettagli.
Copyright (C) 2026 GUETTAF HOUSSEM EDDINE
Autore
Knight
Studente di Ingegneria Elettrotecnica
Università Akli Mohand Oulhadj, Bouira, Algeria
Email: [email protected]
GitHub: @Guettaf-hossam
Riconoscimenti
- Google Gemini AI per l'analisi intelligente del sistema
- psutil per il monitoraggio multipiattaforma del sistema
- Rich per l'output terminale elegante
Versione 1.0 | Ultimo aggiornamento: Gennaio 2026
Realizzato con dedizione da Knight | Università Akli Mohand Oulhadj
guettaf-hossam/superdiagnostictool
