Dropstone CLI

Руководство по устранению неполадок

Диагностируйте проблемы с Dropstone CLI системно. Соберите нужную информацию, найдите логи и изолируйте причину до обращения в поддержку.

Большинство проблем сводятся к одной из четырёх причин: устаревшая сборка, устаревший кэш, неверные учётные данные или сеть. Эта страница — порядок, в котором их стоит проверять, и что собрать, если ни одна из них не подходит.

Для конкретного сообщения об ошибке начните с раздела Частые проблемы. По вопросам поведения во время выполнения и отладки отдельных функций см. Устранение неполадок CLI.

Первые три действия

Выполните их перед всем остальным. Они решают удивительную долю обращений.

# 1. Обновитесь
dropstone update

# 2. Посмотрите, что Dropstone на самом деле делает
dropstone --log-level DEBUG --print-logs
  1. Если сбой происходит в середине сессии и причина неясна, очистите кэш и перезапустите:
rm -rf ~/.cache/dropstone

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

Прежде чем удалять что-либо ещё

Три команды выше безопасны. Удаление ~/.local/share/dropstone — нет: там хранятся ваши учётные данные и история сессий. См. Где хранятся данные, прежде чем удалять этот каталог.

Где хранятся данные

Всё, что Dropstone хранит на диске, находится в двух каталогах.

ЧтоmacOS / LinuxWindows
Учётные данные и сессии~/.local/share/dropstone/%USERPROFILE%\.local\share\dropstone
Логи~/.local/share/dropstone/log/%USERPROFILE%\.local\share\dropstone\log
Кэш~/.cache/dropstone/%USERPROFILE%\.cache\dropstone

Внутри каталога данных:

  • auth.json — ваши учётные данные. Удаляйте его только для принудительного чистого входа.
  • log/ — логи с метками времени. Хранятся десять последних.
  • project/ — история сессий, привязанная к каждому проекту.

Файл лога назван по времени записи, например 2026-05-23T123456.log. Самый свежий — тот, что вам нужен.

Получите лог, который стоит читать

По умолчанию уровень логирования низкий. Два флага меняют это:

# Подробный вывод в файл лога
dropstone --log-level DEBUG

# Тот же вывод, транслируемый в терминал по мере возникновения
dropstone --print-logs

Используйте оба вместе, когда хотите наблюдать за сбоем в реальном времени и при этом сохранить файл после.

Если проблема — падение при запуске, помогает именно --print-logs: файл лога может вообще не записаться до завершения процесса, а stderr пишется всегда.

Что включить в отчёт

Отчёт с этими пятью пунктами обычно решается одним ответом. Отчёт без них — обычно четырьмя.

  1. Точная команда, которую вы выполнили. Не пересказ — буквальная строка, включая флаги.

  2. Чего вы ожидали и что произошло. Обе части. «Не сработало» ничего не сужает.

  3. Ваша версия и платформа.

    dropstone --version

    Плюс ваша ОС и её версия, а также работаете ли вы в нативном Windows или внутри WSL.

  4. Релевантный фрагмент лога. Несколько строк вокруг ошибки, не весь файл. Замаскируйте чувствительные данные — логи сессий могут содержать пути к файлам и код.

  5. Воспроизводится ли проблема. Всегда, иногда или один раз. «Иногда» стоит упомянуть: это указывает на тайминг или состояние, а не на неверный ввод.

Отправьте его на dropstone.io/contact.

Сужение круга причин

Если причина всё ещё неясна, исключайте переменные по одной. Каждая из этих проверок убирает целую категорию.

Дело в проекте? Запустите Dropstone в пустом каталоге. Если там всё работает, проблема связана с проектом — вероятно, файл конфигурации, файл правил или что-то в репозитории, что читает агент.

Дело в вашей конфигурации? Временно отодвиньте dropstone.json в сторону и перезапустите. См. Конфигурация, где находятся глобальные и проектные файлы конфигурации.

Дело в MCP-сервере? Сервер, зависающий при запуске, остановит всю сессию. Перечислите их и отключите, затем включайте по одному:

dropstone mcp list

Дело в сети? Корпоративные прокси — самая частая причина сбоев, которые выглядят как что-то другое. Проверьте:

curl -I https://dropstone.io

Если это не сработает или вернёт что-то неожиданное, см. Сеть и прокси. Обычное решение — задать HTTPS_PROXY и, что важно, NO_PROXY=localhost,127.0.0.1 — Dropstone использует локальный loopback во время интерактивных сессий, и маршрутизация этого трафика через прокси вызывает зацикливание.

Дело в учётных данных? Выйдите и войдите заново:

dropstone auth logout
dropstone auth login

Дело в терминале? В Linux для копирования и вставки нужна установленная утилита буфера обмена. См. Устранение неполадок CLI.

Дело в Windows? Медленный доступ к файлам, глюки терминала и проблемы с путями в нативном Windows обычно исчезают под WSL. См. Windows и WSL.

Перед обращением в поддержку

Связанные материалы

Ctrl+I