Dropstone Docs

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 vers stderr en temps réel :

dropstone --print-logs

Stockage

Dropstone stocke les données de session et 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 : Identifiants 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 vers stderr.
  3. Assurez-vous que vous êtes sur la dernière version : dropstone update.

Problèmes d'authentification

Si la connexion ou la validation du jeton échoue :

  1. Réexécutez 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 Network.

Modèle non trouvé

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

  • 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 identifiants stockés peuvent être invalides ou corrompus.

  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. Réexécutez 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 de Linux ont besoin de l'un des utilitaires de presse-papiers suivants installés 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 performance générale

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

Obtenir de l'aide

Ctrl+I