Dropstone Docs

Интерактивная сессия

Как работать внутри сессии Dropstone. Ссылки на файлы, shell-команды, slash-команды и интеграция с редактором.

Dropstone работает как интерактивная сессия в вашем терминале. Каждая сессия привязана к директории, из которой вы её запустили, хранит историю разговора и остаётся открытой до выхода. На этой странице описано, как управлять сессией: как ссылаться на файлы, запускать shell-команды, использовать slash-команды и подключить внешний редактор.

Запуск сессии

Запустите dropstone из проекта:

dropstone

Или укажите конкретную директорию:

dropstone /path/to/project

После запуска Dropstone введите любой запрос на естественном языке:

Give me a quick summary of the codebase.

Ссылки на файлы

Ссылайтесь на файлы в сообщениях с помощью @. Это выполняет нечёткий поиск по текущей рабочей директории.

How is auth handled in @src/api/index.ts?

Содержимое файла автоматически добавляется в разговор, поэтому агент может его прочитать без предварительного поиска.

Shell-команды

Начните сообщение с ! для запуска shell-команды. Вывод добавляется в разговор как результат инструмента, чтобы агент мог на него реагировать.

!ls -la

!git diff

Slash-команды

Введите / и имя команды для выполнения быстрого действия. Большинство имеют сочетание клавиш с ctrl+x в качестве префикса (настраивается через Keybindings).

/help

compact

Сжать текущую сессию. Старый контекст суммируется, чтобы освободить место для новой работы. Alias: /summarize.

Keybind: ctrl+x c

details

Переключить отображение деталей выполнения инструментов в строке.

editor

Открыть внешний редактор для написания более длинного сообщения. Использует редактор, установленный в EDITOR. См. Editor setup.

Keybind: ctrl+x e

effort

Отрегулировать глубину рассуждений активной модели. Открывает выбор с четырьмя уровнями: low, medium, high, xhigh. Более высокий уровень даёт более глубокие рассуждения за счёт большего количества кредитов и немного более высокой задержки. Alias: /thinking.

exit

Выход из Dropstone. Aliases: /quit, /q.

Keybind: ctrl+x q

export

Экспортировать текущий разговор в Markdown и открыть его в редакторе (использует EDITOR).

Keybind: ctrl+x x

help

Показать диалог справки со всеми slash-командами и сочетаниями клавиш.

init

Пошаговая настройка для создания или обновления AGENTS.md. См. Rules (AGENTS.md).

models

Список доступных моделей для этой сессии.

Keybind: ctrl+x m

new

Начать новую сессию в текущей директории. Alias: /clear.

Keybind: ctrl+x n

redo

Повторить ранее отменённое сообщение. Доступно только после /undo. Изменения файлов восстанавливаются как часть повтора.

Requires Git:

Undo и redo используют Git для управления снимками состояния файлов, поэтому ваш проект должен быть Git-репозиторием.

Keybind: ctrl+x r

sessions

Список и переключение между сессиями. Aliases: /resume, /continue.

Keybind: ctrl+x l

undo

Отменить последнее сообщение в разговоре. Удаляет самое последнее сообщение пользователя, все последующие ответы и любые изменения файлов, сделанные в этих ходах.

Requires Git:

Undo использует Git для отката изменений файлов, поэтому ваш проект должен быть Git-репозиторием.

Keybind: ctrl+x u

upgrade

Открыть страницу цен Dropstone для обновления плана. Используйте это, когда вам нужно больше еженедельных кредитов или доступ к премиум-уровням (Dropstone Pro, Dropstone Heavy).

Plan upgrade vs CLI upgrade:

/upgrade — это обновление плана. Чтобы обновить сам бинарный файл Dropstone CLI, запустите dropstone update из вашей оболочки.

usage

Показать потребление кредитов за текущую неделю, название плана, еженедельный лимит и время следующего сброса кредитов.

Настройка редактора

Команды /editor и /export запускают редактор из переменной окружения EDITOR.

# Terminal editors
export EDITOR=nano
export EDITOR=vim

# GUI editors (VS Code, Cursor, VSCodium, Windsurf, Zed, etc.)
# require --wait so the editor process blocks until closed
export EDITOR="code --wait"

Чтобы сделать это постоянным, добавьте в профиль вашей оболочки (~/.bashrc, ~/.zshrc и т. д.).

Популярные варианты:

  • code для Visual Studio Code
  • cursor для Cursor
  • windsurf для Windsurf
  • nvim для Neovim
  • vim для Vim
  • nano для Nano
  • subl для Sublime Text
  • notepad для Windows Notepad

The --wait flag:

GUI-редакторы вроде VS Code по умолчанию возвращаются сразу, что пропустит ваше сообщение. Флаг --wait заставляет процесс редактора блокироваться до закрытия файла, чтобы Dropstone мог прочитать то, что вы написали.

Настройка

Несколько предпочтений уровня сессии находятся в палитре команд (Ctrl+P). Найдите то, что вы хотите изменить; параметр запоминается между сессиями.

  • Hide username: удаляет ваше имя пользователя из сообщений чата
  • Diff style: выбор между адаптивным (по умолчанию) и однолинейным стилем diff
  • Mouse capture: переключение между обработкой выделения мышью самим терминалом или Dropstone

Для всего остального (сочетания клавиш, форматеры, формат файла конфигурации) см. специальные страницы: Keybindings, Formatters, Configuration.

Конфиденциальность и хранение данных

Ваши запросы, код и стенограммы разговоров никогда не используются для обучения моделей и не сохраняются после завершения сессии. Dropstone использует кэширование запросов в области сессии для снижения затрат и задержки, так же как Anthropic и OpenAI: кэшированный контент изолирован на вашем аккаунте, автоматически истекает и никогда не переиспользуется для других пользователей или не отправляется на обучение модели.

Эти элементы управления обеспечиваются и проверяются компанией Blankline, материнской компанией Dropstone. Команда соответствия Blankline регулярно проводит аудит обработки данных Dropstone и сохраняет право отзыва производственного доступа любого лица или системы, нарушившей политику.

Полную информацию о безопасности, включая раскрытие субпроцессоров и границу безопасности во время выполнения, см. на Trust page.

Ctrl+I