Dropstone Docs

Solução de Problemas

Problemas comuns e como resolvê-los.

Para depurar problemas com Dropstone, comece verificando os logs e os dados locais que ele armazena em disco.

Logs

Os arquivos de log são escritos em:

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

Os arquivos de log são nomeados com timestamps (por exemplo 2026-05-23T123456.log) e os 10 arquivos de log mais recentes são mantidos.

Você pode definir o nível de log com a opção de linha de comando --log-level para obter uma saída de depuração mais detalhada:

dropstone --log-level DEBUG

--print-logs também transmite logs para stderr em tempo real:

dropstone --print-logs

Armazenamento

Dropstone armazena dados de sessão e outros dados de aplicação em disco em:

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

Este diretório contém:

  • auth.json: Credenciais de autenticação
  • log/: Logs da aplicação
  • project/: Dados específicos do projeto, como histórico de sessão
    • Se o projeto estiver dentro de um repositório Git, ele é armazenado em ./<project-slug>/storage/
    • Caso contrário, é armazenado em ./global/storage/

Problemas comuns

Dropstone não inicia

  1. Verifique os logs para uma mensagem de erro.
  2. Tente executar com --print-logs para transmitir logs para stderr.
  3. Certifique-se de que você está na versão mais recente: dropstone update.

Problemas de autenticação

Se o login ou validação de token falhar:

  1. Execute dropstone novamente e faça login através do fluxo do navegador.
  2. Se você estiver em um ambiente sem interface gráfica, defina DROPSTONE_API_KEY a partir de um token emitido em dropstone.io/account.
  3. Confirme que sua rede permite HTTPS de saída para dropstone.io. Se você estiver atrás de um proxy corporativo, consulte Network.

Modelo não encontrado

Se você vir ModelNotFoundError, provavelmente está referenciando um ID de modelo que não existe. Use um dos seguintes:

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

Execute dropstone models para confirmar o que está disponível para sua conta.

Erro de inicialização

Se você vir um InitError ao iniciar, suas credenciais armazenadas podem ser inválidas ou corrompidas.

  1. Limpe seus dados armazenados:

    rm -rf ~/.local/share/dropstone

    No Windows: pressione WIN+R e delete %USERPROFILE%\.local\share\dropstone.

  2. Execute dropstone novamente e faça login.

Erros de chamada de API

Se você vir erros de chamada de API durante uma sessão, o cache em disco pode estar desatualizado.

  1. Limpe o cache:

    rm -rf ~/.cache/dropstone

    No Windows: pressione WIN+R e delete %USERPROFILE%\.cache\dropstone.

  2. Reinicie Dropstone.

Copiar / colar não funciona no Linux

Usuários do Linux precisam ter um dos seguintes utilitários de área de transferência instalados para que copiar/colar funcione:

X11

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

Wayland

apt install -y wl-clipboard

Sem interface gráfica

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

Dropstone prefere wl-clipboard no Wayland e volta para xclip e depois xsel no X11.

Windows: Problemas gerais de desempenho

Se você estiver vendo desempenho lento, problemas de acesso a arquivos ou falhas de terminal no Windows nativo, mude para WSL. WSL oferece um ambiente Linux que executa Dropstone com velocidade nativa do sistema de arquivos e suporte completo de terminal.

Obtendo ajuda

Ctrl+I