Dropstone CLI

Fehlerbehebungsleitfaden

Diagnostizieren Sie Dropstone CLI-Probleme systematisch. Sammeln Sie die richtigen Informationen, finden Sie die Protokolle und isolieren Sie die Ursache, bevor Sie den Support kontaktieren.

Die meisten Probleme lassen sich auf eine von vier Ursachen zurückführen: einen alten Build, einen veralteten Cache, ungültige Anmeldedaten oder das Netzwerk. Diese Seite zeigt die Reihenfolge, in der Sie diese prüfen sollten, und was Sie sammeln müssen, wenn keiner dieser Punkte zutrifft.

Für eine spezifische Fehlermeldung beginnen Sie stattdessen mit Häufige Probleme. Für Laufzeitverhalten und feature-spezifische Fehlerbehebung finden Sie weitere Informationen unter CLI-Fehlerbehebung.

Die ersten drei Dinge, die Sie ausprobieren sollten

Führen Sie diese Schritte vor allem anderen aus. Sie lösen einen überraschend großen Anteil der gemeldeten Probleme.

# 1. Aktuellen Stand holen
dropstone update

# 2. Sehen, was Dropstone tatsächlich tut
dropstone --log-level DEBUG --print-logs
  1. Wenn der Fehler mitten in einer Sitzung auftritt und die Ursache unklar ist, leeren Sie den Cache und starten Sie neu:
rm -rf ~/.cache/dropstone

Unter Windows drücken Sie WIN+R und löschen %USERPROFILE%\.cache\dropstone.

Bevor Sie etwas anderes löschen

Die drei oben genannten Befehle sind sicher. Das Löschen von ~/.local/share/dropstone ist es nicht – dort befinden sich Ihre Anmeldedaten und der Sitzungsverlauf. Lesen Sie Wo Daten gespeichert werden, bevor Sie dieses Verzeichnis entfernen.

Wo Daten gespeichert werden

Alles, was Dropstone auf der Festplatte speichert, befindet sich in zwei Verzeichnissen.

WasmacOS / LinuxWindows
Anmeldedaten und Sitzungen~/.local/share/dropstone/%USERPROFILE%\.local\share\dropstone
Protokolle~/.local/share/dropstone/log/%USERPROFILE%\.local\share\dropstone\log
Cache~/.cache/dropstone/%USERPROFILE%\.cache\dropstone

Im Datenverzeichnis:

  • auth.json – Ihre Anmeldedaten. Löschen Sie diese Datei nur, um eine saubere Anmeldung zu erzwingen.
  • log/ – Zeitgestempelte Protokolle. Die zehn neuesten werden aufbewahrt.
  • project/ – Sitzungsverlauf, pro Projekt getrennt.

Eine Protokolldatei ist nach dem Zeitpunkt ihrer Erstellung benannt, z. B. 2026-05-23T123456.log. Die neueste Datei ist die, die Sie benötigen.

Ein Protokoll erhalten, das lesenswert ist

Standardmäßig ist die Protokollebene ruhig. Zwei Flags ändern das:

# Detaillierte Ausgabe in die Protokolldatei geschrieben
dropstone --log-level DEBUG

# Dieselbe Ausgabe wird live in Ihr Terminal gestreamt
dropstone --print-logs

Verwenden Sie beide zusammen, wenn Sie den Fehler live beobachten möchten und danach trotzdem die Datei benötigen.

Wenn das Problem ein Absturz beim Start ist, hilft --print-logs: Die Protokolldatei wird möglicherweise gar nicht geschrieben, bevor der Prozess endet, aber stderr ist immer vorhanden.

Was Sie in einen Bericht aufnehmen sollten

Ein Bericht mit diesen fünf Punkten benötigt in der Regel nur eine Antwort zur Lösung. Ein Bericht ohne sie benötigt meist vier.

  1. Den genauen Befehl, den Sie ausgeführt haben. Keine Paraphrase – die wörtliche Zeile, einschließlich Flags.

  2. Was Sie erwartet haben und was passiert ist. Beide Teile. „Es ist fehlgeschlagen" grenzt nichts ein.

  3. Ihre Version und Plattform.

    dropstone --version

    Plus Ihr Betriebssystem und dessen Version, sowie ob Sie natives Windows oder WSL verwenden.

  4. Den relevanten Protokollauszug. Ein paar Zeilen auf beiden Seiten des Fehlers, nicht die gesamte Datei. Schwärzen Sie alles Vertrauliche – Sitzungsprotokolle können Dateipfade und Code enthalten.

  5. Ob das Problem reproduzierbar ist. Immer, manchmal oder einmal. „Manchmal" ist erwähnenswert; es deutet auf Timing oder Zustand hin, nicht auf eine fehlerhafte Eingabe.

Senden Sie es an dropstone.io/contact.

Eingrenzen

Wenn die Ursache immer noch nicht offensichtlich ist, eliminieren Sie Variablen eine nach der anderen. Jede dieser Maßnahmen entfernt eine ganze Kategorie.

Liegt es am Projekt? Führen Sie Dropstone in einem leeren Verzeichnis aus. Wenn es dort funktioniert, ist das Problem projektspezifisch – wahrscheinlich eine Konfigurationsdatei, eine Regeln-Datei oder etwas im Repository, das der Agent liest.

Liegt es an Ihrer Konfiguration? Verschieben Sie vorübergehend dropstone.json beiseite und starten Sie neu. Siehe Konfiguration für den Speicherort der globalen und Projekt-Konfigurationsdateien.

Liegt es an einem MCP-Server? Ein Server, der beim Start hängt, kann die gesamte Sitzung blockieren. Listen Sie sie auf und deaktivieren Sie sie, dann aktivieren Sie sie einzeln wieder:

dropstone mcp list

Liegt es am Netzwerk? Unternehmensproxys sind die häufigste Ursache für Fehler, die wie etwas anderes aussehen. Prüfen Sie:

curl -I https://dropstone.io

Wenn das fehlschlägt oder etwas Unerwartetes zurückgibt, siehe Netzwerk und Proxy. Die übliche Lösung ist das Setzen von HTTPS_PROXY und, wichtig, NO_PROXY=localhost,127.0.0.1 – Dropstone verwendet während interaktiver Sitzungen eine lokale Loopback-Verbindung, und das Weiterleiten über einen Proxy verursacht eine Schleife.

Liegt es an Ihren Anmeldedaten? Melden Sie sich ab und wieder an:

dropstone auth logout
dropstone auth login

Liegt es am Terminal? Unter Linux benötigen Kopieren und Einfügen ein installiertes Zwischenablage-Dienstprogramm. Siehe CLI-Fehlerbehebung.

Liegt es an Windows? Langsamer Dateizugriff, Terminal-Probleme und Pfadprobleme unter nativem Windows verschwinden normalerweise unter WSL. Siehe Windows und WSL.

Bevor Sie den Support kontaktieren

Verwandte Themen

Strg+I