Dropstone Docs

Устранение неполадок

Распространённые проблемы и способы их решения.

Для отладки проблем с Dropstone начните с проверки логов и локальных данных, которые он хранит на диске.

Логи

Файлы логов записываются в:

  • macOS / Linux: ~/.local/share/dropstone/log/
  • Windows: нажмите WIN+R и вставьте %USERPROFILE%\.local\share\dropstone\log

Файлы логов названы с временными метками (например 2026-05-23T123456.log), и сохраняются последние 10 файлов логов.

Вы можете установить уровень логирования с помощью опции командной строки --log-level для более подробного вывода отладки:

dropstone --log-level DEBUG

--print-logs также транслирует логи в stderr в реальном времени:

dropstone --print-logs

Хранилище

Dropstone хранит данные сеанса и другие данные приложения на диске в:

  • macOS / Linux: ~/.local/share/dropstone/
  • Windows: нажмите WIN+R и вставьте %USERPROFILE%\.local\share\dropstone

Этот каталог содержит:

  • auth.json: учётные данные аутентификации
  • log/: логи приложения
  • project/: данные, специфичные для проекта, такие как история сеансов
    • Если проект находится в репозитории Git, он хранится в ./<project-slug>/storage/
    • В противном случае он хранится в ./global/storage/

Распространённые проблемы

Dropstone не запускается

  1. Проверьте логи на наличие сообщения об ошибке.
  2. Попробуйте запустить с --print-logs для трансляции логов в stderr.
  3. Убедитесь, что вы используете последнюю версию: dropstone update.

Проблемы с аутентификацией

Если вход или проверка токена не удаётся:

  1. Повторно запустите dropstone и выполните вход через браузер.
  2. Если вы находитесь в среде без графического интерфейса, установите DROPSTONE_API_KEY из токена, выданного на dropstone.io/account.
  3. Подтвердите, что ваша сеть позволяет исходящие HTTPS-соединения с dropstone.io. Если вы находитесь за корпоративным прокси, см. Network.

Модель не найдена

Если вы видите ModelNotFoundError, вы, вероятно, ссылаетесь на ID модели, которая не существует. Используйте один из:

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

Запустите dropstone models для подтверждения того, что доступно вашему аккаунту.

Ошибка инициализации

Если вы видите InitError при запуске, ваши сохранённые учётные данные могут быть недействительны или повреждены.

  1. Очистите сохранённые данные:

    rm -rf ~/.local/share/dropstone

    На Windows: нажмите WIN+R и удалите %USERPROFILE%\.local\share\dropstone.

  2. Повторно запустите dropstone и выполните вход.

Ошибки вызовов API

Если вы видите ошибки вызовов API во время сеанса, кэш на диске может быть устаревшим.

  1. Очистите кэш:

    rm -rf ~/.cache/dropstone

    На Windows: нажмите WIN+R и удалите %USERPROFILE%\.cache\dropstone.

  2. Перезагрузите Dropstone.

Копирование / вставка не работает на Linux

Пользователям Linux нужна одна из следующих утилит буфера обмена для работы копирования/вставки:

X11

apt install -y xclip
# или
apt install -y xsel

Wayland

apt install -y wl-clipboard

Headless

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

Dropstone предпочитает wl-clipboard на Wayland и переходит на xclip, затем на xsel на X11.

Windows: общие проблемы производительности

Если вы видите медленную производительность, проблемы с доступом к файлам или сбои терминала на нативной Windows, переключитесь на WSL. WSL предоставляет вам среду Linux, которая запускает Dropstone с собственной скоростью файловой системы и полной поддержкой терминала.

Получение помощи

Ctrl+I