SuperDiagnosticTool

KI-gestütztes Windows-Diagnose- und Selbstheilungstool

SuperDiagnosticTool ist ein intelligentes Systemdiagnose-Tool, das Echtzeit-Hardware-Telemetrie mit Google Gemini KI kombiniert, um Windows-Systemprobleme zu analysieren, zu diagnostizieren und automatisch zu beheben. Mit einer sicherheitsorientierten Architektur bietet es produktionsreife Diagnosen für jede Windows-Konfiguration.

Screenshots

Hauptoberfläche mit Scanmodus-Auswahl und Problembeschreibungseingabe

Hauptfunktionen

Universelle Hardwareunterstützung

• Dynamische Skalierung: Passt sich automatisch an jede CPU-Konfiguration (1-128+ Kerne) an
• Hardware-agnostische Logik: Funktioniert nahtlos auf Legacy-Systemen (Intel Pentium) bis hin zu High-End-Workstations (AMD Threadripper, Intel Xeon)
• Gracenful-Fallbacks: Sichere Handhabung nicht unterstützter Funktionen (CPU-Frequenz, Batterieerkennung, Swap-Speicher)
• Für schwache Systeme optimiert: Leichte Ausführung verhindert Systemverzögerungen selbst auf ressourcenbeschränkter Hardware

Intelligente KI-Analyse

• Google Gemini-Integration: Fortschrittliche KI-gestützte Systemanalyse und -diagnose
• Kontextbewusste Empfehlungen: Korreliert vom Benutzer gemeldete Probleme mit der Systemtelemetrie
• Sicherheitsaudit: Scannt nach verdächtigen Prozessen, Ressourcenlecks und potenzieller Malware
• Überprüfung nach der Reparatur: Erstellt Abschlussberichte mit Angabe, was repariert wurde und was manuelle Aufmerksamkeit erfordert

Sicherheitsorientierte Architektur

Produktionsreife Sicherheit (85%)

Mehrstufige Validierung

• Wissensdatenbank-Abgleich: Validiert KI-Lösungen anhand von 5 getesteten, bekannten Lösungen mit Erfolgsquoten
• Trockentest-Simulation: Zeigen Sie alle Änderungen vor der Ausführung an (Dienste, Dateien, Registrierung)
• Mehrstufige Skriptvalidierung: Blacklist, Whitelist und Risikobewertung (0-100)
• Systemwiederherstellungspunkte: Automatische Erstellung von Wiederherstellungspunkten vor allen Änderungen

Verbesserte Überwachung

• Vorher-/Nachher-Snapshots: Vollständige Systemzustandserfassung vor und nach Änderungen
• Änderungserkennung: Automatische Verfolgung aller Änderungen (Dienste, Registrierung, Startobjekte)
• Rollback-Generierung: Automatisch generierte Skripte zum Rückgängigmachen von Änderungen bei Bedarf
• Ausführungsprotokollierung: Umfassende Protokolle aller Vorgänge

PowerShell-Sicherheit

• Administratorberechtigungsprüfung: Alle Reparaturskripte enthalten Berechtigungserhöhungsprüfungen
• Variablenbereinigung: Regex-basiertes Escaping verhindert Fehler, während $env:-Variablen erhalten bleiben
• Dienstsicherheitsprüfungen: Überprüft die Dienstexistenz vor Operationen
• Sandbox-Ausführung: Überwachte Umgebung mit Timeout-Schutz
• Fehlerbehandlung: Umfassende try-catch-Blöcke mit Sicherheitsvorkehrungen

Umfassender Systemscan

• Leistungsmetriken: CPU-Auslastung (gesamt + pro Kern), Speicheraufschlüsselung, größte Ressourcenverbraucher
• Netzwerk-Intelligenz: Aktive Schnittstellen, DNS-Konfiguration, WLAN-Signalstärke, Konnektivitätstests
• Sicherheitsintegrität: Antivirus-Status, Firewall-Profile, Windows Update-Verlauf
• Hardware-Gesundheit: Disk-SMART-Status, GPU-Informationen, Akkustatus (Laptops)
• Systemdienste: Startanwendungen, fehlgeschlagene Dienste, kritische Ereignisprotokolle
• Prozess-Audit: Identifiziert verdächtige Prozesse anhand von Ressourcennutzung und Speicherort

Benutzerorientierte Berichterstattung

• Professionelle HTML-Berichte: Dunkel gestaltete, responsive Diagnoseberichte mit visuellen Metriken
• Vergangenheitsform für abgeschlossene Aktionen: Berichte verwenden [FIXED], [CLEANED], [DISABLED]-Tags, um abgeschlossene Aktionen anzuzeigen
• Bereich für manuelle Aufmerksamkeit: Trennt klar automatisierte Reparaturen von Punkten, die Benutzereingriffe erfordern
• Zeitgestempelte Archive: Alle Berichte werden im Verzeichnis AI_Reports/ zur historischen Nachverfolgung gespeichert

Schnellstart

Herunterladen

SuperDiagnosticTool.exe herunterladen - Eigenständige ausführbare Datei (kein Python erforderlich)

Anforderungen

• Windows 10 oder Windows 11
• Administratorrechte
• Google Gemini API-Schlüssel (Kostenlosen Schlüssel erhalten)

Erster Start

1. SuperDiagnosticTool.exe herunterladen und ausführen
2. Geben Sie Ihren Google Gemini API-Schlüssel ein, wenn Sie dazu aufgefordert werden
3. Beschreiben Sie Ihr Systemproblem
4. Wählen Sie den Scanmodus (Schnell/Tief/Vollständig)
5. Überprüfen Sie die KI-Analyse und das Reparaturskript
6. Führen Sie Reparaturen aus oder zeigen Sie den detaillierten HTML-Bericht an

Installation (Für Entwickler)

Voraussetzungen

• Python 3.8 oder höher
• pip-Paketmanager

Abhängigkeiten installieren

pip install psutil google-generativeai rich

Aus dem Quellcode ausführen

python super_diagnose_v2.py

Verwendung

API-Schlüssel einrichten

Option A: Interaktive Eingabe (Empfohlen für Erstbenutzer)

• Das Tool fordert Sie beim ersten Start zur Eingabe Ihres API-Schlüssels auf
• Der Schlüssel wird lokal in gemini.key für zukünftige Verwendungen gespeichert

Option B: Umgebungsvariable

set GEMINI_API_KEY=your_api_key_here

Option C: Manuelle Schlüsseldatei Erstellen Sie gemini.key im selben Verzeichnis:

your_api_key_here

Scanmodi

Beispiel-Workflow

# 1. Tool ausführen
SuperDiagnosticTool.exe

# 2. Problem beschreiben
> Hohe CPU-Auslastung und langsame Leistung

# 3. Scanmodus auswählen
> 3 (Vollständiger Systemscan)

# 4. Auf KI-Analyse warten
[Scanning system layers...]
[Processing telemetry logic...]

# 5. Reparaturskript überprüfen
[PowerShell script displayed]
> Ausführen? (j/n)

# 6. HTML-Bericht anzeigen
> Detaillierten Bericht öffnen? (j/n)

Technische Details

Code-Architektur

• Modulares Design mit separaten Funktionen für jede Diagnosekategorie
• Umfassende Fehlerbehandlung mit try-except-Blöcken
• Hardware-agnostische Abfragen mit grazilen Fallbacks
• Professionelle Docstrings und klare Variablenbenennung

PowerShell-Skriptgenerierung

• Administratorberechtigungsprüfung vor der Ausführung
• Regex-basiertes Variablen-Escaping zur Vermeidung von Syntaxfehlern
• Umgebungsvariablen ($env:TEMP, $env:PATH) werden korrekt beibehalten
• Sichere Dienstverwaltung mit Existenzprüfungen
• Fehlerunterdrückung mit -ErrorAction SilentlyContinue

Gemini KI-Integration

• Strukturierte Prompts für konsistente Ausgabeparsing
• Abgegrenzte Abschnitte ([ANALYSIS_START], [FIX_START]) für zuverlässige Extraktion
• Kontextbewusste Analyse basierend auf Systemtelemetrie
• Vergangenheitsform für abgeschlossene Reparaturaktionen

Sicherheit & Datenschutz

• Keine Datenerfassung: Alle Analysen finden lokal statt; nur Systemtelemetrie wird an die Gemini-API gesendet
• API-Schlüsselsicherheit: Schlüssel werden lokal gespeichert und niemals in die Versionskontrolle übernommen
• Administratortransparenz: Der Benutzer muss alle Reparaturskripte explizit genehmigen
• Nicht-destruktiv: Keine Dateilöschung oder Registrierungsänderungen ohne Benutzereinwilligung
• Open Source: Vollständiger Quellcode für Sicherheitsaudits verfügbar

Siehe SECURITY.md für detaillierte Sicherheitsinformationen.

Fehlerbehebung

"API-Schlüssel ungültig"-Fehler

• Überprüfen Sie, ob Ihr API-Schlüssel korrekt und aktiv ist
• Achten Sie auf versteckte Zeichen oder Leerzeichen
• Stellen Sie sicher, dass der Schlüssel Zugriff auf die Gemini-API hat
• Generieren Sie den Schlüssel unter https://makersuite.google.com/app/apikey neu

"Wird nicht als Administrator ausgeführt"

• Klicken Sie mit der rechten Maustaste auf die ausführbare Datei und wählen Sie "Als Administrator ausführen"
• Oder bestätigen Sie die UAC-Eingabeaufforderung, wenn das Tool automatisch erhöht wird

"Modul nicht gefunden"-Fehler (Python-Version)

pip install --upgrade psutil google-generativeai rich

PowerShell-Skript schlägt fehl

• Stellen Sie sicher, dass Sie Windows PowerShell 5.1 oder höher verwenden
• Überprüfen Sie, ob die Ausführungsrichtlinie die Skriptausführung erlaubt
• Überprüfen Sie das Skript in AI_Reports/remediation.ps1 auf Fehler

Aus dem Quellcode erstellen

Automatisierte Builds (Empfohlen)

Das Projekt verwendet GitHub Actions, um automatisch Windows-Executables zu erstellen, wenn ein Version-Tag gepusht wird:

1. Pushen Sie Ihre Änderungen in den Haupt-Branch
2. Erstellen und pushen Sie einen Version-Tag: git tag -a v1.0.2 -m "Release notes" && git push origin v1.0.2
3. GitHub Actions erstellt automatisch die .exe und erstellt ein Release
4. Laden Sie von der Releases-Seite herunter

Siehe RELEASE_PROCESS.md für detaillierte Anweisungen.

Manueller Build (Für Tests)

Unter Windows:

pip install pyinstaller
pip install -r requirements.txt
python build.py

Dies erstellt dist/SuperDiagnosticTool.exe mit eingebettetem Icon und Abhängigkeiten.

Hinweis: Wenn Sie eine "Windows protected your PC"-Warnung sehen, lesen Sie bitte TRUST_GUIDE.md für einen schnellen Fix oder wie Sie die App dauerhaft auf die Whitelist setzen können.

Hinweis: Das Erstellen unter Linux/Mac erzeugt plattformspezifische Binärdateien, keine Windows .exe-Dateien. Verwenden Sie GitHub Actions für offizielle Windows-Releases.

Dateistruktur

SuperDiagnosticTool/
├── super_diagnose_v2.py    # Main diagnostic script
├── build.py                # Build script for creating EXE
├── icon.ico                # Application icon
├── .github/workflows/      # GitHub Actions workflows
│   └── release.yml        # Automated build and release
├── docs/
│   ├── icon.png           # Icon for README
│   └── screenshot_main.png # Main interface screenshot
├── src/                    # Source modules
│   ├── safety/            # Safety and validation modules
│   └── security/          # Security features
├── AI_Reports/             # Generated HTML reports
├── README.md               # This file
├── RELEASE_PROCESS.md      # Release process documentation
├── LICENSE                 # GPL-3.0 License
├── SECURITY.md             # Security documentation
└── .gitignore              # Git ignore rules

Haftungsausschluss

WICHTIG: Warnung vor Systemänderungen

Dieses Tool generiert und führt PowerShell-Skripte aus, die Systemdienste, Konfigurationen und Einstellungen ändern. Obwohl es mit sicherheitsorientierten Prinzipien entwickelt wurde:

• Überprüfen Sie immer das generierte PowerShell-Skript vor der Ausführung
• Sichern Sie kritische Daten, bevor Sie eine automatisierte Reparatur ausführen
• Testen Sie nach Möglichkeit zuerst auf Nicht-Produktionssystemen
• Verstehen Sie die Änderungen, die an Ihrem System vorgenommen werden

Der Autor übernimmt keine Haftung für Systemschäden, Datenverluste oder unbeabsichtigte Folgen, die durch die Nutzung dieses Tools entstehen. Nutzung auf eigene Gefahr.

Mitwirken

Beiträge sind willkommen! Bitte:

1. Forken Sie das Repository
2. Erstellen Sie einen Feature-Branch (git checkout -b feature/improvement)
3. Committen Sie Ihre Änderungen (git commit -m 'Add improvement')
4. Pushen Sie den Branch (git push origin feature/improvement)
5. Öffnen Sie einen Pull Request

Lizenz

Dieses Projekt ist lizenziert unter der GNU General Public License v3.0 – siehe die Datei LICENSE für Details.

Copyright (C) 2026 GUETTAF HOUSSEM EDDINE

Autor

Knight
Student der Elektrotechnik
Universität Akli Mohand Oulhadj, Bouira, Algerien
E-Mail: [email protected]
GitHub: @Guettaf-hossam

Danksagungen

• Google Gemini KI für die intelligente Systemanalyse
• psutil-Bibliothek für plattformübergreifende Systemüberwachung
• Rich-Bibliothek für schöne Terminalausgaben

Version 1.0 | Zuletzt aktualisiert: Januar 2026

Mit Hingabe erstellt von Knight | Universität Akli Mohand Oulhadj