CORTEX v1.0.0 - INSTALLATION UND SCHNELLSTART

Cortex v1.0.0 wird als einzelne portable Windows-Anwendung ausgeliefert: cortex.exe. Die x64- und x86-Instrumentierungslaufzeiten befinden sich im runtime-Ordner und werden automatisch für jedes Ziel ausgewählt. Sonst muss nichts installiert werden (kein Qt, keine Visual C++-Runtime).

INSTALLATION

1. Laden Sie das Archiv herunter:

   cortex-v1.0.0-windows-portable.zip
   

2. Entpacken Sie das gesamte Archiv in einen normalen, beschreibbaren Ordner, zum Beispiel:

   C:\Cortex\
   

3. Verschieben Sie cortex.exe nicht allein. Behalten Sie den runtime-Ordner neben der ausführbaren Datei.

4. Führen Sie aus:

   .\cortex.exe
   

ERSTE SITZUNG

1. Klicken Sie im Header auf "Select process" (oder Datei > Select process...).
2. Wählen Sie das Ziel aus und klicken Sie auf Attach (oder doppelklicken Sie auf die Zeile).
3. Verwenden Sie das Panel "Value scan" des Memory-Arbeitsbereichs, um einen Wert zu scannen (First scan, dann Next scan).
4. Doppelklicken Sie auf ein nützliches Ergebnis, um einen Addresses-Eintrag vorzubereiten.
5. Verwenden Sie das Kontextmenü einer Adresse, um zum Memory viewer, zum Disassembler, RE, Pointer Maps, Structures oder zu Debugger-Aktionen zu springen.
6. Die Schaltflächen Memory, Debug, RE, Trace, Automation und Runtime im Header ordnen die Arbeitsbereiche für jede Aufgabe neu an.
7. Stellen Sie den Header-Schalter nur dann von "Read-only" auf "Writes allowed" um, wenn Sie eine Operation beabsichtigen, die das Ziel oder den persistenten Zustand ändert.

KOMMANDOZEILEN-MODI

Hilfe:

   .\cortex.exe --help

Version:

   .\cortex.exe --version

Persistenter MCP-Server über stdio (ziellos; vom KI-Client aus verbinden):

   .\cortex.exe mcp

MCP beim Start an eine PID oder einen Prozess anhängen:

   .\cortex.exe mcp --pid 1234
   .\cortex.exe mcp --process game.exe

Auch die Low-Level-Primitive-Tools verfügbar machen:

   .\cortex.exe mcp --tools all

Weitere integrierte Befehle:

   .\cortex.exe probe --pid 1234
   .\cortex.exe diagnose --pid 1234
   .\cortex.exe analyze <directory>
   .\cortex.exe symbolize [options]
   .\cortex.exe inject <target> [dll]

WAS SICH IM ARCHIV BEFINDET

cortex.exe Die Cortex-Anwendung (Desktop-UI und CLI/MCP-Modi).

runtime\x64\cortex_core.dll Instrumentierungslaufzeit für 64-Bit-Ziele.

runtime\x86\cortex_core.dll Instrumentierungslaufzeit für 32-Bit-Ziele.

runtime\x86\cortex_runtime_helper.exe Privater Helfer, der automatisch für 32-Bit-Ziele verwendet wird.

Sie wählen nie zwischen x64 und x86: Cortex liest die Architektur des Ziels
und verwendet die passende Laufzeit, auch für
"cortex.exe inject <pid>".

README.md, CHANGELOG.md, LICENSE, docs Dokumentation, Verlauf, Lizenz und technische Anleitungen.

FEHLERBEHEBUNG

• Wenn cortex.exe nicht startet, prüfen Sie, ob das gesamte Archiv entpackt wurde und ob der runtime-Ordner vorhanden ist.
• Wenn ein Ziel nicht geöffnet werden kann, prüfen Sie dessen Architektur und die Windows-Rechte des Prozesses. Verwenden Sie erhöhte Rechte nur, wenn das Ziel sie erfordert.
• Wenn ein Schreib-, Breakpoint- oder Steuerungsvorgang abgelehnt wird, stellen Sie den Header zuerst auf "Writes allowed" um.
• Einstellungen und das Fensterlayout werden in %LOCALAPPDATA%\Cortex gespeichert. Um sie stattdessen neben cortex.exe zu behalten (USB-Stick, Sandbox), erstellen Sie eine leere Datei namens cortex.portable neben der ausführbaren Datei.
• Im MCP-Modus ist stdout für die gesamte Sitzung für JSON-RPC reserviert; Diagnosen gehen an stderr.
• Siehe docs/getting-started.md, docs/ui-guide.md und docs/ui-walkthrough.md für den vollständigen Workflow.

AUTORISIERUNG

Verwenden Sie Cortex nur auf Software und Systemen, die Ihnen gehören oder die Sie berechtigt sind zu untersuchen. Anti-Cheat-Umgehung, unbefugter Zugriff und Eingriffe in Online-Dienste liegen außerhalb des Geltungsbereichs dieses Projekts.