DraggyДокументация
Русский
draggy.org Скачать

ДокументацияПомощь

Безопасность

Что Draggy может делать, что он отклоняет и как сообщить о проблеме.

Эта страница собирает ограничения и проверки Draggy в одном месте. Каждый раздел ведёт к странице, где тема описана полностью. Некоторые запросы уходят без вашего участия, например проверка обновлений.

Режимы разрешений#

Каждый вызов инструмента проходит одну проверку перед запуском. Выбранный режим определяет, что спрашивает разрешение.

  • Plan only читает проект и предлагает изменения. Ничего не меняет и не запускает команды.
  • Ask first спрашивает перед каждым изменением ваших файлов и перед каждой командой.
  • Accept edits, режим по умолчанию для новых проектов, правит файлы без вопросов. Перед удалением и командами он спрашивает.
  • YOLO правит, удаляет и запускает команды без вопросов.

Чтение не спрашивает ни в одном режиме. Полная таблица находится на странице Разрешения.

Запрещённые папки и файлы#

Draggy отклоняет их в любом режиме.

  • Папки вроде .ssh, .aws, .gnupg, .kube, .docker, .password-store
  • Файлы вроде .env, id_rsa, .pem, .pfx, .npmrc, .netrc, .git-credentials, credentials
  • Любое однократное чтение больше 2 МБ

Исполняемые файлы и типы скриптов не принимаются при создании документа. Полный список — на странице Проекты, а Инструменты и возможности описывает документы.

Запуск кода#

Команды запускаются прямо на вашем компьютере, от имени вашего пользователя, внутри папки проекта. Каждая команда либо спрашивает одобрение, либо запускается автоматически, в зависимости от режима разрешений рабочей области. Вывод длиннее 30 000 символов обрезается в середине. Ограничения выполнения и правила одобрения описаны на страницах Команды и Разрешения.

Удалённые серверы и то, до чего они дотягиваются#

Сервер MCP — это программа, которая даёт Draggy дополнительные инструменты. Локальный сервер устанавливается через npm в собственную папку и запускается напрямую на вашем компьютере, от вашего имени, с теми учётными данными, которые вы ввели. Скрипты установки не принимаются, и оболочка не задействуется. Ни один сервер не включён по умолчанию.

Удалённый сервер работает в другом месте и доступен по HTTPS. Удалённые серверы входят через OAuth и PKCE. Локальный сервер также отправляет запросы сервису, с которым работает, например GitHub. На странице о конфиденциальности перечислено, куда уходит каждый вид запросов, а раздел Расширения и навыки описывает серверы.

Журналы и диагностика#

app.log содержит события; запросы и ответы сведены к хешам и длинам, а секреты удалены. debug.log записывает потоковый вывод по длине, а не по тексту.

Для отчёта об ошибке используйте Settings → Diagnostics → Export diagnostics. Он заменяет вашу домашнюю папку и имя пользователя, но перед отправкой файл стоит прочитать. Шаги описаны в разделе Всё ещё не работает.

Загрузки#

Скачивайте Draggy только с этого сайта или со страницы релизов GitHub. Сборка для Windows не подписана сертификатом разработчика. В файле обновления для Windows указан SHA-512 установщика. Первый запуск описан на странице Установка.

Сообщение об уязвимости#

Используйте приватную форму GitHub для отчётов, а не публичный issue. Опишите, что вы сделали, что произошло и чего ожидали. Черновой proof of concept приветствуется. Укажите сборку Draggy, которая видна в Settings → Updates, и операционную систему, если это важно.

Сообщить об уязвимости на GitHub. Полная политика — в SECURITY.md.

Предложить правку