Anleitungen

Updates & Fehlerbehebung

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

Zuletzt aktualisiert: 21. Juni 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

YeePilot verifiziert öffentliche Updates, bevor die installierte Binärdatei ersetzt wird. Wenn die Verifizierung fehlschlägt, wird das Update nicht übernommen und YeePilot versucht, bei der vorherigen Version zu bleiben oder dorthin zurückzurollen.

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.

Beim Start kann YeePilot einen Hinweis anzeigen, wenn für Ihren aktuellen Kanal eine neuere Version verfügbar ist. Die eigentliche Installation starten Sie weiterhin bewusst mit yeepilot update.

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

Zum Abmelden von der Plattform:

bash
yeepilot logout

yeepilot logout und, im interaktiven Client, /logout melden Sie nur von der YeePilot-Plattform ab. Provider-Schlüssel und Vault-Einträge bleiben separat verwaltet und werden dadurch nicht automatisch gelöscht.

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.

Zurück

Best Practices

Guides