Dropstone CLI

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

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

Чтобы отладить проблемы с 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.

Если приложение мгновенно завершает работу без какого-либо вывода на macOS, это другой сбой — см. Завершение работы при запуске на macOS.

Завершение работы при запуске на macOS

На Apple Silicon версия Dropstone 1.0.50 была остановлена macOS до вывода каких-либо данных, поэтому каждая команда выглядела так:

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

Нет журнала для чтения и нет ошибки для поиска: процесс останавливается до запуска, поэтому --print-logs и dropstone upgrade также завершаются с ошибкой. macOS проверяет подпись бинарного файла перед его запуском, и подпись, встроенная в эту сборку, не совпала. macOS до 26 версии допускал это; macOS 27 — нет. Windows и Linux никогда не были затронуты.

Чтобы подтвердить это перед переустановкой:

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

Затем замените бинарный файл. Homebrew и установщик работают без запуска установленной копии:

# Homebrew
brew update && brew upgrade dropstone

# Одношаговый установщик
curl -fsSL https://dropstone.io/install.sh | bash

Чтобы разблокировать уже имеющуюся копию вместо переустановки:

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

Версии 1.0.51 и новее подписаны так, как macOS принимает, и каждый релиз проверяет эту подпись перед публикацией.

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

Если вход или проверка токена завершается ошибкой:

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

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

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

  • 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

Без графического интерфейса

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