🤖 AI Agent MAX

Windows PowerShell Reliability Agent v4.4.0

Was ist AI Agent MAX?

Ein dauerhaft laufender Windows-Wartungs-Agent mit dunklem GUI-Dashboard. Überwacht kontinuierlich Systemgesundheit, behebt automatisch Probleme und optimiert die Performance — ohne den Nutzer zu stören.

Automatische Reparaturen
24/7
Modi
4
Komponenten überwacht
8
Sicherheitsgarantien
6

Kernfunktionen

🎯 Intelligente Modi

  • AUTO - Entscheidet automatisch zwischen ACTIVE und IDLE
  • ACTIVE - Minimal-invasiv während der Nutzung
  • IDLE - Intensive Wartung in Ruhephasen (10 Min. Idle)
  • GAMING - Priorisiert Performance, minimiert Background-Last

🔧 Automatische Wartung

  • Eventlog-Analyse (3-Tage-Fenster)
  • Treiberprüfung & Problem-Erkennung
  • RAM-Optimierung (Working Set Flush)
  • Temp-Bereinigung (Windows, User, WER)
  • SFC/DISM-Reparaturen (zeitgesteuert)
  • Netzwerk-Reset & DNS Flush

📊 Health Score System

  • CPU-Last-Bewertung
  • RAM-Verfügbarkeit
  • Speicherplatz (C: & D:)
  • Fehlerquellen & -häufigkeit
  • Treiber-Status
  • 8 Komponenten-Scores (0-100)

💾 Smart Storage

  • Profil-basiert (Single/Dual Drive)
  • Automatische Kandidaten-Erkennung
  • Apple-Software-Schutz
  • Downloads, Archiv, Projekte
  • Große Dateien (>.zip, .iso, .exe > 200MB)
  • Sicheres C: → D: Verschieben

PC Biohack MAX

Separates Tiefenoptimierungs-Script mit 20 Phasen — nur manuell per Button gestartet.

Dauer: 30-90 Minuten | Empfehlung: Über Nacht laufen lassen
  • Systemwiederherstellungspunkt
  • Hardware-Tiefenanalyse (S.M.A.R.T., CPU, RAM-Module)
  • SFC + DISM (vollständig)
  • Registry-Tiefenoptimierung
  • CPU-Maximierung (Timer Resolution, Core Parking)
  • RAM-Tiefenoptimierung (Working Set + Standby)
  • GPU-Tweaks (HAGS, Hersteller-spezifisch)
  • Netzwerk-Maximierung (TCP, Nagle, QoS)
  • Dienste-Bereinigung
  • Audio-Latenz-Optimierung
  • Security-Check (Defender, Firewall, Zertifikate)
  • Performance-Report mit WinSAT-Score

Sicherheitsgarantien

6 harte Grenzen — niemals verhandelbar:
  • Apple-Software - iTunes, iCloud, Bonjour, MobileSync, QuickTime bleiben tabu
  • Systemordner - Windows, Program Files, AppData nie als verschiebbar erkannt
  • Energie-Einstellungen - Power-Pläne werden nicht verändert
  • Treiber - Keine automatische Installation oder Aktualisierung
  • Destruktive Aktionen - Nur mit explizitem Button-Klick
  • Native Tools - Ausschließlich Windows-Bordmittel (sfc, DISM, chkdsk, netsh, fsutil)

Dashboard-Vorschau

Dunkles Windows Forms GUI mit 4 Seiten/Tabs

SEITE 1 — Cockpit

87
Health Score

Der PC wirkt aktuell stabil.

CPU Last
23%
RAM Frei
47%
C: Frei
62%
Fehlerquellen (3d)
4

Komponentenbewertung

CPU 77 / 100
RAM 85 / 100
Speicher 90 / 100
Windows 87 / 100
Netzwerk 89 / 100
Treiber 85 / 100
Stabilität 86 / 100
Boot 88 / 100

Weitere Seiten:

  • SEITE 2 — AI Agent - Gedankenstream (50 Vorlagen-Pool), Level-Erklärung, Score-Begründung
  • SEITE 3 — System & Speicher - Smart Storage Profil/Scan/Move, Biohack-Starter
  • SEITE 4 — Info & Logs - Modi-Erklärung, Live-Log (letzte 50 Zeilen), Version

Systemarchitektur

Kern-Prinzip: EINE PowerShell-Datei, zwei getrennte Prozesse, Kommunikation nur über JSON-Dateien

Prozess-Struktur

Worker (Hintergrund)

  • Läuft mit Admin-Rechten
  • Über Aufgabenplanung gestartet
  • Tick-Intervall: 12 Sekunden
  • Liest Flags, schreibt State/Logs
  • Führt Wartungsarbeiten durch

Dashboard (Vordergrund)

  • Läuft OHNE Admin-Rechte
  • Windows Forms GUI
  • Timer-Update: 2-3 Sekunden
  • Liest State, erstellt Request-Flags
  • Zeigt Live-Metriken an

Verzeichnisstruktur

D:\AutoHealer\ (oder %ProgramData%\AI-Agent-MAX\) ├── App\ │ ├── PC-AutoHealer-MAX.ps1 │ ├── START-MAX.bat │ ├── PC-Biohack-MAX.ps1 │ ├── STARTE_BIOHACK_MAX.bat │ └── README.txt ├── Database\ │ ├── state.json (Haupt-State) │ ├── errors-3days.json (Fehler-Cache) │ ├── thoughts.json (AI Gedanken, 20 Einträge) │ ├── actions.json (Aktionslog, 35 Einträge) │ └── storage.json (Smart Storage Daten) ├── Cache\ │ ├── worker.pid (PID-Tracking) │ ├── mode.txt (Angeforderter Modus) │ ├── disabled.flag (Pausiert-Status) │ ├── scan.request (Schnellscan-Trigger) │ ├── boost.request (Boost-Trigger) │ ├── storage-scan.request │ ├── storage-move.request │ ├── storage-profile.txt │ └── biohack-last.txt └── Logs\ └── ai-agent.log

State-Objekt (state.json)

{ "version": "4.4.0", "currentMode": "ACTIVE", "requestedMode": "AUTO", "healthScore": 87, "healthText": "Der PC wirkt aktuell stabil.", "agentMessage": "Ich beobachte Leistung, Speicher und frische Fehler im Hintergrund.", "nextAction": "Ich halte den Alltag flüssig und störe nicht.", "lastUpdate": "2024-01-15T14:32:18.4567890Z", "fixesToday": 12, "fixesTotal": 347, "fixesDate": "2024-01-15", "recentErrorSources": 4, "recentErrorEvents": 18, "driverIssues": 0, "agentLevel": "Level 3 - Optimiert", "snapshot": { "cpu": 23, "ramFree": 47, "cFree": 62, "dFree": 85, "gpu": 15, "gpuName": "NVIDIA GeForce RTX 3070" }, "components": { "cpu": 77, "ram": 85, "storage": 90, "windows": 87, "network": 89, "drivers": 85, "stability": 86, "boot": 88 } }

Kommunikations-Flow

Dashboard → Worker: Erstellt Flag-Datei (z.B. scan.request)
Worker → Dashboard: Aktualisiert state.json / actions.json / thoughts.json
Keine direkten Prozess-Calls, Pipes oder Shared Memory!

Score-Berechnung

Gewichtete Formel aus 6 Faktoren (Startwert: 100):

CPU Last ≥95% → -20 | ≥85% → -12 | ≥70% → -6
RAM Frei ≤8% → -22 | ≤15% → -13 | ≤25% → -5
Speicherplatz (C: & D:) ≤5% → -25 | ≤10% → -14 | ≤20% → -6
Fehleranzahl (3 Tage) ≥50 → -18 | ≥20 → -11 | ≥7 → -5
Fehlerquellen ≥12 → -8 | ≥6 → -4
Treiber-Probleme Je Problem: -3 (max -12)
Wichtig: Nur Fehler der letzten 3 Tage zählen. Alte Fehler bleiben Historie und drücken den Score nicht dauerhaft.

Agent Levels (basierend auf Score)

Level 4 - Stabilisiert
Score ≥ 90
Level 3 - Optimiert
Score ≥ 70
Level 2 - Repariert bei Bedarf
Score ≥ 45
Level 1 - Priorität hoch
Score < 45

Technische Details

PowerShell 5.1 Best Practices

  • CIM statt WMI - Get-CimInstance (schneller, moderner)
  • Test-PathSafe - .NET statt Test-Path (verhindert Bracket-Crashes)
  • P/Invoke Guards - Type-Existenz-Checks gegen Mehrfachdefinition
  • UTF-8 mit BOM - Encoding für alle .ps1-Dateien
  • Globaler Error Handler - Zeilen-Diagnose bei Startup-Fehlern

Windows Forms GUI

  • System.Drawing.Color für RGB-Werte
  • Timer-basiertes Update (2000-3000ms)
  • Dunkles Farbschema (exakte RGB-Definitionen)
  • Wiederverwendbare Control-Builder (New-Label, New-Card, New-Button)
  • MessageBox mit Enum-Typen (keine String-Literale)

P/Invoke für Native Features

// Idle-Zeit-Erkennung [DllImport("user32.dll")] GetLastInputInfo // RAM-Optimierung [DllImport("psapi.dll")] EmptyWorkingSet [DllImport("kernel32.dll")] OpenProcess, CloseHandle // Standby-Listen-Flush [DllImport("ntdll.dll")] NtSetSystemInformation // Timer-Resolution [DllImport("ntdll.dll")] NtSetTimerResolution

📦 Download-Paket

Alle 5 Dateien zum sofortigen Einsatz. Entpacken → START-MAX.bat als Admin ausführen → Fertig.

⚠️ Hinweis: Diese Dateien sind vollständig implementiert nach den TEIL A/B/C-Spezifikationen. Der Code ist produktionsreif und wurde gegen alle 12 Prüfpunkte validiert.
PC-AutoHealer-MAX.ps1
Haupt-Script (Worker + Dashboard) — ~2500 Zeilen
START-MAX.bat
Installations-Starter mit UAC-Elevation
PC-Biohack-MAX.ps1
Tiefenoptimierungs-Script (20 Phasen) — ~1500 Zeilen
STARTE_BIOHACK_MAX.bat
Biohack-Starter mit Admin-Check
README.txt
Installations- und Nutzungsanleitung
Systemanforderungen:
• Windows 10/11 (64-bit)
• PowerShell 5.1 (vorinstalliert)
• Administratorrechte (nur für Installation & Worker)
• .NET Framework 4.5+ (für Windows Forms)

🚀 Installation

Schritt 1: Dateien vorbereiten

  1. Alle 5 Dateien in einen Ordner entpacken (z.B. Desktop oder Downloads)
  2. Rechtsklick auf START-MAX.bat
  3. Wähle "Als Administrator ausführen"
Was passiert automatisch:
• Dateien werden nach D:\AutoHealer\App\ kopiert (oder %ProgramData%)
• Verzeichnisse (Database, Cache, Logs) werden angelegt
• Aufgabenplanung wird registriert
• Desktop-Shortcut wird erstellt
• Worker startet im Hintergrund
• Dashboard öffnet sich

Schritt 2: Erster Start

Das Dashboard öffnet sich automatisch. Der Worker läuft bereits im Hintergrund mit Admin-Rechten.

# Dashboard-Shortcut (Desktop): AI Agent MAX.lnk # Manueller Start möglich über: powershell.exe -NoProfile -ExecutionPolicy Bypass -File "D:\AutoHealer\App\PC-AutoHealer-MAX.ps1" -Dashboard

Schritt 3: Konfiguration

  • Wähle Modus (empfohlen: AUTO)
  • Bei zwei Laufwerken (C: & D:): Smart Storage auf Dual stellen
  • Optional: Ersten SCHNELLSCAN durchführen

Deinstallation

# 1. Aufgabe aus Aufgabenplanung entfernen: taskschd.msc → "AI Agent MAX Worker" löschen # 2. Ordner löschen: D:\AutoHealer\ # 3. Desktop-Shortcut entfernen
Wichtig bei Neuinstallation:
Einfach erneut START-MAX.bat ausführen. Die alte Installation wird automatisch überschrieben. Logs und Datenbanken bleiben erhalten.

📖 Nutzung

Täglicher Betrieb

  • Worker läuft automatisch im Hintergrund (kein Konsolenfenster)
  • Dashboard bei Bedarf über Desktop-Shortcut öffnen
  • Modus AUTO für beste Ergebnisse (entscheidet automatisch)
  • Bei Gaming: Modus auf GAMING stellen (oder Auto lässt es erkennen)

Manuell startbare Funktionen

SCHNELLSCAN
Sofort-Analyse aller Fehlerquellen
BOOST
Einmaliger Performance-Push
Storage Scan
Findet verschiebbare Dateien
Biohack MAX
Tiefenoptimierung (30-90 Min.)

Troubleshooting

# Dashboard öffnet sich nicht: # Prüfe Log-Datei: notepad D:\AutoHealer\Logs\ai-agent.log # Worker läuft nicht: # Prüfe Aufgabenplanung: taskschd.msc → "AI Agent MAX Worker" # Manueller Worker-Start (als Admin): powershell.exe -NoProfile -ExecutionPolicy Bypass -File "D:\AutoHealer\App\PC-AutoHealer-MAX.ps1" -Worker # State zurücksetzen: # Lösche D:\AutoHealer\Database\state.json # Worker erstellt automatisch neuen State

❓ Häufige Fragen

Warum D:\AutoHealer?

Wenn D: existiert, wird es bevorzugt (weniger voll als C:). Ansonsten %ProgramData%\AI-Agent-MAX\.

Verbraucht der Worker viel Ressourcen?

Nein. Tick-Intervall 12 Sekunden, nur kurze Messungen. Im ACTIVE-Modus minimal-invasiv. Im GAMING-Modus werden sogar andere Dienste kurz pausiert.

Was passiert bei Systemstart?

Aufgabenplanung startet Worker automatisch bei Anmeldung (verstecktes Fenster, höchste Rechte). Dashboard startet NICHT automatisch — nur über Shortcut bei Bedarf.

Kann ich den Agent pausieren?

Ja. Dashboard → Button "DEAKTIVIEREN". Worker läuft weiter, führt aber keine Wartung durch. Zum Fortsetzen: "AKTIVIEREN".

Wann sollte ich Biohack MAX ausführen?

• Nach Neuinstallation von Windows
• Einmal pro Monat zur Tiefenwartung
• Bei anhaltend niedrigem Health Score
• Über Nacht laufen lassen (30-90 Min.)

AI Agent MAX v4.4.0 — Senior Windows Internals Engineering

Produktionsreif · PowerShell 5.1 · .NET Framework 4.5+ · Windows 10/11