Erst diagnostizieren
lurus doctor
lurus status
lurus update --check
lurus doctor prüft die Umgebung auch ohne Anmeldung. lurus status zeigt Anmeldequelle, Profil und Proxyinformationen. Im Chat stehen /doctor, /status, /stats und /cost zur Verfügung; sie reparieren Probleme nicht automatisch. update --check prüft die Version und kann den Updatecache schreiben. lurus update installiert eine neuere Version global über npm; Entwicklungsbuilds führen keine Installation aus. Prüfen Sie die Meldungen, da behandelte Anmelde- oder Updatefehler nicht immer mit Exitcode 1 enden.
Authquelle und Logout
Achtung: logout entfernt gespeicherte Zugangsdaten; logout --all versucht zusätzlich, alle JWT-Sitzungen serverseitig abzumelden. API-Schlüssel werden dadurch nicht widerrufen.
lurus login
lurus login --email
lurus login --api-key
lurus register
lurus logout
lurus logout --all
Standardmäßig melden Sie sich über den Browser mit einem Gerätecode an. E-Mail und API-Schlüssel werden alternativ interaktiv eingegeben. Die Flags benötigen keinen Wert; übergeben Sie weder Schlüssel noch Passwort als Argument. Wenn beide Flags gesetzt sind, wird die API-Schlüssel-Eingabe verwendet. Auch die Registrierung erfolgt über den Browser, nicht mit einem Passwort als CLI-Argument.
Ein nach dem Entfernen umgebender Leerzeichen nichtleerer LURUS_API_KEY hat Vorrang vor gespeicherten API-Schlüsseln oder JWT-Zugangsdaten. Ein ungültiger Wert führt zu einem Fehler statt zum Rückgriff auf die lokale Anmeldung. Prüfen Sie bei einem unerwarteten Konto die von status gemeldete Quelle; geben Sie keine tatsächlichen Schlüssel aus.
logout löscht gespeicherte Zugangsdaten. Bei einer JWT-Anmeldung versucht es zusätzlich, die Sitzung serverseitig abzumelden; mit --all betrifft dies alle Sitzungen. Ein gespeicherter API-Schlüssel wird dadurch nicht serverseitig widerrufen, und Umgebungsvariablen bleiben bestehen. Eine Erfolgsmeldung beweist nicht den erfolgreichen Serverwiderruf. Widerrufen oder ersetzen Sie kompromittierte Schlüssel im Kontomanagement, statt nur logout auszuführen.
Unternehmensproxy und TLS
Unterstützt werden HTTP_PROXY, HTTPS_PROXY und NO_PROXY sowie ihre kleingeschriebenen Varianten. Die Kleinschreibung hat Vorrang. NO_PROXY akzeptiert durch Kommas oder Leerraum getrennte Einträge; Loopbackadressen werden ebenfalls berücksichtigt. Binden Sie vertrauenswürdige Unternehmenszertifikate über NODE_EXTRA_CA_CERTS ein, statt die Zertifikatsprüfung zu deaktivieren. Proxy-URLs können Zugangsdaten enthalten: Teilen Sie nur bereinigte Diagnoseinformationen. Allgemeine Fehlersuche erfordert nicht das Lesen von .env-Dateien, Zertifikaten oder Zugangsdatenstores.
Konfiguration und Erweiterungen
| Symptom | Prüfung |
|---|---|
| Einstellungen ignoriert | Prüfen Sie Projektverzeichnis, JSON, Geltungsbereich, Zustimmung und Neustart gemäß Einstellungen. /config lädt nicht neu. |
| Projektindexierung nach Neustart wieder aktiv | Der Projektwert wird nicht übernommen. Verwenden Sie die globale Deaktivierung oder Kontooption. |
| Befehl fehlt | Prüfen Sie den aus dem Pfad gebildeten Namen und Kollisionen mit eingebauten Befehlen. Starten Sie neu; es gibt keinen Reloadbefehl. |
| Agent nicht freigegeben | Prüfen Sie Quelle, Pfad, Dateiänderungen und Neustart. Beachten Sie die Hinweise zu Agentfreigaben. |
| Skill inaktiv | Laden Sie mit /skills neu. Prüfen Sie Quellenfreigabe, Sperren eingebauter Skills und Dateimuster. |
| Hook blockiert nicht | Prüfen Sie Event, Matcher, Exitcode und JSON-Ausgabe. Hookfehler lassen die Aktion weiterlaufen; nachträgliche Events sind kein Undo. |
| MCP-Tools fehlen | Prüfen Sie Zustimmung, Geltungsbereich, Startbefehl, Verzeichnis, Timeout und exakte Filternamen. Unterscheiden Sie Neustart und refresh-tools. |
| Kindprozess erhält Variable nicht | Geben Sie gezielt Namen über *_PASS_ENV frei, statt die gesamte Umgebung weiterzureichen. |
Reports und beschädigte Stores
Achtung: Reports können gleichnamige Dateien ohne zusätzlichen Dialog überschreiben. Der HTML-Report lädt beim Öffnen eine externe Diagrammbibliothek. Prüfen Sie die Inhalte vor der Weitergabe.
/report
/report --json diagnostics.json
/permissions
Reports enthalten Metadaten und Zähler, kein vollständiges Transkript. HTML wird als lurus-report.html gespeichert; für JSON gilt der angegebene Dateiname im aktuellen Verzeichnis.
Reparatur nur bei beschädigten Berechtigungs- oder Freigabedaten: /permissions repair und /permissions repair trust sichern die beschädigten Daten und setzen gespeicherte Freigaben für alle Projekte zurück. Die Bestätigung ist mit Nein vorbelegt. Das ist keine normale Bereinigung; löschen Sie Stores nicht von Hand. Für gezielten Widerruf verwenden Sie die Berechtigungsverwaltung.