Dropstone Docs

Fehlerbehebung

Häufige Probleme und deren Lösungen.

Um Probleme mit Dropstone zu beheben, überprüfen Sie zunächst die Protokolle und lokalen Daten, die auf der Festplatte gespeichert sind.

Protokolle

Protokolldateien werden geschrieben in:

  • macOS / Linux: ~/.local/share/dropstone/log/
  • Windows: Drücken Sie WIN+R und fügen Sie %USERPROFILE%\.local\share\dropstone\log ein

Protokolldateien werden mit Zeitstempeln benannt (z. B. 2026-05-23T123456.log) und die 10 neuesten Protokolldateien werden beibehalten.

Sie können die Protokollebene mit der Befehlszeilenoption --log-level für detaillierte Debug-Ausgabe festlegen:

dropstone --log-level DEBUG

--print-logs streamt auch Protokolle in Echtzeit zu stderr:

dropstone --print-logs

Speicher

Dropstone speichert Sitzungsdaten und andere Anwendungsdaten auf der Festplatte unter:

  • macOS / Linux: ~/.local/share/dropstone/
  • Windows: Drücken Sie WIN+R und fügen Sie %USERPROFILE%\.local\share\dropstone ein

Dieses Verzeichnis enthält:

  • auth.json: Authentifizierungsdaten
  • log/: Anwendungsprotokolle
  • project/: Projektspezifische Daten wie Sitzungsverlauf
    • Wenn sich das Projekt in einem Git-Repository befindet, wird es in ./<project-slug>/storage/ gespeichert
    • Andernfalls wird es in ./global/storage/ gespeichert

Häufige Probleme

Dropstone startet nicht

  1. Überprüfen Sie die Protokolle auf eine Fehlermeldung.
  2. Versuchen Sie, mit --print-logs auszuführen, um Protokolle zu stderr zu streamen.
  3. Stellen Sie sicher, dass Sie die neueste Version haben: dropstone update.

Authentifizierungsprobleme

Wenn die Anmeldung oder Tokenvalidierung fehlschlägt:

  1. Führen Sie dropstone erneut aus und melden Sie sich über den Browser-Flow an.
  2. Wenn Sie sich in einer Headless-Umgebung befinden, setzen Sie DROPSTONE_API_KEY von einem Token, der unter dropstone.io/account ausgestellt wurde.
  3. Bestätigen Sie, dass Ihr Netzwerk ausgehende HTTPS-Verbindungen zu dropstone.io zulässt. Wenn Sie sich hinter einem Unternehmens-Proxy befinden, siehe Network.

Modell nicht gefunden

Wenn Sie ModelNotFoundError sehen, verweisen Sie wahrscheinlich auf eine Modell-ID, die nicht existiert. Verwenden Sie eine der folgenden:

  • dropstone/dropstone-fast
  • dropstone/dropstone-pro
  • dropstone/dropstone-heavy

Führen Sie dropstone models aus, um zu bestätigen, was für Ihr Konto verfügbar ist.

Initialisierungsfehler

Wenn Sie beim Start einen InitError sehen, können Ihre gespeicherten Anmeldedaten ungültig oder beschädigt sein.

  1. Löschen Sie Ihre gespeicherten Daten:

    rm -rf ~/.local/share/dropstone

    Unter Windows: Drücken Sie WIN+R und löschen Sie %USERPROFILE%\.local\share\dropstone.

  2. Führen Sie dropstone erneut aus und melden Sie sich an.

API-Aufrufffehler

Wenn während einer Sitzung API-Aufrufffehler auftreten, kann der On-Disk-Cache veraltet sein.

  1. Löschen Sie den Cache:

    rm -rf ~/.cache/dropstone

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

  2. Starten Sie Dropstone neu.

Kopieren / Einfügen funktioniert nicht unter Linux

Linux-Benutzer benötigen eines der folgenden Clipboard-Dienstprogramme, damit Kopieren/Einfügen funktioniert:

X11

apt install -y xclip
# oder
apt install -y xsel

Wayland

apt install -y wl-clipboard

Headless

apt install -y xvfb
# dann
Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
export DISPLAY=:99.0

Dropstone bevorzugt wl-clipboard auf Wayland und fällt auf xclip und dann xsel auf X11 zurück.

Windows: Allgemeine Leistungsprobleme

Wenn Sie langsame Leistung, Dateizugriffsprobleme oder Terminal-Störungen unter nativem Windows feststellen, wechseln Sie zu WSL. WSL bietet Ihnen eine Linux-Umgebung, in der Dropstone mit nativer Dateisystem-Geschwindigkeit und vollständiger Terminal-Unterstützung ausgeführt wird.

Hilfe erhalten

Strg+I