jarv1s-csn/windows-safe-write

Was macht windows-safe-write?

Codex-Fähigkeit + Hooks: sicheres Shell-Routing, argv-Ausführung, UTF-8-Disziplin auf nativen Windows-Hosts (ohne WSL)

Beschreibung

Diese Fähigkeit stellt sicher, dass Codex-basierte KI-Agenten (wie z. B. Cursor, Codex) auf nativen Windows-Systemen Shell-Befehle sicher und zuverlässig ausführen können. Sie umfasst:

• Sicheres Shell-Routing: Vermeidet Probleme mit cmd.exe-Escaping und gewährleistet korrekte Pfadübergabe.
• argv-basierte Ausführung: Führt Befehle direkt über die Windows-API aus, ohne Umweg über die Shell, was Parameter-Injection verhindert.
• UTF-8-Disziplin: Erzwingt UTF-8-Kodierung für Ein- und Ausgaben, auch wenn die Systemcodepage nicht UTF-8 ist.

Funktionsweise

1. Der Agent erkennt, ob er auf einem nativen Windows-Host läuft (Prüfung auf os.name oder %OS%).
2. Statt cmd /c <befehl> wird die Ausführung über subprocess.Popen mit shell=False und expliziten Argumenten (argv) durchgeführt.
3. Die Umgebungsvariable PYTHONIOENCODING=utf-8 wird gesetzt, und bei Bedarf wird chcp 65001 vor dem Befehl ausgeführt.
4. Fehlerhafte Escape-Sequenzen (z. B. doppelte Anführungszeichen in Pfaden) werden automatisch korrigiert.

Installation

# In Ihr Codex-Skriptverzeichnis oder als Hook registrieren:
cp hooks/windows-safe-write.js /pfad/zu/codex/hooks/

Verwendung

Aktivieren Sie den Skill in Ihrer Codex-Konfiguration:

{
  "skills": ["jarv1s-csn/windows-safe-write"],
  "hooks": ["windows-safe-write"]
}

Danach werden alle Shell-Befehle automatisch über die sichere Windows-Routing-Schicht ausgeführt.

Unterstützte Plattformen

• Windows 10/11 (native, ohne WSL)
• Windows Server 2016+
• Codex, Cursor, und andere kompatible Agenten

Fehlerbehebung

Problem	Lösung
Befehle werden nicht ausgeführt	Prüfen Sie, ob die Hooks geladen sind (codex --debug)
Falsche Zeichenkodierung	Setzen Sie PYTHONIOENCODING=utf-8 in Ihrer Umgebung
Pfade mit Leerzeichen	Verwenden Sie einfache Anführungszeichen oder maskierte Pfade

Lizenz

MIT