DocsAnleitungenUpdates & Fehlerbehebung
Zurück zur Doku
Anleitungen

Updates & Fehlerbehebung

YeePilot sicher aktualisieren, Release-Kanäle verstehen und typische Probleme mit Provider, Auth, Vault und Sandbox beheben.

Zuletzt aktualisiert: 12. Mai 2026

Zuerst die aktuelle Version prüfen

Bevor Sie ein Updateproblem suchen:

bash
yeepilot version
yeepilot status

Normale Update-Befehle

Verfügbarkeit prüfen, ohne zu installieren:

bash
yeepilot update --check

Neueste verfügbare Version für Ihren Kanal installieren:

bash
yeepilot update

Neuinstallation erzwingen:

bash
yeepilot update --force

Auf die zuletzt installierte Binärdatei zurückrollen:

bash
yeepilot update --rollback

Update-Kanäle

YeePilot unterstützt:

  • public
  • canary

Beispiel:

yaml
update:
  auto_check: true
  check_interval_hours: 1
  channel: public
  channel_token: ""

Für geschützte Canary-Nutzung werden typischerweise beide Werte benötigt:

  • update.channel: canary
  • update.channel_token: <token>

Per Umgebungsvariable:

  • YEEPILOT_UPDATE_CHANNEL
  • YEEPILOT_UPDATE_CHANNEL_TOKEN

Automatische Update-Prüfung

Ein- oder ausschalten:

yaml
update:
  auto_check: true
  check_interval_hours: 1

Mit größerem Intervall prüfen Sie seltener.

Diagnostics- und Support-Befehle

YeePilot enthält Endnutzer-Werkzeuge für Diagnosefälle:

bash
yeepilot diagnostics pending
yeepilot diagnostics report-last

Zusätzlich können Sie einen manuellen, redigierten Support-Report senden:

bash
yeepilot support report --message "Beschreiben Sie das Problem"

Nützliche Flags sind:

  • --title
  • --context
  • --severity
  • --include-debug-log

Häufige Probleme

Provider- oder Modellfehler

Prüfen Sie:

  1. ob der Anbieter korrekt ist
  2. ob das Modell wirklich zu diesem Anbieter gehört
  3. ob der API-Schlüssel gültig ist
  4. ob Ihr Konto Zugriff auf das Modell hat

Schneller Einzelsystemtest:

bash
yeepilot exec --provider openai --model gpt-4o "health check"

Plattform-Login oder Gerätezugang

Auth-Verwaltung erneut starten:

bash
yeepilot setup --auth

Danach erneut prüfen mit:

bash
yeepilot status

Sandbox-Probleme

Aktuellen Zustand in der Sitzung prüfen:

text
/sandbox status

Wenn die Aufgabe wirklich Netzwerk, deaktivierte Namespaces oder höhere Limits braucht, ändern Sie nur den kleinsten nötigen Schalter.

Vault-Probleme

Vault-Status prüfen:

bash
yeepilot vault status

Entsperren testen:

bash
yeepilot vault unlock --method password

Recovery Key bei Bedarf rotieren:

bash
yeepilot vault rotate-recovery --unlock-method password

Konfigurations-Drift

Wenn die Konfiguration stark beschädigt oder uneinheitlich wirkt:

bash
yeepilot setup --reset

Das erzeugt die Hauptkonfiguration neu und führt Sie erneut durch das Setup.

Gute Reihenfolge zur Eingrenzung

Wenn YeePilot "kaputt" wirkt, gehen Sie in dieser Reihenfolge vor:

  1. yeepilot version
  2. yeepilot status
  3. yeepilot setup --auth
  4. Provider- und Modellwerte prüfen
  5. einen einfachen yeepilot exec-Test ausführen
  6. Diagnostics prüfen und falls nötig Support-Report senden

So trennen Sie Update-, Auth-, Provider- und lokale Konfigurationsprobleme meist sehr schnell voneinander.