Dropstone CLI

Dépannage

Problèmes courants et comment les résoudre.

Pour déboguer les problèmes avec Dropstone, commencez par vérifier les journaux et les données locales qu'il stocke sur le disque.

Journaux

Les fichiers journaux sont écrits dans :

  • macOS / Linux : ~/.local/share/dropstone/log/
  • Windows : appuyez sur WIN+R et collez %USERPROFILE%\.local\share\dropstone\log

Les fichiers journaux sont nommés avec des horodatages (par exemple 2026-05-23T123456.log) et les 10 fichiers journaux les plus récents sont conservés.

Vous pouvez définir le niveau de journalisation avec l'option de ligne de commande --log-level pour obtenir une sortie de débogage plus détaillée :

dropstone --log-level DEBUG

--print-logs diffuse également les journaux sur stderr en temps réel :

dropstone --print-logs

Stockage

Dropstone stocke les données de session et d'autres données d'application sur le disque à :

  • macOS / Linux : ~/.local/share/dropstone/
  • Windows : appuyez sur WIN+R et collez %USERPROFILE%\.local\share\dropstone

Ce répertoire contient :

  • auth.json : Informations d'authentification
  • log/ : Journaux d'application
  • project/ : Données spécifiques au projet comme l'historique des sessions
    • Si le projet se trouve dans un dépôt Git, il est stocké dans ./<project-slug>/storage/
    • Sinon, il est stocké dans ./global/storage/

Problèmes courants

Dropstone ne démarre pas

  1. Vérifiez les journaux pour un message d'erreur.
  2. Essayez d'exécuter avec --print-logs pour diffuser les journaux sur stderr.
  3. Assurez-vous d'être sur la dernière version : dropstone update.

S'il se termine instantanément sans rien afficher du tout sur macOS, il s'agit d'une autre défaillance — voir Tué au lancement sur macOS.

Tué au lancement sur macOS

Sur Apple Silicon, Dropstone 1.0.50 a été tué par macOS avant d'afficher quoi que ce soit, donc chaque commande ressemblait à ceci :

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

Il n'y a aucun journal à lire ni aucune erreur à rechercher : le processus est arrêté avant de démarrer, c'est pourquoi --print-logs et dropstone upgrade sont également tués. macOS valide la signature du binaire avant de l'exécuter, et celle apposée sur cette version ne correspondait pas. macOS jusqu'à 26 l'a toléré ; macOS 27 ne le tolère pas. Windows et Linux n'ont jamais été affectés.

Pour le confirmer avant de réinstaller :

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

Ensuite, remplacez le binaire. Homebrew et l'installateur fonctionnent tous deux sans que la copie installée ne s'exécute :

# Homebrew
brew update && brew upgrade dropstone

# L'installateur en une ligne
curl -fsSL https://dropstone.io/install.sh | bash

Pour débloquer la copie que vous avez déjà au lieu de réinstaller :

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

Les versions 1.0.51 et ultérieures sont signées d'une manière acceptée par macOS, et chaque version vérifie cette signature avant d'être publiée.

Problèmes d'authentification

Si la connexion ou la validation du jeton échoue :

  1. Relancez dropstone et connectez-vous à nouveau via le flux du navigateur.
  2. Si vous êtes dans un environnement sans interface graphique, définissez DROPSTONE_API_KEY à partir d'un jeton émis sur dropstone.io/account.
  3. Confirmez que votre réseau autorise les connexions HTTPS sortantes vers dropstone.io. Si vous êtes derrière un proxy d'entreprise, consultez Réseau.

Modèle introuvable

Si vous voyez ModelNotFoundError, vous référencez probablement un ID de modèle qui n'existe pas. Utilisez l'un des suivants :

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

Exécutez dropstone models pour confirmer ce qui est disponible pour votre compte.

Erreur d'initialisation

Si vous voyez une InitError au lancement, vos informations d'identification stockées peuvent être invalides ou corrompues.

  1. Effacez vos données stockées :

    rm -rf ~/.local/share/dropstone

    Sur Windows : appuyez sur WIN+R et supprimez %USERPROFILE%\.local\share\dropstone.

  2. Relancez dropstone et connectez-vous à nouveau.

Erreurs d'appel API

Si vous voyez des erreurs d'appel API pendant une session, le cache sur disque peut être obsolète.

  1. Effacez le cache :

    rm -rf ~/.cache/dropstone

    Sur Windows : appuyez sur WIN+R et supprimez %USERPROFILE%\.cache\dropstone.

  2. Redémarrez Dropstone.

Copier / coller ne fonctionne pas sur Linux

Les utilisateurs Linux doivent installer l'un des utilitaires de presse-papiers suivants pour que le copier/coller fonctionne :

X11

apt install -y xclip
# ou
apt install -y xsel

Wayland

apt install -y wl-clipboard

Sans interface graphique

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

Dropstone préfère wl-clipboard sur Wayland et revient à xclip puis xsel sur X11.

Windows : Problèmes de performances générales

Si vous rencontrez des performances lentes, des problèmes d'accès aux fichiers ou des anomalies du terminal sur Windows natif, passez à WSL. WSL vous offre un environnement Linux qui exécute Dropstone avec la vitesse native du système de fichiers et un support complet du terminal.

Obtenir de l'aide

Ctrl+I