Файлы, редактор и поиск

Файлы проекта можно смотреть и править, не выходя из DevMachine ADE: здесь есть дерево, вкладки редактора, просмотр PDF и офисных документов, поиск по проекту. Агент правит те же файлы на диске, поэтому его изменения сразу видны в дереве и в редакторе.

#Дерево файлов

Вкладка «Файлы» по умолчанию стоит в левой колонке. Чтобы перенести её в правую, откройте «Настройки → Расположение панелей» и выберите раскладку в группе «Готовые варианты» или поставьте панель вручную в блоке «Где стоит каждая панель». О колонках окна — на странице Окно приложения.

Открывают вкладку сочетанием ⌘ 1 на macOS и Alt 1 на Windows и Linux (в наборе сочетаний VS Code — ⇧ ⌘ E / Ctrl Shift E). Набор сочетаний — это клавиши как в привычной среде разработки: «JetBrains» (по умолчанию), «VS Code» или «JetBrains Classic». Выбирают его в «Настройки → Сочетания клавиш», в строке «Набор сочетаний» (см. Сочетания клавиш).

• Кнопки над деревом: «Свернуть всё», «Развернуть всё», «Показать открытый файл», «Обновить».
• Цвет имени показывает состояние файла в Git: изменён, новый или удалён.
• Файлы из .gitignore показаны серым. Символические ссылки в дереве тоже видны.
• Дерево запоминает раскрытые папки и выбранную строку для каждого проекта.

#Меню файла

Щёлкните файл или папку правой кнопкой мыши. В меню:

• «Новый ▸ Файл… / Папка…», «Добавить в чат»;
• «Вырезать», «Копировать», «Вставить»;
• «Копировать путь ▸ Абсолютный путь / Путь от корня проекта / Имя файла / Упоминанием для чата»;
• «Найти в папке…» — ищет текст только в этой папке;
• «Переименовать…» (⇧ F6 или F2), «Создать копию…» (F5);
• «Удалить…» — файл уходит в Корзину, оттуда его можно вернуть;
• «Открыть в ▸» — в Finder (на Windows — в Проводнике, на Linux — в файловом менеджере), в терминале или в программе по умолчанию;
• «Git ▸» — Add, Rollback…, Show Diff, Annotate with Git Blame, «Добавить в .gitignore».

#Выделение и перетаскивание

• Несколько файлов выделяют щелчком с зажатой ⌘/Ctrl или ⇧, все сразу — ⌘ A (Ctrl A).
• ⌘ C, ⌘ X, ⌘ V копируют, вырезают и вставляют, а ⌘ N создаёт файл (на Windows и Linux — с Ctrl).
• Перетащите файл в другую папку, и он переедет туда; с зажатой ⌥ (Alt) — скопируется. Перенос можно отменить кнопкой «Отменить» в уведомлении.
• Файлы из Finder, Проводника или файлового менеджера Linux можно перетащить в дерево — они скопируются в папку.

#Ссылки на файлы в ответах агента

Имена и пути файлов в ответе агента работают как ссылки:

• файл проекта открывается во вкладке редактора; если файлов с таким именем несколько, откроется поиск;
• файл вне проекта показывается в Finder, Проводнике или папке;
• путь с ~ отсчитывается от домашней папки;
• веб-адреса, написанные простым текстом, тоже открываются.

Пункт «Показать в Finder» (на Windows — «Показать в Проводнике», на Linux — «Показать в папке») есть и в меню вкладки редактора, и на экране двоичного файла.

#Документы, PDF и картинки

В шапке просмотрщика есть переключатель «Документ» / «Как прочитал агент». Второй режим показывает, какой текст и какие картинки получила модель — нейросеть, которая пишет ответы агента. Так видно, что именно агент прочитал в документе. Если просмотрщик не смог показать файл, сразу открывается этот режим. Там же, в шапке, кнопки «Быстрый просмотр» (только macOS) и «Открыть в приложении».

Файл проекта открывается во вкладке редактора. Вложение из сообщения открывается в широком окне поверх экрана, картинки из сообщения — галереей; закрыть их можно клавишей Esc. Документы, PDF и картинки — и из проекта, и из сообщений — приложение показывает само, на компьютере, и для просмотра никуда их не отправляет.

#Редактор

• Вкладки и группы. Вкладку можно открыть в соседней группе справа или снизу («Разделить вправо», «Разделить вниз»). Разделитель между группами можно тянуть мышью, а двойной щелчок по нему делит место пополам. Щелчок средней кнопкой мыши закрывает вкладку.
• Сохранение. Автосохранение включено всегда: редактор сохраняет файл через полторы секунды после правки, когда вы уходите из окна, меняете вкладку или вид и когда закрываете вкладку. ⌘ S (Ctrl S) сохраняет сразу.
• Подсветка. Редактор подсвечивает 32 языка, среди них BSL и язык запросов 1С. Для Markdown есть переключатель «Код · Разделить · Просмотр».
• Кодировка. Файл не в UTF-8 редактор на правку не открывает и показывает экран «Кодировка не UTF-8». Так сохранение не испортит файл. Править такой файл можно в другой программе, а найти его поможет кнопка «Показать в Finder» на этом же экране (на Windows — «Показать в Проводнике», на Linux — «Показать в папке»).
• Файл изменился на диске. Если файл изменил агент, терминал или другая программа, пока у вас были несохранённые правки, редактор спросит, какую версию оставить: «Взять версию с диска» или «Записать мою поверх».
• Меню вкладки: «Закрыть», «Закрыть остальные», «Закрыть слева», «Закрыть справа», «Закрыть все», «Закрепить», «Разделить вправо», «Разделить вниз», «Показать в Finder».

#Изменения и blame

Слева от номеров строк стоят отметки изменений относительно последнего коммита. Щёлкните отметку — появятся прежний текст и кнопки «Предыдущее изменение», «Следующее изменение», «Откатить строки», «Скопировать прежний текст».

Кнопка «Blame» в полосе вкладок или пункт «Аннотации Git blame» в меню правой кнопки мыши показывают автора и дату на месте номеров строк. Щелчок по аннотации открывает коммит в Git, а «Скрыть аннотации» их убирает.

#Переход к объявлению

⌘+клик или F12 по имени ищет его объявление в проекте. В IDE такой переход точный, а здесь это поиск: если в проекте есть одноимённые функции, проверьте, куда вы попали.

#Спросить агента о коде

Выделите код, щёлкните правой кнопкой и выберите «Спросить в новом чате» или «Спросить в текущем чате». В черновик сообщения попадёт цитата: путь, номера строк и сам код. Допишите вопрос и отправьте. Пока вы не отправили сообщение, ничего никуда не уходит.

Шрифт, размер и лигатуры редактора меняют в «Настройки → Оформление и язык».

#Поиск и замена в файле

⌘ F (Ctrl F) открывает панель поиска над кодом. В ней можно учитывать регистр, искать слово целиком или по регулярному выражению, заменить одно совпадение или все сразу. Совпадения отмечены на полосе прокрутки.

Та же панель работает в консоли запросов «БД» и в быстром просмотре (там без замены). Замена действует только в открытом файле.

#Окно поиска: чаты, файлы, текст

Окно открывают клавишами из таблицы ниже (смотрите столбец своего набора сочетаний) или кнопкой с лупой «Найти чат» рядом с кнопкой «Новая сессия» на панели «Сессии» — тогда сразу откроется вкладка «Чаты».

В окне три вкладки: «Чаты», «Файлы» и «Текст». Поиск идёт по всем трём сразу, какую бы вкладку вы ни выбрали. Выбранная вкладка показана первой и целиком, остальные — по нескольку строк со ссылкой «Все чаты — N», «Все файлы — N» или «Все совпадения — N».

#Чаты

Пока запрос пуст, в окне видны «Недавние чаты» всех проектов и «Новая сессия». Поиск идёт по названиям и тексту разговоров всех проектов на этом компьютере, кроме скрытых. Под названием чата показано, кто это сказал («Вы:» или «Агент:»), и фрагмент разговора. Enter открывает чат. Подробнее о списке чатов — на странице Чаты.

#Файлы

• Пока запрос пуст, видны «Открытые файлы».
• имя:строка или имя:строка:колонка открывает файл сразу на нужной строке.
• Маска файлов: *.ts, !*.test.ts.
• Имя найдётся, даже если набрать его не в той раскладке: «ашду» найдёт file.

#Текст

Здесь ищут текст по проекту. Переключатели: «Учитывать регистр» (⌥ C), «Слово целиком» (⌥ W), «Регулярное выражение» (⌥ X), «Маска файлов» (⌥ F); на Windows и Linux клавише ⌥ соответствует Alt. Где искать: «Проект», «Каталог» или «Открытые файлы». Справа — предпросмотр: щелчок выделяет совпадение, двойной щелчок открывает файл. Файлы из .gitignore поиск пропускает.

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

• Файловые операции в дереве работают только внутри проекта.
• Поиск текста показывает не больше 1000 совпадений; если их больше, уточните запрос. Поиск работает через git, поэтому git должен быть установлен.
• Найденное сообщение открывается вместе с чатом, но лента к нему не прокручивается.
• «Быстрый просмотр» — только на macOS.
• В проекте на сервере нет «Показать в Finder», «Открыть в программе по умолчанию» и быстрого просмотра, а ссылки из чата на файлы вне проекта не работают. Файл, удалённый в дереве, уходит в корзину сервера. Если корзины нет, приложение сначала спросит и только потом удалит файл безвозвратно. Поиск идёт на сервере.

#Что дальше

• Проекты
• Git-клиент
• Дифф «Код / Поведение»
• Сочетания клавиш