Dropstone Docs

Solución de problemas

Problemas comunes y cómo resolverlos.

Para depurar problemas con Dropstone, comienza verificando los registros y los datos locales que almacena en el disco.

Registros

Los archivos de registro se escriben en:

  • macOS / Linux: ~/.local/share/dropstone/log/
  • Windows: presiona WIN+R y pega %USERPROFILE%\.local\share\dropstone\log

Los archivos de registro se nombran con marcas de tiempo (por ejemplo 2026-05-23T123456.log) y se conservan los 10 archivos de registro más recientes.

Puedes establecer el nivel de registro con la opción de línea de comandos --log-level para obtener una salida de depuración más detallada:

dropstone --log-level DEBUG

--print-logs también transmite registros a stderr en tiempo real:

dropstone --print-logs

Almacenamiento

Dropstone almacena datos de sesión y otros datos de aplicación en el disco en:

  • macOS / Linux: ~/.local/share/dropstone/
  • Windows: presiona WIN+R y pega %USERPROFILE%\.local\share\dropstone

Este directorio contiene:

  • auth.json: Credenciales de autenticación
  • log/: Registros de aplicación
  • project/: Datos específicos del proyecto como historial de sesiones
    • Si el proyecto está dentro de un repositorio de Git, se almacena en ./<project-slug>/storage/
    • De lo contrario, se almacena en ./global/storage/

Problemas comunes

Dropstone no inicia

  1. Verifica los registros para ver un mensaje de error.
  2. Intenta ejecutar con --print-logs para transmitir registros a stderr.
  3. Asegúrate de que estés en la versión más reciente: dropstone update.

Problemas de autenticación

Si falla el inicio de sesión o la validación del token:

  1. Vuelve a ejecutar dropstone e inicia sesión nuevamente a través del flujo del navegador.
  2. Si estás en un entorno sin interfaz gráfica, establece DROPSTONE_API_KEY desde un token emitido en dropstone.io/account.
  3. Confirma que tu red permite HTTPS saliente a dropstone.io. Si estás detrás de un proxy corporativo, consulta Network.

Modelo no encontrado

Si ves ModelNotFoundError, probablemente estés haciendo referencia a un ID de modelo que no existe. Usa uno de estos:

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

Ejecuta dropstone models para confirmar qué está disponible para tu cuenta.

Error de inicialización

Si ves un InitError al iniciar, tus credenciales almacenadas pueden ser inválidas o estar corruptas.

  1. Borra tus datos almacenados:

    rm -rf ~/.local/share/dropstone

    En Windows: presiona WIN+R y elimina %USERPROFILE%\.local\share\dropstone.

  2. Vuelve a ejecutar dropstone e inicia sesión nuevamente.

Errores de llamadas a API

Si ves errores de llamadas a API durante una sesión, la caché en disco puede estar obsoleta.

  1. Borra la caché:

    rm -rf ~/.cache/dropstone

    En Windows: presiona WIN+R y elimina %USERPROFILE%\.cache\dropstone.

  2. Reinicia Dropstone.

Copiar / pegar no funciona en Linux

Los usuarios de Linux necesitan tener instalada una de las siguientes utilidades de portapapeles para que copiar/pegar funcione:

X11

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

Wayland

apt install -y wl-clipboard

Sin interfaz gráfica

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

Dropstone prefiere wl-clipboard en Wayland y recurre a xclip y luego a xsel en X11.

Windows: Problemas generales de rendimiento

Si experimentas un rendimiento lento, problemas de acceso a archivos o fallos de terminal en Windows nativo, cambia a WSL. WSL te proporciona un entorno Linux que ejecuta Dropstone con velocidad de sistema de archivos nativa y soporte completo de terminal.

Obtener ayuda

Ctrl+I