Dropstone CLI

Fehlerbehebung

Häufige Probleme und wie Sie sie lösen.

Um Probleme mit Dropstone zu debuggen, prüfen Sie zunächst die Logs und die lokalen Daten, die es auf der Festplatte speichert.

Logs

Logdateien werden geschrieben nach:

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

Logdateien sind mit Zeitstempeln benannt (z. B. 2026-05-23T123456.log) und die letzten 10 Logdateien werden aufbewahrt.

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

dropstone --log-level DEBUG

--print-logs streamt Logs außerdem in Echtzeit an stderr:

dropstone --print-logs

Speicherung

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/: Anwendungslogs
  • project/: Projektspezifische Daten wie Sitzungsverlauf
    • Wenn sich das Projekt in einem Git-Repository befindet, wird es unter ./<project-slug>/storage/ gespeichert
    • Andernfalls wird es unter ./global/storage/ gespeichert

Häufige Probleme

Dropstone startet nicht

  1. Prüfen Sie die Logs auf eine Fehlermeldung.
  2. Versuchen Sie, mit --print-logs auszuführen, um Logs an stderr zu streamen.
  3. Stellen Sie sicher, dass Sie die neueste Version verwenden: dropstone update.

Wenn es auf macOS sofort beendet wird, ohne dass etwas ausgegeben wird, handelt es sich um einen anderen Fehler – siehe Wird beim Start auf macOS beendet.

Wird beim Start auf macOS beendet

Auf Apple Silicon wurde Dropstone 1.0.50 von macOS beendet, bevor es etwas ausgeben konnte, sodass jeder Befehl so aussah:

dropstone --version
# zsh: killed     dropstone --version

Es gibt kein Log zum Lesen und keinen Fehler zum Suchen: Der Prozess wird gestoppt, bevor er startet, weshalb auch --print-logs und dropstone upgrade beendet werden. macOS validiert die Signatur der Binärdatei, bevor es sie ausführt, und die in diesem Build eingestempelte Signatur stimmte nicht überein. macOS bis 26 tolerierte dies; macOS 27 nicht. Windows und Linux waren nie betroffen.

Um dies vor der Neuinstallation zu bestätigen:

codesign --verify --verbose=4 "$(readlink -f "$(which dropstone)")"
# /opt/homebrew/bin/dropstone: invalid signature (code or signature have been modified)

Ersetzen Sie dann die Binärdatei. Homebrew und der Installer funktionieren beide, ohne dass die installierte Kopie ausgeführt wird:

# Homebrew
brew update && brew upgrade dropstone

# Der Einzeiler-Installer
curl -fsSL https://dropstone.io/install.sh | bash

Um die bereits vorhandene Kopie freizuschalten, anstatt sie neu zu installieren:

codesign --force --sign - "$(readlink -f "$(which dropstone)")"

1.0.51 und spätere Versionen sind so signiert, dass macOS sie akzeptiert, und jede Veröffentlichung prüft diese Signatur, bevor sie veröffentlicht wird.

Authentifizierungsprobleme

Wenn die Anmeldung oder Token-Validierung fehlschlägt:

  1. Führen Sie dropstone erneut aus und melden Sie sich über den Browser-Flow erneut an.
  2. Wenn Sie sich in einer headless Umgebung befinden, setzen Sie DROPSTONE_API_KEY mit einem Token, das unter dropstone.io/account ausgestellt wurde.
  3. Stellen Sie sicher, dass Ihr Netzwerk ausgehendes HTTPS zu dropstone.io erlaubt. Wenn Sie sich hinter einem Unternehmensproxy befinden, siehe Netzwerk.

Modell nicht gefunden

Wenn Sie ModelNotFoundError sehen, referenzieren Sie wahrscheinlich eine Modell-ID, die nicht existiert. Verwenden Sie eines von:

  • 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, sind Ihre gespeicherten Anmeldedaten möglicherweise ungültig oder beschädigt.

  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 erneut an.

API-Aufruffehler

Wenn Sie während einer Sitzung API-Aufruffehler sehen, ist der On-Disk-Cache möglicherweise veraltet.

  1. Leeren 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 unter Linux nicht

Linux-Benutzer benötigen eines der folgenden Zwischenablage-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 Terminalfehler unter nativem Windows feststellen, wechseln Sie zu WSL. WSL bietet Ihnen eine Linux-Umgebung, in der Dropstone mit nativer Dateisystemgeschwindigkeit und vollständiger Terminalunterstützung läuft.

Hilfe erhalten

Strg+I