Быстрый старт
Установите Dropstone, войдите в систему и отправьте первое изменение менее чем за пять минут. Это руководство проведет вас от нуля до работающего цикла агента.
К концу этого руководства у вас будет установлен Dropstone, вы войдете в систему и начнете вносить реальные правки в проект по вашему выбору.
Перед началом работы
Вам понадобится:
- Терминал или командная строка
- Проект на диске, на который вы укажете Dropstone (любой язык, любого размера)
- Учетная запись Dropstone, которую можно создать на dropstone.io
Шаг 1: Установка Dropstone
Выберите способ установки для вашей платформы.
Homebrew (рекомендуется):
brew tap blankline-org/dropstone-cli
brew install dropstone
Или установочный скрипт:
curl -fsSL https://dropstone.io/install | bash
Оба способа устанавливают один бинарный файл dropstone в ваш PATH. Никакого Node, никаких зависимостей времени выполнения.
Проверьте установку:
dropstone --version
Вы должны увидеть номер версии (текущий релиз — 1.0.8). Бинарный файл автоматически обновляется в фоновом режиме, поэтому вы всегда остаетесь актуальными без повторного запуска установщика.
Шаг 2: Вход в систему
Перейдите в любой каталог проекта и запустите Dropstone:
cd /path/to/your/project
dropstone
При первом запуске вам будет предложено войти в систему. Два варианта:
- Продолжить в браузере (рекомендуется). Открывает dropstone.io/login, выполняет вход и автоматически передает токен обратно в CLI. Использует PKCE, поэтому токен никогда не появляется в адресной строке браузера.
- Вставить токен. Для SSH или headless-сессий. Получите токен на dropstone.io/account и вставьте его.
Ваши учетные данные сохраняются на диске после первого входа. Чтобы позже переключить учетную запись, выполните /login внутри Dropstone.
Шаг 3: Начало первой сессии
Теперь вы видите главный экран Dropstone. Обратите внимание на три вещи:
- Ваш текущий уровень модели показан в правом верхнем углу (по умолчанию: Dropstone Fast)
- Поле ввода внизу — это место, где вы печатаете
- Слэш-команды начинаются с
/. Попробуйте/help, чтобы увидеть их все
Введите любой запрос на естественном языке, чтобы начать сессию. Никакого специального синтаксиса изучать не нужно.
Шаг 4: Задайте первый вопрос
Позвольте Dropstone изучить проект за вас. Попробуйте один из этих запросов:
что делает этот проект?
какие основные точки входа?
объясни структуру папок
Dropstone будет читать файлы по мере необходимости и отвечать со ссылками на фактический код. Вам не нужно вставлять файлы или писать контекст вручную.
Вы также можете спросить Dropstone о нем самом:
что ты умеешь делать в этом проекте?
какие команды тебе разрешено выполнять?
Шаг 5: Внесите первое изменение в код
Теперь опишите небольшое изменение. Для нового проекта попробуйте что-то низкорисковое:
добавь README с описанием проекта в один абзац
Для существующего проекта:
добавь валидацию входных данных в функцию, которая создает пользователя
Dropstone будет:
- Находить соответствующий файл
- Показывать предлагаемое изменение в виде diff
- Запрашивать ваше одобрение перед записью
- Проверять результат (проверки типов, тесты, линтеры, если доступны)
Разрешения:
Dropstone запрашивает одобрение при первой попытке отредактировать файл или выполнить команду оболочки. Одобрите один раз, и та же операция в той же сессии будет выполняться без повторного запроса. Используйте /permissions, чтобы просмотреть или отозвать выданные разрешения.
Шаг 6: Работа с git
Dropstone рассматривает git как инструмент первого класса:
какие файлы я изменил?
закоммить мои изменения с описательным сообщением
создай ветку feature/health-endpoint и переключись на нее
покажи последние пять коммитов
помоги мне разрешить конфликт слияния в src/auth.ts
Для рабочих процессов уровня PR (открытие pull request, генерация описаний PR, публикация комментариев к ревью) см. Интеграция с GitHub.
Шаг 7: Исправьте ошибку или добавьте функцию
Опишите, что вы хотите, на простом языке. Dropstone найдет код, поймет контекст, реализует изменение и проверит его.
есть ошибка: пустые поисковые запросы возвращают все результаты — исправь это
добавь эндпоинт /healthz на API-сервер, который возвращает информацию о сборке
форма входа падает, когда email отсутствует — разберись, почему, и исправь
Если задача охватывает несколько файлов, Dropstone напишет короткий план и выполнит его шаг за шагом. Вы можете нажать Esc в любой момент, чтобы прервать и направить процесс.
Шаг 8: Попробуйте другие распространенные рабочие процессы
Несколько паттернов, в которых Dropstone силен:
Рефакторинг
отрефактори модуль аутентификации, чтобы использовать async/await вместо колбэков
Написание тестов
напиши юнит-тесты для функций калькулятора
Ревью кода
просмотри мои staged изменения и укажи на все рискованное
Документация
обнови инструкции по установке в README, чтобы включить путь WSL
Совет:
Общайтесь с Dropstone как с коллегой. Описывайте, чего вы хотите достичь, а не точные шаги для этого. Агент лучше всего планирует, когда вы оставляете выбор реализации ему.
Основные команды
Небольшой набор команд, которые вы будете реально использовать:
| Команда | Что делает | Пример |
|---|---|---|
dropstone | Запускает интерактивную сессию в текущем каталоге | dropstone |
dropstone run "задача" | Выполняет разовую задачу и завершает работу | dropstone run "объясни auth.ts" |
dropstone -c | Продолжает последнюю сессию в этом каталоге | dropstone -c |
dropstone --session ID | Возобновляет конкретную сессию по id | dropstone --session 7f3a... |
/help | Показывает все слэш-команды | внутри сессии |
/effort | Переключает уровень модели для этой сессии | /effort high |
/clear | Очищает текущий разговор | внутри сессии |
/login | Переключает учетные записи | внутри сессии |
exit или Ctrl+D | Выход из Dropstone |
Полный справочник находится на страницах CLI и слэш-команды.
Советы для новых пользователей
Что дальше
Получение помощи
- Внутри Dropstone введите
/helpили задайте вопрос на простом языке («как переключить модели?») - Просмотрите остальную документацию на docs.dropstone.io
- Сообщите об ошибке или запросите функцию на dropstone.io/contact