Dropstone Docs

Risoluzione dei problemi

Problemi comuni e come risolverli.

Per eseguire il debug dei problemi con Dropstone, inizia controllando i log e i dati locali che memorizza su disco.

Log

I file di log vengono scritti in:

  • macOS / Linux: ~/.local/share/dropstone/log/
  • Windows: premi WIN+R e incolla %USERPROFILE%\.local\share\dropstone\log

I file di log sono denominati con timestamp (ad esempio 2026-05-23T123456.log) e vengono conservati i 10 file di log più recenti.

Puoi impostare il livello di log con l'opzione della riga di comando --log-level per un output di debug più dettagliato:

dropstone --log-level DEBUG

--print-logs trasmette anche i log a stderr in tempo reale:

dropstone --print-logs

Archiviazione

Dropstone memorizza i dati della sessione e altri dati dell'applicazione su disco in:

  • macOS / Linux: ~/.local/share/dropstone/
  • Windows: premi WIN+R e incolla %USERPROFILE%\.local\share\dropstone

Questa directory contiene:

  • auth.json: Credenziali di autenticazione
  • log/: Log dell'applicazione
  • project/: Dati specifici del progetto come la cronologia della sessione
    • Se il progetto si trova all'interno di un repository Git, viene memorizzato in ./<project-slug>/storage/
    • Altrimenti viene memorizzato in ./global/storage/

Problemi comuni

Dropstone non si avvia

  1. Controlla i log per un messaggio di errore.
  2. Prova a eseguire con --print-logs per trasmettere i log a stderr.
  3. Assicurati di essere sulla versione più recente: dropstone update.

Problemi di autenticazione

Se l'accesso o la convalida del token non riesce:

  1. Esegui di nuovo dropstone e accedi tramite il flusso del browser.
  2. Se sei in un ambiente headless, imposta DROPSTONE_API_KEY da un token emesso su dropstone.io/account.
  3. Conferma che la tua rete consente il traffico HTTPS in uscita verso dropstone.io. Se sei dietro un proxy aziendale, vedi Network.

Modello non trovato

Se vedi ModelNotFoundError, probabilmente stai facendo riferimento a un ID modello che non esiste. Usa uno di:

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

Esegui dropstone models per confermare cosa è disponibile per il tuo account.

Errore di inizializzazione

Se vedi un InitError all'avvio, le tue credenziali memorizzate potrebbero essere non valide o corrotte.

  1. Cancella i dati memorizzati:

    rm -rf ~/.local/share/dropstone

    Su Windows: premi WIN+R e elimina %USERPROFILE%\.local\share\dropstone.

  2. Esegui di nuovo dropstone e accedi.

Errori di chiamata API

Se vedi errori di chiamata API durante una sessione, la cache su disco potrebbe essere obsoleta.

  1. Cancella la cache:

    rm -rf ~/.cache/dropstone

    Su Windows: premi WIN+R e elimina %USERPROFILE%\.cache\dropstone.

  2. Riavvia Dropstone.

Copia / incolla non funziona su Linux

Gli utenti Linux hanno bisogno di una delle seguenti utility degli appunti installate per far funzionare copia/incolla:

X11

apt install -y xclip
# o
apt install -y xsel

Wayland

apt install -y wl-clipboard

Headless

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

Dropstone preferisce wl-clipboard su Wayland e ricade su xclip quindi xsel su X11.

Windows: Problemi generali di prestazioni

Se riscontri prestazioni lente, problemi di accesso ai file o glitch del terminale su Windows nativo, passa a WSL. WSL ti offre un ambiente Linux che esegue Dropstone con velocità del filesystem nativa e supporto completo del terminale.

Ottenere aiuto

Ctrl+I