Dvina пишет код в проекте на вашем компьютере, учитывая заметки, обсуждения и причины принятых решений. Вы описываете, что нужно сделать, проверяете изменения и выпускаете результат — в том же приложении, которым пользуетесь для всего остального.
Перед началом
Работа с кодом доступна в настольном приложении Dvina для Mac, Windows и Linux. Устанавливать что-либо отдельно не нужно. Dvina должна быть установлена хотя бы на одном компьютере; с любого другого устройства можно запускать работу и следить за ней.
Чтобы установить настольное приложение, см. Скачивание и установка Dvina.
Откройте проект
Проект — это папка на вашем компьютере: репозиторий кода или обычная папка.
- В настольном приложении откройте Dock и выберите строку проектов (Проекты).
- Выберите Открыть…, чтобы выбрать папку или репозиторий кода, либо Новый проект…, чтобы создать новую папку на этом компьютере.
При создании проекта включите Создать репозиторий Git, чтобы сохранять историю всех изменений и иметь возможность отменять правки Dvina.
Чат работает в выбранном вами проекте. Если это проект с кодом, в Dock также отображается его ветка.
Поручите работу
Опишите, что нужно сделать, например: «Исправь даты в экспорте CSV». Dvina выполняет это как задачу на вашем компьютере, а вы можете продолжать общение или запускать другие задачи. Несколько задач могут работать с одним репозиторием и сами определять, какая из них первой создаст коммит.
Прежде чем писать код, Dvina изучает проект и его контекст: ищет информацию в ваших прошлых чатах и файлах, чтобы учитывать причины принятых решений. Она также следует инструкциям из AGENTS.md или CLAUDE.md в вашем проекте.
Проверьте изменения
Ответ по каждой задаче появляется вместе с изменениями в карточке с названием задачи и статусом Готово к проверке.
- Посмотрите, что изменилось: выберите Изменения, чтобы просмотреть изменения в каждом файле на боковой панели. Раздел Файлы позволяет просматривать содержимое проекта.
- Отмените изменения одного ответа: под ответом, в котором были изменены файлы, выберите строку с количеством изменённых файлов, затем Отменить изменения и подтвердите действие в окне Отменить изменения этого ответа?. Файлы вернутся к состоянию до этого ответа, а более поздние изменения сохранятся.
Создайте коммит и откройте пул-реквест
- В карточке задачи выберите Создать коммит.
- В окне Создание коммита перечислены файлы, которые войдут в коммит в вашей ветке, и предложены Заголовок и Сообщение. Выберите Создать коммит. Ничего не отправляется в удалённый репозиторий.
- Чтобы открыть пул-реквест, выберите Отправить и создать PR. Dvina сначала отправит текущую ветку в удалённый репозиторий, а затем откроет пул-реквест. Файлы, не включённые в коммит, в него не попадут.
Пул-реквест создаётся с использованием вашей авторизации в Git. Dvina открывает его на GitHub или GitLab; для любого другого хостинга в браузере открывается его страница создания пул-реквеста. Когда всё будет готово, выберите Посмотреть PR.
Подтверждения
Сборки и тесты запускаются без подтверждения. Удаление файлов, отправка изменений в репозиторий, изменения в базе данных, развёртывание и любые действия с секретами требуют вашего разрешения. В карточке указана причина запроса: например, Выполнить эту команду? с пометкой Удаляет файлы или Изменяет базу данных. Выберите Разрешить или Отклонить. Администратор может настроить, какие действия всегда требуют подтверждения.
Важно
Ничего не отправляется в репозиторий без вашего разрешения. Ваш проект — это папка на вашем компьютере, а с помощью Git можно отменить любую правку, которую вносит Dvina.
Тестирование в симуляторе или эмуляторе
В настольном приложении Dvina может проверить ваше приложение на этом компьютере так, как им будут пользоваться ваши пользователи: в браузере, в симуляторе iOS на Mac или в эмуляторе Android на Mac, Windows или Linux.
- Откройте Dock и выберите строку Устройство.
- В разделе Это устройство выберите Браузер, Симулятор iOS или Эмулятор Android.
Устройство откроется в боковой панели. Если симулятор выключен, он запустится при открытии. Чтобы выбрать другой, нажмите Выбрать устройство в верхней части панели. Для каждого устройства указаны его система и состояние: Работает или Выключено.
Чтобы показать или скрыть браузер, нажмите ⌘ ⇧ B на Mac или Ctrl Shift B на Windows и Linux. Если Dvina работает в панели, которую вы сейчас не просматриваете, в строке Устройство появляется точка.
Разрешите Dvina использовать устройство
При первом использовании симулятора или эмулятора Dvina запрашивает разрешение, например: Разрешить Dvina использовать iPhone 17 Pro? Dvina видит экран устройства, поэтому не входите на нём в свои настоящие аккаунты. Выберите Разрешить или Отклонить. Ваш ответ сохраняется для этого устройства, поэтому в другом чате запрос не повторится. Пока вы не дадите разрешение, в панели будет доступна кнопка Разрешить Dvina использовать устройство.
Пока Dvina работает, в панели отображается Dvina использует это устройство, а в чате — экран устройства в реальном времени. Выберите Увеличить просмотр, чтобы увидеть его крупнее. Отправка, оплата и удаление на устройстве каждый раз требуют вашего подтверждения.
Чтобы пользоваться устройством самостоятельно, выберите Взять управление. Ваши нажатия и ввод с клавиатуры будут передаваться устройству. Вы можете нажимать Домой, а на Android также Назад и Недавние приложения. Когда закончите, выберите Вернуть управление, и Dvina продолжит работу.
Настройте симулятор iOS
Если симулятор iOS не настроен, при выборе его строки открывается список шагов Настройка симулятора iOS. Каждый шаг автоматически отмечается как выполненный, даже если вы выполнили его в другом месте.
- Установите Xcode: выберите Открыть App Store. Xcode бесплатный и занимает около 7 ГБ. После установки откройте его один раз.
- Выберите Xcode: выберите Скопировать команду и выполните её в Терминале. Для неё нужен ваш пароль, поэтому Dvina никогда не выполняет её за вас.
- Добавьте симулятор iOS: в Xcode перейдите в Настройки › Компоненты и загрузите iOS или выполните команду в Терминале.
- Создайте устройство: выберите Создать iPhone. Ничего не скачивается.
Настройте эмулятор Android
Если эмулятор Android не настроен, при выборе его строки открывается список шагов Настройка эмулятора Android.
- Установите Android Studio: выберите Скачать Android Studio. Вместе с ним устанавливается всё необходимое для работы эмулятора. После установки откройте его один раз.
- Добавьте эмулятор и инструменты платформы: выполните команду в терминале или добавьте их в Android Studio › SDK Manager.
- Включите аппаратное ускорение: на Windows и Linux выполните команду самостоятельно, поскольку для неё нужен ваш пароль или права администратора. Затем на Linux выйдите из системы и войдите снова, а на Windows перезагрузите компьютер. На Mac этот шаг не требует никаких действий.
- Добавьте образ системы: выполните команду в терминале или добавьте образ в Android Studio › SDK Manager. Потребуется скачать большой файл.
- Создайте эмулятор: выберите Создать эмулятор. Ничего не скачивается.
Если администратор отключил симуляторы, в соответствующих строках отображается Отключено администратором.
Работайте откуда угодно
С телефона или через веб-версию опишите в чате, что нужно сделать. Dvina выполнит работу в проекте на вашем компьютере, а изменения будут ждать вашей проверки. Компьютер должен быть включён, а Dvina — открыта.
Когда использовать
- Вы разрабатываете настоящее ПО и хотите опираться на всю историю работы: заметки, решения и обсуждения за прошлый месяц.
- Вы хотите, чтобы исправление было готово, пока вы не за рабочим столом.
- Вы хотите, чтобы работа над несколькими изменениями шла одновременно и каждое было готово к проверке.
Советы
- Запишите свои правила работы. Опишите свой подход в AGENTS.md или CLAUDE.md, и Dvina будет ему следовать.
- Тестируйте на телефоне. Разрабатываете приложение? Dvina может протестировать его в симуляторе iPhone или эмуляторе Android, нажимая на элементы так же, как ваши пользователи. См. Тестирование в симуляторе или эмуляторе.
- Вы не разработчик? Чтобы создавать работающие приложения и страницы, используйте Создание.