SuperDiagnosticTool

# SuperDiagnosticTool

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/11160/8b0da1a673733dc9731164bd4d4a3ecc6a137e583d070725852e8173311ef7fc.png" alt="SuperDiagnosticTool Icon" width="200"/>
</p>

<p align="center">
  <strong>KI-gestütztes Windows-Diagnose- &amp; Behebungstool</strong>
</p>

<p align="center">
  <a href="https://github.com/Guettaf-hossam/SuperDiagnosticTool/releases"><img src="https://img.shields.io/github/v/release/Guettaf-hossam/SuperDiagnosticTool?style=flat-square" alt="Release"></a>
  <a href="https://github.com/Guettaf-hossam/SuperDiagnosticTool/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-GPL%20v3.0-blue.svg?style=flat-square" alt="License"></a>
  <a href="https://github.com/Guettaf-hossam/SuperDiagnosticTool/stargazers"><img src="https://img.shields.io/github/stars/Guettaf-hossam/SuperDiagnosticTool?style=flat-square" alt="Stars"></a>
</p>

SuperDiagnosticTool erfasst Hardware-Telemetrie in Echtzeit, sendet sie zur Analyse an die Google Gemini API und generiert PowerShell-Behebungsskripte, um erkannte Probleme zu beheben. Es enthält mehrere Validierungsebenen, die ein generiertes Skript bestehen muss, bevor der Benutzer aufgefordert wird, es auszuführen.

---

## Screenshots

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/11160/eb10d4e2a86193e87d0face0e034418d7a5977df9057fb6fed97b0ea705e4442.png" alt="Main Interface" width="800"/>
</p>

*Hauptoberfläche mit Auswahl des Scan-Modus und Eingabe der Problembeschreibung*

---

## Hauptfunktionen

### Universelle Hardware-Unterstützung
- **Dynamische Skalierung:** Passt sich automatisch an jede CPU-Konfiguration an (1-128+ Kerne)
- **Hardware-unabhängige Logik:** Funktioniert auf Legacy-Systemen (Intel Pentium) bis hin zu High-End-Workstations (AMD Threadripper, Intel Xeon)
- **Sichere Fallbacks:** Sicherer Umgang mit nicht unterstützten Hardware-Abfragen (CPU-Frequenz, Akku, Auslagerungsspeicher)
- **Für schwache Hardware optimiert:** Leichtgewichtige Ausführung, um Ressourcenbelastung auf leistungsschwacher Hardware zu vermeiden

### Intelligente KI-Analyse
- **Google Gemini Integration:** KI-gestützte Systemanalyse und Diagnose über die Gemini API
- **Kontextbewusste Empfehlungen:** Korreliert vom Benutzer gemeldete Probleme mit der erfassten System-Telemetrie
- **Sicherheitsaudit:** Sucht nach verdächtigen Prozessen, Ressourcenlecks und potenziellen Malware-Indikatoren
- **Verifizierung nach der Behebung:** Erstellt Abschlussberichte, die automatisierte Korrekturen von manuell zu bearbeitenden Punkten unterscheiden

### Mehrschichtige Sicherheitsarchitektur

Von Gemini generierte Skripte durchlaufen vier aufeinanderfolgende Prüfungen, bevor der Benutzer aufgefordert wird, die Ausführung zu genehmigen:

#### Validierungs-Pipeline
- **Wissensdatenbank-Abgleich:** Gleicht KI-Lösungen mit einer Reihe getesteter, bewährter Behebungsmuster ab
- **Dry-Run-Simulation:** Zeigt alle beabsichtigten Änderungen (Dienste, Dateien, Registry) als Vorschau an, bevor eine Modifikation erfolgt
- **Skriptvalidierung (`ScriptValidator`):** Dreistufige Prüfung — Blacklist (harte Sperre bei destruktiven Mustern), Erkennung verdächtiger Muster (alias- und verschleierungsbewusst) und Risikobewertung auf einer Skala von 0-100
- **Abfangen kritischer Pfade (`CriticalPathInterceptor`):** Zero-Trust-Gate, das jedes Skript anhält, das HKLM/HKCU-Registrierungsschlüssel oder System32-Pfade berührt, bis der Benutzer dies ausdrücklich bestätigt

#### Sicherheitsgrenzen
- **Systemwiederherstellungspunkte:** Werden automatisch vor jeder Modifikation erstellt
- **Snapshots vor/nach der Ausführung:** Vollständige Erfassung des Systemzustands, um jede vorgenommene Änderung zu erkennen und zu protokollieren
- **Rollback-Generierung:** Erzeugt automatisch ein selektives Rollback-Skript, falls die Ausführung fehlschlägt
- **Ausführungsprotokollierung:** Jede Aktion wird mit Zeitstempeln in `%TEMP%\superdiagnostic_execution_*.log` protokolliert

#### PowerShell-Ausführung
- **Überprüfung der Administratorrechte:** Skripte prüfen vor dem Fortfahren, ob eine erhöhte Berechtigung vorliegt
- **Variablenbereinigung:** Regex-basiertes Escaping bewahrt `$env:`-Variablen ohne Syntaxfehler
- **Dienst-Sicherheitsprüfungen:** Überprüft die Existenz eines Dienstes vor jeder Start/Stop/Set-Operation
- **Überwachte Ausführung:** Skripte werden über `subprocess.run` mit einem festen Timeout von 5 Minuten, vollständiger Erfassung von stdout/stderr und automatischer Bereinigung temporärer Dateien ausgeführt. Dies ist eine direkte Ausführung auf Host-Ebene, keine VM- oder Container-Isolation. Die oben genannten Validierungsschichten bilden die primäre Sicherheitsgrenze.
- **Fehlerbehandlung:** Der PowerShell-Wrapper enthält try/catch/finally-Blöcke mit Fehlerberichterstattung pro Zeile

### Umfassendes System-Scanning
- **Leistungskennzahlen:** CPU-Auslastung (gesamt + pro Kern), Speicheraufschlüsselung, Top-Ressourcenverbraucher
- **Netzwerk-Intelligenz:** Aktive Schnittstellen, DNS-Konfiguration, Wi-Fi-Signalstärke, Konnektivitätstests
- **Sicherheitsintegrität:** Antivirus-Status, Firewall-Profile, Windows Update-Verlauf
- **Hardware-Zustand:** SMART-Status der Festplatte, GPU-Informationen, Batteriestatus (Laptops)
- **Systemdienste:** Autostart-Anwendungen, fehlgeschlagene Dienste, kritische Ereignisprotokolle
- **Prozess-Auditing:** Identifiziert Prozesse mit ungewöhnlicher Ressourcennutzung oder Dateispeicherorten

### Menschzentrierte Berichterstattung
- **Professionelle HTML-Berichte:** Diagnoseberichte im dunklen Design, responsiv, mit visuellen Kennzahlen
- **Abschlussformulierungen in der Vergangenheitsform:** Berichte verwenden die Tags `[FIXED]`, `[CLEANED]`, `[DISABLED]`, um abgeschlossene Aktionen widerzuspiegeln
- **Abschnitt für manuelle Aufmerksamkeit:** Trennt automatisierte Korrekturen klar von Punkten, die ein Eingreifen des Benutzers erfordern
- **Zeitgestempelte Archive:** Alle Berichte werden zur historischen Nachverfolgung in `AI_Reports/` gespeichert

---

## Schnellstart

### Download

**[SuperDiagnosticTool.exe herunterladen](https://github.com/Guettaf-hossam/SuperDiagnosticTool/releases/latest)** — Eigenständige ausführbare Datei (kein Python erforderlich)

> Die ausführbare Datei ist nicht signiert. Windows SmartScreen zeigt beim ersten Ausführen eine Warnung an. Siehe [TRUST_GUIDE.md](https://github.com/guettaf-hossam/superdiagnostictool/blob/main/TRUST_GUIDE.md) für das weitere Vorgehen. Wenn Sie lieber vor der Ausführung verifizieren möchten, erstellen Sie die Anwendung stattdessen aus dem Quellcode.

### Voraussetzungen

- Windows 10 oder Windows 11
- Administratorrechte (erforderlich für System-Telemetrie und Behebung)
- Google Gemini API-Schlüssel ([Kostenlosen Schlüssel erhalten](https://aistudio.google.com/app/apikey))

### Erster Start

1. Laden Sie `SuperDiagnosticTool.exe` herunter und führen Sie sie aus
2. Geben Sie bei Aufforderung Ihren Google Gemini API-Schlüssel ein
3. Beschreiben Sie Ihr Systemproblem
4. Wählen Sie den Scan-Modus (Quick / Deep / Complete)
5. Überprüfen Sie die KI-Analyse und das generierte Behebungsskript
6. Genehmigen Sie die Ausführung oder sehen Sie sich den detaillierten HTML-Bericht an

---

## Installation (Für Entwickler)

### Voraussetzungen
- Python 3.8 oder höher
- pip-Paketmanager

### Abhängigkeiten installieren

Erstellen Sie eine virtuelle Umgebung, damit die Abhängigkeiten des Tools von
anderen Python-Projekten isoliert bleiben:

```bash
python -m venv .venv
```

Aktivieren Sie es in der Windows-Eingabeaufforderung und installieren Sie dann die im Repository aufgeführten Abhängigkeiten:

```bat
.venv\Scripts\activate
pip install -r requirements.txt
```

In PowerShell aktivieren Sie die Umgebung mit:

```powershell
.\.venv\Scripts\Activate.ps1
```

Wenn PowerShell das Aktivierungsskript blockiert, öffne PowerShell als dein Benutzer und führe einmal `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` aus, und versuche dann den Aktivierungsbefehl erneut.

### Aus dem Quellcode ausführen

```bash
python super_diagnose_v2.py
```

Um zu bestätigen, dass der Quellbaum und die Abhängigkeiten bereit sind, bevor ein Scan gestartet wird, führen Sie aus:

```bash
python -m compileall src super_diagnose_v2.py
```

Der Befehl sollte ohne Fehler abgeschlossen werden. Das Tool erfordert bei der Ausführung weiterhin Windows und
Administratorrechte, da mehrere Diagnosen
PowerShell und geschützte Systeminformationen verwenden.

---

## Verwendung

### API-Schlüssel-Einrichtung

**Option A: Interaktive Eingabe (empfohlen für die erstmalige Verwendung)**
- Das Tool fordert beim ersten Ausführen zur Eingabe eines API-Schlüssels auf
- Der Schlüssel wird, sofern verfügbar, sicher über Windows DPAPI (`keyring`) gespeichert

**Option B: Umgebungsvariable**
Eingabeaufforderung:
```bat
set GEMINI_API_KEY=your_api_key_here
```

PowerShell:
```powershell
$env:GEMINI_API_KEY = "your_api_key_here"
```

**Option C: Manuelle Schlüsseldatei**
Erstellen Sie `gemini.key` im Tool-Verzeichnis:
```
your_api_key_here
```

### Scan-Modi

| Modus | Scannt | Anwendungsfall |
|------|-------|----------|
| **Quick Scan** | CPU, RAM, Basisinformationen | Schnelle Leistungsprüfung |
| **Deep Scan** | System, Netzwerk, Sicherheit, Protokolle, Bluetooth, Prozesse | Umfassende Fehlerbehebung |
| **Complete Scan** | Alles oben Genannte + Datenträgerzustand, GPU, Autostart-Apps | Vollständige Systemprüfung |

### Beispiel-Workflow

```
1. Run the tool
   > SuperDiagnosticTool.exe

2. Describe your issue
   > High CPU usage and slow performance

3. Select scan mode
   > 3 (Complete System Scan)

4. Wait for AI analysis
   [Scanning system layers...]
   [Processing telemetry...]

5. Review the generated remediation script
   > Execute? (y/n)

6. View the HTML report
   > Open detailed report? (y/n)
```

---

## Technische Details

### Code-Architektur
- Modulares Design — jede Diagnosekategorie ist eine isolierte Funktion
- Umfassende Fehlerbehandlung mit try/except-Blöcken durchgängig
- Hardware-agnostische Abfragen mit sanften Fallbacks für nicht unterstützte Funktionen
- Standard-Python-Docstrings für alle öffentlichen Klassen und Methoden

### PowerShell-Skript-Generierung
- Überprüfung der Admin-Rechte vor der Ausführung
- Regex-basiertes Escaping von Variablen zur Vermeidung von Syntaxfehlern
- Umgebungsvariablen (`$env:TEMP`, `$env:PATH`) werden korrekt beibehalten
- Sicheres Dienstmanagement mit Existenzprüfungen vor jedem Vorgang

### Gemini-KI-Integration
- Strukturierte Prompts mit abgegrenzten Abschnitten (`[ANALYSIS_START]`, `[FIX_START]`) für zuverlässiges Parsen der Ausgabe
- Kontextbewusste Analyse anhand des erfassten System-Telemetrie-Snapshots
- Berichterstattung im Präteritum für abgeschlossene Behebungsmaßnahmen

---

## Sicherheit & Datenschutz

### Was auf Ihrem Rechner bleibt
- Alle Systemscans und Analysen laufen lokal ab.
- Durch dieses Tool werden keine Telemetriedaten auf externen Servern gespeichert.

### Was extern gesendet wird
- Zur Erzeugung von KI-Empfehlungen wird ein Telemetrie-Snapshot (CPU-Last, Speicher, Prozessnamen, Ereignisprotokolleinträge, Netzwerkstatus) an die **Gemini-API von Google** übertragen.
- Ihr API-Schlüssel wird bei jeder Anfrage an Google mitgesendet.
- Lesen Sie die [Datenschutzrichtlinie von Google](https://policies.google.com/privacy), um zu erfahren, wie diese Daten auf deren Seite behandelt werden.

### Weitere Sicherheitseigenschaften
- **API-Schlüssel-Speicherung:** Wird über Windows DPAPI (`keyring`) gespeichert, sofern verfügbar. Wird niemals in die Versionskontrolle eingecheckt.
- **Admin-Transparenz:** Jedes Behebungsskript wird vollständig angezeigt und erfordert vor der Ausführung die ausdrückliche Zustimmung des Benutzers.
- **Standardmäßig nicht destruktiv:** Änderungen an der Registry und an Dateien erfordern das Bestehen des `CriticalPathInterceptor` und eine ausdrückliche Bestätigung durch den Benutzer.
- **Open Source:** Der vollständige Quellcode ist zur unabhängigen Prüfung unter GPL v3.0 verfügbar.

Weitere Sicherheitsdokumentation finden Sie in [SECURITY.md](https://github.com/guettaf-hossam/superdiagnostictool/blob/main/SECURITY.md).

---

## Fehlerbehebung

### Fehler „API Key Invalid"
- Überprüfen Sie, ob der Schlüssel korrekt und aktiv ist, unter [Google AI Studio](https://aistudio.google.com/app/apikey)
- Prüfen Sie den Schlüssel auf versteckte Leerzeichen oder Zeilenumbruchzeichen
- Stellen Sie sicher, dass für den Schlüssel der Zugriff auf die Gemini-API aktiviert ist

### „Not Running as Administrator"
- Klicken Sie mit der rechten Maustaste auf die ausführbare Datei und wählen Sie „Als Administrator ausführen"
- Oder erlauben Sie die UAC-Aufforderung, wenn das Tool eine Rechteerhöhung anfordert

### Fehler „Module Not Found" (Python-Version)
```bash
pip install --upgrade psutil google-generativeai rich
```

### PowerShell-Skript schlägt fehl
- Stellen Sie sicher, dass Windows PowerShell 5.1 oder höher installiert ist
- Das generierte Skript wird unter `AI_Reports/remediation.ps1` gespeichert — überprüfen Sie es manuell auf Fehler

---

## Aus dem Quellcode erstellen

### Automatisierte Builds (empfohlen)

Das Projekt verwendet GitHub Actions, um Windows-Executables beim Push eines Versions-Tags zu erstellen:

1. Pushen Sie Ihre Änderungen in den Main-Branch
2. Erstellen und pushen Sie einen Versions-Tag:
   ```bash
   git tag -a v1.0.2 -m "Release notes" && git push origin v1.0.2
   ```
3. GitHub Actions erstellt die `.exe` und legt automatisch ein Release an
4. Von der [Releases-Seite](https://github.com/Guettaf-hossam/SuperDiagnosticTool/releases) herunterladen

Siehe [`.github/workflows/release.yml`](https://github.com/guettaf-hossam/superdiagnostictool/blob/main/.github/workflows/release.yml) für die Konfiguration des Release-Workflows.

### Manueller Build (zum Testen)

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

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

### Dateistruktur

```
SuperDiagnosticTool/
├── super_diagnose_v2.py       # Main entry point and diagnostic logic
├── build.py                   # PyInstaller build script
├── icon.ico                   # Application icon
├── .github/workflows/
│   └── release.yml            # Automated build and release workflow
├── docs/
│   ├── icon.png
│   └── screenshot_main.png
├── src/
│   ├── safety/                # Script validation and monitored execution
│   │   ├── validator.py       # ScriptValidator + CriticalPathInterceptor
│   │   ├── sandbox.py         # SandboxExecutor (monitored subprocess runner)
│   │   ├── dry_run.py         # DryRunSimulator
│   │   ├── restore_point.py   # RestorePointManager
│   │   ├── enhanced_monitoring.py
│   │   └── knowledge_base.py
│   └── security/              # CredentialVault (DPAPI-backed key storage)
├── AI_Reports/                # Generated HTML reports and remediation scripts
├── README.md
├── SECURITY.md
├── TRUST_GUIDE.md
├── LICENSE                    # GPL-3.0
└── .gitignore
```

## Haftungsausschluss

Dieses Tool generiert und führt PowerShell-Skripte aus, die Systemdienste, Konfigurationen und Registrierungswerte ändern. Bevor Sie ein Remediation-Skript genehmigen:

- **Lesen Sie das vollständige Skript** — es wird angezeigt, bevor die Ausführung erlaubt wird
- **Sichern Sie kritische Daten**, bevor Sie automatisierte Remediation ausführen
- **Testen Sie auf einem unkritischen System**, wenn der Umfang der Änderungen unklar ist

Der Autor ist nicht verantwortlich für Systemschäden, Datenverlust oder unbeabsichtigte Folgen, die sich aus der Nutzung dieses Tools ergeben.

---

## Mitwirken

Beiträge sind willkommen. So können Sie mitwirken:

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 unter der **GNU General Public License v3.0** lizenziert — siehe die Datei [LICENSE](https://github.com/guettaf-hossam/superdiagnostictool/blob/main/LICENSE) für Details.

Copyright (C) 2026 GUETTAF HOUSSEM EDDINE

---

## Autor

**Guettaf Houssem Eddine**
Student der Elektrotechnik
Universität Akli Mohand Oulhadj, Bouira, Algerien
E-Mail: [email protected]
GitHub: [@Guettaf-hossam](https://github.com/Guettaf-hossam)

---

## Danksagungen

- **Google Gemini AI** für Systemanalysefunktionen
- **psutil** für plattformübergreifende Systemtelemetrie
- **Rich** für die Darstellung der Terminal-Oberfläche

---

<p align="center">
  <strong>Version 1.0</strong> | Zuletzt aktualisiert: August 2026
</p>

<p align="center">
  Universität Akli Mohand Oulhadj, Bouira, Algerien
</p>