Windows-Einrichtung

Überblick

YeePilot läuft unter Windows 10 und Windows 11 mit nativen Binärdateien für sowohl x86_64 als auch ARM64. Diese Anleitung behandelt Installation, PATH-Konfiguration, Zugangsdatenspeicherung und wie Sie über WSL2 volle Sandbox-Funktionen erhalten.

Systemanforderungen

Installation

Binärdatei herunterladen

Es gibt noch kein automatisiertes Installationsskript für Windows. Laden Sie die Binärdatei manuell von der Release-Seite (opens in new tab) herunter:

• yeepilot-windows-amd64.tar.gz für Standard-x86_64-Systeme
• yeepilot-windows-arm64.tar.gz für ARM64-Geräte (z.B. Surface Pro X, Snapdragon-Laptops)

Entpacken und installieren

1. Entpacken Sie das heruntergeladene Archiv. Sie können den integrierten Windows-tar-Befehl in PowerShell verwenden:

tar xzf yeepilot-windows-amd64.tar.gz

2. Verschieben Sie die Binärdatei an einen permanenten Speicherort. Eine gängige Wahl ist C:\Program Files\YeePilot\:

New-Item -ItemType Directory -Force -Path "C:\Program Files\YeePilot"
Move-Item yeepilot.exe "C:\Program Files\YeePilot\yeepilot.exe"

3. Fügen Sie das Verzeichnis zu Ihrem System-PATH hinzu, damit Sie yeepilot von überall ausführen können.

Zum PATH hinzufügen

Über Systemeinstellungen (Permanent)

1. Drücken Sie Win + S und suchen Sie nach "Umgebungsvariablen".
2. Klicken Sie auf Systemumgebungsvariablen bearbeiten.
3. Klicken Sie auf Umgebungsvariablen.
4. Wählen Sie unter Benutzervariablen (oder Systemvariablen für alle Benutzer) Path und klicken Sie auf Bearbeiten.
5. Klicken Sie auf Neu und fügen Sie C:\Program Files\YeePilot hinzu.
6. Klicken Sie auf OK in allen Dialogen.
7. Öffnen Sie ein neues Terminalfenster, damit die Änderung wirksam wird.

Über PowerShell (Aktueller Benutzer, Permanent)

$currentPath = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$currentPath;C:\Program Files\YeePilot", "User")

Öffnen Sie nach dem Ausführen dieses Befehls ein neues Terminalfenster.

Installation überprüfen

yeepilot version

Ersteinrichtung

Führen Sie die interaktive Einrichtung aus, um Ihren KI-Anbieter zu konfigurieren:

yeepilot setup

Dies erstellt Ihre Konfigurationsdatei unter %USERPROFILE%\.yeepilot\config.yaml (normalerweise C:\Users\IhrName\.yeepilot\config.yaml).

Zugangsdatenspeicherung

YeePilot verwendet die Windows Data Protection API (DPAPI), um API-Schlüssel und Authentifizierungstoken sicher zu speichern. DPAPI verschlüsselt Zugangsdaten unter Verwendung Ihres Windows-Benutzerkontos, sodass sie nur zugänglich sind, wenn Sie angemeldet sind.

• Es wird keine zusätzliche Software benötigt.
• Zugangsdaten werden in einer verschlüsselten Datei innerhalb Ihres YeePilot-Konfigurationsverzeichnisses gespeichert.
• Die Verschlüsselung ist an Ihr Windows-Benutzerkonto gebunden. Andere Benutzer auf demselben Rechner können sie nicht entschlüsseln.

Terminal-Empfehlungen

YeePilots TUI erfordert ein modernes Terminal mit guter Unicode- und Farbunterstützung.

Windows Terminal installieren

Falls Sie Windows Terminal nicht installiert haben:

winget install Microsoft.WindowsTerminal

Oder laden Sie es aus dem Microsoft Store (opens in new tab) herunter.

Sandbox-Einschränkungen

Natives Windows unterstützt keine Linux-Kernel-Namespaces. YeePilot verwendet unter Windows Prozessebenen-Ressourcenlimits, die grundlegenden Schutz bieten:

• CPU-Zeitlimits -- Befehle werden beendet, wenn sie die konfigurierte CPU-Zeit überschreiten.
• Speicherlimits -- Prozessspeicher wird begrenzt.
• Dateigrößenlimits -- Die Erstellung einzelner Dateien wird begrenzt.

# %USERPROFILE%\.yeepilot\config.yaml
sandbox:
  enabled: true
  use_namespaces: false  # Nicht verfügbar unter Windows
  max_cpu_seconds: 300
  max_memory_mb: 512

Für vollständige Namespace-Sandbox-Isolation verwenden Sie WSL2 (siehe unten).

WSL2 für volle Sandbox-Funktionen

Windows Subsystem for Linux 2 (WSL2) bietet einen echten Linux-Kernel unter Windows und ermöglicht YeePilots vollständige Namespace-Sandbox mit User-, PID-, Mount- und Netzwerk-Isolation.

WSL2 installieren

Falls Sie WSL2 nicht installiert haben:

wsl --install

Dies installiert WSL2 mit Ubuntu als Standard. Starten Sie Ihren Computer neu, wenn Sie dazu aufgefordert werden.

YeePilot in WSL2 installieren

Öffnen Sie Ihr WSL2-Terminal und installieren Sie YeePilot mit dem Linux-Installationsskript:

curl -fsSL https://yee.to/install.sh | bash

Innerhalb von WSL2 hat YeePilot Zugriff auf den vollen Linux-Funktionsumfang:

• Vollständige Namespace-Sandbox-Isolation
• GNOME-Keyring-Zugangsdatenspeicherung (wenn konfiguriert)
• Manipulationserkennbare Audit-Protokollierung mit Hash-Ketten

Auf Windows-Dateien von WSL2 aus zugreifen

Ihre Windows-Laufwerke sind unter /mnt/ in WSL2 eingebunden:

# Auf Ihr Windows-Heimverzeichnis zugreifen
ls /mnt/c/Users/IhrName/
 
# YeePilot auf Windows-gehostete Dateien ausführen
yeepilot run

Wann WSL2 vs. natives Windows verwenden

YeePilot als Dienst ausführen

Wenn Sie möchten, dass YeePilots automatische Update-Prüfungen im Hintergrund laufen, können Sie den Windows-Aufgabenplaner verwenden. Für die meisten Benutzer reicht jedoch die automatische Update-Prüfung beim Start aus.

Aktualisierung

Nach Updates suchen und installieren:

yeepilot update

Oder nur prüfen, ohne zu installieren:

yeepilot update --check

Um manuell zu aktualisieren, laden Sie die neue Binärdatei von der Release-Seite herunter und ersetzen Sie die vorhandene yeepilot.exe-Datei.

Deinstallation

YeePilot und alle Daten entfernen:

yeepilot uninstall --all

Oder nur die Binärdatei entfernen:

yeepilot uninstall --binary-only

Für manuelle Entfernung:

1. Binärdatei löschen: C:\Program Files\YeePilot\yeepilot.exe
2. Konfigurationsverzeichnis löschen: %USERPROFILE%\.yeepilot\
3. C:\Program Files\YeePilot aus Ihrem PATH entfernen.

Wenn Sie auch in WSL2 installiert haben, deinstallieren Sie separat innerhalb des WSL2-Terminals:

yeepilot uninstall --all