SuperDiagnosticTool

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

• Windows 10 o Windows 11
• Privilegi di amministratore
• Chiave API Google Gemini (Ottieni chiave gratuita)

Primo Avvio

1. Scarica ed esegui SuperDiagnosticTool.exe
2. Inserisci la tua chiave API Google Gemini quando richiesto
3. Descrivi il tuo problema di sistema
4. Seleziona la modalità di scansione (Veloce/Approfondita/Completa)
5. Rivedi l'analisi AI e lo script di riparazione
6. 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