Dropstone CLI

Risoluzione dei problemi

Problemi comuni e come risolverli.

Per diagnosticare i problemi con Dropstone, inizia controllando i log e i dati locali che salva 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 nominati 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 da 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 salva i dati delle sessioni 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 delle sessioni
    • Se il progetto si trova in un repository Git, viene salvato in ./<project-slug>/storage/
    • Altrimenti viene salvato 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 sull'ultima versione: dropstone update.

Se si chiude immediatamente senza stampare nulla su macOS, si tratta di un errore diverso — consulta Terminato all'avvio su macOS.

Terminato all'avvio su macOS

Su Apple Silicon, Dropstone 1.0.50 veniva terminato da macOS prima di stampare qualsiasi cosa, quindi ogni comando appariva così:

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

Non c'è alcun log da leggere né alcun errore da cercare: il processo viene interrotto prima di avviarsi, motivo per cui anche --print-logs e dropstone upgrade vengono terminati. macOS verifica la firma sul binario prima di eseguirlo, e quella apposta su quella build non corrispondeva. macOS fino alla versione 26 lo tollerava; macOS 27 no. Windows e Linux non sono mai stati interessati.

Per confermarlo prima di reinstallare:

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

Poi sostituisci il binario. Homebrew e l'installer funzionano entrambi senza che la copia installata venga eseguita:

# Homebrew
brew update && brew upgrade dropstone

# Installer a riga singola
curl -fsSL https://dropstone.io/install.sh | bash

Per sbloccare la copia che hai già invece di reinstallare:

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

Le versioni 1.0.51 e successive sono firmate in un modo che macOS accetta, e ogni release verifica quella firma prima di essere pubblicata.

Problemi di autenticazione

Se l'accesso o la validazione del token fallisce:

  1. Esegui di nuovo dropstone e accedi nuovamente tramite il flusso del browser.
  2. Se ti trovi in un ambiente headless, imposta DROPSTONE_API_KEY con un token rilasciato su dropstone.io/account.
  3. Verifica che la tua rete consenta connessioni HTTPS in uscita verso dropstone.io. Se sei dietro un proxy aziendale, consulta Rete.

Modello non trovato

Se vedi ModelNotFoundError, probabilmente stai facendo riferimento a un ID di 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 salvate potrebbero essere non valide o corrotte.

  1. Cancella i tuoi dati salvati:

    rm -rf ~/.local/share/dropstone

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

  2. Esegui di nuovo dropstone e accedi nuovamente.

Errori nelle chiamate API

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

  1. Cancella la cache:

    rm -rf ~/.cache/dropstone

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

  2. Riavvia Dropstone.

Copia / incolla non funzionante su Linux

Gli utenti Linux devono avere uno dei seguenti strumenti per gli appunti installato affinché copia/incolla funzioni:

X11

apt install -y xclip
# oppure
apt install -y xsel

Wayland

apt install -y wl-clipboard

Headless

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

Dropstone preferisce wl-clipboard su Wayland e ripiega su xclip e poi 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 la velocità nativa del filesystem e il pieno supporto del terminale.

Assistenza

Ctrl+I