Dropstone CLI

Guida alla risoluzione dei problemi

Diagnostica i problemi di Dropstone CLI in modo sistematico. Raccogli le informazioni giuste, trova i log e isola la causa prima di contattare il supporto.

La maggior parte dei problemi rientra in una di quattro categorie: una build obsoleta, una cache non aggiornata, credenziali errate o la rete. Questa pagina indica l'ordine in cui verificarle e cosa raccogliere quando nessuna di queste è la causa.

Per un messaggio di errore specifico, inizia invece da Problemi comuni. Per il comportamento a runtime e il debug per funzionalità, consulta Risoluzione dei problemi CLI.

Le prime tre cose da provare

Esegui queste prima di qualsiasi altra cosa. Risolvono una percentuale sorprendente delle segnalazioni.

# 1. Aggiorna all'ultima versione
dropstone update

# 2. Scopri cosa sta facendo realmente Dropstone
dropstone --log-level DEBUG --print-logs
  1. Se l'errore si verifica a metà sessione e la causa non è chiara, svuota la cache e riavvia:
rm -rf ~/.cache/dropstone

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

Prima di eliminare qualsiasi altra cosa

I tre comandi sopra sono sicuri. Eliminare ~/.local/share/dropstone non lo è: è lì che risiedono le tue credenziali e la cronologia delle sessioni. Consulta Dove risiedono i dati prima di rimuovere quella directory.

Dove risiedono i dati

Tutto ciò che Dropstone salva su disco si trova in due directory.

CosamacOS / LinuxWindows
Credenziali e sessioni~/.local/share/dropstone/%USERPROFILE%\.local\share\dropstone
Log~/.local/share/dropstone/log/%USERPROFILE%\.local\share\dropstone\log
Cache~/.cache/dropstone/%USERPROFILE%\.cache\dropstone

All'interno della directory dati:

  • auth.json — le tue credenziali. Eliminalo solo per forzare un accesso pulito.
  • log/ — log con timestamp. Vengono conservati i dieci più recenti.
  • project/ — cronologia delle sessioni, limitata per progetto.

Un file di log prende il nome dal momento in cui è stato scritto, ad esempio 2026-05-23T123456.log. Quello più recente è quello che ti serve.

Ottieni un log che valga la pena leggere

Per impostazione predefinita il livello di log è silenzioso. Due flag lo modificano:

# Output dettagliato scritto nel file di log
dropstone --log-level DEBUG

# Lo stesso output trasmesso al terminale mentre accade
dropstone --print-logs

Usali insieme quando vuoi osservare l'errore mentre si verifica e avere comunque il file in seguito.

Se il problema è un crash all'avvio, --print-logs è quello che aiuta: il file di log potrebbe non essere scritto affatto prima che il processo termini, ma stderr lo è sempre.

Cosa includere in una segnalazione

Una segnalazione con questi cinque elementi di solito richiede una sola risposta per essere risolta. Una senza di essi di solito ne richiede quattro.

  1. Il comando esatto che hai eseguito. Non una parafrasi — la riga letterale, inclusi i flag.

  2. Cosa ti aspettavi e cosa è successo. Entrambe le parti. "Non ha funzionato" non restringe il campo.

  3. La tua versione e piattaforma.

    dropstone --version

    Più il tuo sistema operativo e la sua versione, e se sei su Windows nativo o dentro WSL.

  4. Lo stralcio di log pertinente. Poche righe prima e dopo l'errore, non l'intero file. Oscura qualsiasi dato sensibile — i log di sessione possono contenere percorsi di file e codice.

  5. Se è riproducibile. Sempre, a volte o una sola volta. "A volte" vale la pena dirlo; indica un problema di temporizzazione o di stato piuttosto che un input errato.

Inviala a dropstone.io/contact.

Restringere il campo

Se la causa non è ancora evidente, elimina le variabili una alla volta. Ciascuna di queste rimuove un'intera categoria.

È il progetto? Esegui Dropstone in una directory vuota. Se funziona lì, il problema è limitato al progetto — probabilmente un file di configurazione, un file di regole o qualcosa nel repository che l'agente sta leggendo.

È la tua configurazione? Sposta temporaneamente dropstone.json da parte e riavvia. Consulta Configurazione per sapere dove si trovano i file di configurazione globali e di progetto.

È un server MCP? Un server che si blocca all'avvio può fermare l'intera sessione. Elencali e disabilitali, poi riabilitane uno alla volta:

dropstone mcp list

È la rete? I proxy aziendali sono la causa più comune di errori che sembrano qualcos'altro. Verifica:

curl -I https://dropstone.io

Se fallisce o restituisce qualcosa di inaspettato, consulta Rete e proxy. La soluzione usuale è impostare HTTPS_PROXY e, soprattutto, NO_PROXY=localhost,127.0.0.1 — Dropstone usa un loopback locale durante le sessioni interattive, e instradarlo attraverso un proxy causa un loop.

Sono le tue credenziali? Esci e accedi di nuovo:

dropstone auth logout
dropstone auth login

È il terminale? Su Linux, copia e incolla richiedono un'utility per gli appunti installata. Consulta Risoluzione dei problemi CLI.

È Windows? Accesso lento ai file, problemi del terminale e problemi di percorso su Windows nativo di solito scompaiono sotto WSL. Consulta Windows e WSL.

Prima di contattare il supporto

Correlati

Ctrl+I