Окно приложения

Окно DevMachine ADE собрано вокруг чата с агентом. Слева — список сессий, файлы проекта и базы данных, в центре — чат, справа — фоновые задачи. Панели можно расставить по-своему, колонки — скрыть, а виды модулей и настройки — вынести в отдельные окна.

#Шапка окна

Слева направо:

• Кнопка проекта — слово «Проект» и имя папки проекта со стрелкой, а в проекте «Без проекта» на ней только «Без проекта». Кнопка открывает меню «Проект»: «Открыть проект…», «Проект из git…», «Проект на сервере…», «Новый временный файл…» и недавние проекты. Подробнее — на странице Проекты.
• Кнопка ветки — имя текущей ветки после косой черты «/». Она открывает ветки и действия Git: Pull, Commit, Push, новая ветка. Подробнее — в разделе Git.
• «Назад» и «Вперёд» листают историю переходов, о ней — ниже.
• Заголовок чата. Когда агент ждёт вашего ответа, рядом появляется плашка «Нужно решение · N».
• Кнопки инструментов. По умолчанию в шапке стоят «Терминал», «Изменения сессии» и «Git». Остальные — Kubernetes, Profiler, Observe, Rollout, Queues, Ignition, «Браузер» и Zephyr Copilot (агент пишет тест-кейсы в Zephyr Scale вашей Jira) — в меню кнопки «Другие инструменты»: она стоит в шапке сразу после кнопок инструментов. Все эти виды есть в приложении всегда и работают без модулей агента. Модуль нужен, только если с ними должен работать и агент, — подробнее на странице Модули.
• «Левая колонка» и «Правая колонка» скрывают и возвращают колонку.
• Шестерёнка открывает настройки, колокольчик — «Уведомления».

Какие инструменты стоят в шапке, какие в меню и в каком порядке, выбирают в «Настройки → Расположение панелей → Кнопки в верхней панели». У каждого инструмента там переключатель, а порядок меняют, перетаскивая строку; стрелки ↑ ↓ тоже работают. В узком окне инструменты сами уходят в меню, а если сузить окно ещё, прячутся заголовок чата и ветка.

#Колонки и центр

В окне пять панелей: «Сессии», «Чат», «Файлы», «Базы данных» (вкладка «БД») и «Фоновые задачи» (вкладка «Задачи»). Панели одной колонки идут вкладками. В центр из них можно поставить только чат. Если чат стоит в боковой колонке, центр отдан рабочей области: редактору, изменениям, Git, базам данных и видам модулей.

По умолчанию слева — сессии, файлы и базы данных, в центре — чат, справа — фоновые задачи.

Если чат в центре и вы открываете файл, файл занимает место чата, а в правой колонке вместо «Задач» появляется вкладка «Агент» с разговором текущей сессии. Закроете последнюю вкладку редактора — в центр вернётся чат.

Вид модуля (Kubernetes, Profiler, Observe, Rollout, Queues, Ignition, «Браузер») открывается в центре, без чата. Разговор рядом с ним появится, только если нажать «Агент» в шапке вида.

#Готовые раскладки

Раскладку выбирают в «Настройки → Расположение панелей → Готовые варианты»: нажмите на плитку, и окно сразу перестроится.

«Редактор» в таблице и есть рабочая область в центре, в число пяти панелей он не входит.

Каждую панель можно поставить и вручную, в блоке «Где стоит каждая панель» того же раздела. Окно останется таким, как вы расставили панели, а в блоке «Готовые варианты» не будет отмечена ни одна плитка. Если расстановка полностью совпадёт с одним из вариантов, отмечена будет его плитка. Кнопка «Посмотреть окно» прячет настройки, чтобы было видно, что получилось. «Сбросить» возвращает расположение, ширину колонок и кнопки шапки к исходным. Обо всех настройках — на странице Настройки.

#Правая колонка: «Фоновые задачи»

• «Субагенты сессии» — все субагенты открытого чата: и те, что работают или ждут, и те, что закончили или упали. Если субагент ждёт ответа, у него пометка «ждёт вашего решения». Кнопка «Стоп» останавливает работающего или ждущего субагента. Нажмите на строку, и в колонке откроется разговор субагента.
• «Субагенты других сессий» — субагенты, которые сейчас работают в других чатах. У них тоже есть кнопка «Стоп», а если нажать на строку, откроется их чат. Если ни один чат не открыт, блок называется просто «Субагенты».
• «Порты, открытые из ADE» — серверы, запущенные из приложения, с кнопкой «Открыть». В проекте на сервере блок называется «Порты, открытые из ADE на …» (дальше имя сервера), и кнопки «Открыть» в нём нет.
• Сводка сессии. «Изменения» — сколько файлов агент поменял в этой сессии и сколько строк добавил и удалил, или «нет». Строка «Решения» появляется, когда агент ждёт вашего ответа на карточках, и показывает, сколько карточек ждёт. «Ревью» — проверили ли вы правки: «ещё не проверено», «принято» и время или «очередь пуста», если проверять нечего. Кнопка «Открыть ревью» открывает «Изменения сессии»; пока изменений нет, она неактивна.

Подробнее о субагентах — на странице Субагенты и фоновые задачи, о ревью правок — в разделе Изменения сессии.

#«Назад» и «Вперёд»

Кнопки в шапке возвращают туда, где вы были: в проект, в чат, к виду в центре, а в редакторе — к файлу. Боковые колонки, терминал, всплывающие окна и диалоги шагами не считаются. Приложение помнит 50 шагов. Если вы вернулись назад, а потом перешли в новое место, шаги «вперёд» пропадут.

#Модули и настройки в отдельном окне

Виды Kubernetes, Profiler, Observe, Rollout, Queues и Ignition можно вынести в отдельное окно и, например, держать на втором мониторе.

1. Откройте вид модуля и нажмите «Открепить в отдельное окно» в его шапке.
2. В центре главного окна останется заглушка «… открыт в отдельном окне» с кнопками «Показать окно» и «Вернуть сюда».
3. Чтобы вернуть модуль, нажмите «Вернуть в ADE» в его окне. Открытые вкладки сохранятся.

Приложение запоминает, где стоит каждое окно. Окно модуля умеет то же, что вид в главном окне. А то, что есть только у главного окна (чат, сессии, редактор, терминал, макросы), окно модуля передаёт главному.

Настройки тоже открываются отдельно, кнопкой «Открыть в отдельном окне» в их шапке. Окно настроек можно растянуть за край или угол, а размер приложение запомнит.

#Уведомления

Всплывающее уведомление исчезает с экрана, но остаётся в журнале под колокольчиком «Уведомления». В журнале — результаты Git и импорта, ошибки и вопросы агента.

• Фильтры «Все» и «Ошибки и вопросы».
• «Отметить все прочитанными», «Очистить журнал», у записи — «Убрать из журнала» и «Вывод» (вывод команды, если он был).
• Непрочитанное отмечено синим, ошибки — красным.
• В журнале хранятся последние 500 записей; он общий для главного окна и окон модулей.

После обновления в журнале появляется запись «Обновлено до …» со списками «Новое» и «Исправлено». Когда выходит новая версия, появляется запись «Доступна версия …» с кнопкой «Обновить». Подробнее — на странице Установка и обновления.

Когда окно приложения не в фокусе, приходят и системные уведомления: агент ждёт решения (на macOS — ещё и число на значке в Dock), VPN мешает связи с сервером, пришёл новый алерт Kubernetes или очередей.

Журнал хранится только на этом компьютере. Токены и пароли в адресах там скрыты, а длинные тексты обрезаны.

#Сочетания клавиш

В таблице — набор JetBrains, он стоит по умолчанию.

В наборе VS Code колонки скрываются по отдельности: левая — ⌘ B (Ctrl B), правая — ⌥ ⌘ B (Ctrl Alt B). Все сочетания — на странице Сочетания клавиш.

#Ограничения

• Раскладка, ширина колонок и кнопки шапки хранятся на этом компьютере и на другие не переносятся.
• Вид «Браузер» в отдельное окно не выносится.
• Красная кнопка аварийной остановки в шапке по умолчанию скрыта. Включить её можно в «Настройки → Расположение панелей», пункт «Красная кнопка «Остановить агента»». Сочетание клавиш работает всегда, подробнее — на странице Аварийная остановка.
• На Windows у окна своя шапка без системного заголовка, кнопки окна встроены в неё.

#Что дальше

• Файлы, редактор и поиск
• Терминал
• Настройки
• Сочетания клавиш