Управление интерфейсом и сессиями

В этой главе описана организационная модель VelaTerm: структура окна, работа с деревом, поведение вкладок и разделённых панелей, точки статуса и фильтрация, архивирование, глобальный поиск и сохранение рабочего пространства при выходе. Остальные главы опираются на эти сведения.

1. Структура окна

Кнопки «Удалённый доступ» и «Подключиться к удалённому серверу» доступны в настольном приложении; см. Удаленная разработка и управление. Кнопка «Обратная связь» открывает страницу отзывов VelaTerm в браузере. В Windows и Linux при нажатии Alt появляется строка меню с разделами «Файл», «Терминал» и «Справка».

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

2. Дерево: проекты, коллекции, группы, сессии

• Проект — это каталог на диске и корень поддерева. Проект добавляется командой «Создать проект» (создаёт новую папку), «Импортировать проект» (открывает существующую папку, ⌘O) или «Клонировать из Git».
• Коллекция — это контейнер верхнего уровня без папки для сессий, которые не относятся к одному проекту. Она создаётся кнопкой «Новая коллекция» внизу боковой панели.
• Группа — это узел для упорядочивания, который можно вкладывать на любую глубину.
• Сессия — это рабочая единица: агент, страница браузера или терминал. По умолчанию её рабочий каталог совпадает с корнем проекта; его можно изменить в форме «Изменить» этой сессии.

При наведении указателя на строку появляется кнопка ＋ («Новая сессия» у проектов и групп, «Новая дочерняя сессия» у сессий), а у проектов и групп — ещё и кнопка создания группы.

Большинство операций находится в контекстных меню:

Меню проектов и групп начинаются с пунктов создания:

• «Новая страница браузера» (в настольном приложении) и «Новый терминал», который открывает временный терминал в этом каталоге (§5).
• Три пункта «Новая сессия …» для недавно использованных агентов и подменю «Другие сессии агента», где собраны все агенты, сохранённые пресеты, пункт «Новый сеанс агента» (окно выбора с поиском) и «Создать с аргументами…».
• «Новая сессия worktree…» и «Новая сессия планирования/выполнения…»; см. Создание сессий и совместная работа в Git и Планирование и выполнение.
• «Импорт сессий…» (только у проектов) и «Возобновить сессию…»; см. Сессии ИИ-агентов, §4.

Далее в меню проекта есть пункты «Новая группа», «Метка», «Экспериментальная функция» (граф кода и аудит кода), «Сведения о проекте» (или «Сведения о коллекции»), «Переименовать» и «Убрать проект» (или «Удалить коллекцию»). В меню группы есть подменю «Git» и пункты «Новая подгруппа», «Переместить в worktree…», «Метка», «Переименовать», «Архивировать группу» и «Удалить группу».

Меню сессий содержат пункты, которые подходят для типа и состояния сессии:

• «Открыть», «Открыть в новой вкладке», «Открыть в панели справа», «Открыть в панели снизу», «Открыть в активной панели» (§4).
• «Новая дочерняя сессия», «Форкнуть сессию», «Экспортировать сессию…», «Подготовить для базы знаний сеансов» и подменю «Git».
• «Метка», «Сведения о сессии» (удерживайте Option/Alt, чтобы увидеть полную команду запуска), «Изменить», «Переименовать», «Переместить в…».
• «Завершить процесс» (пока процесс работает), «Архивировать сессию», «Удалить сессию».

Другие операции с деревом:

• Перемещение: перетаскивайте узлы или используйте пункт «Переместить в…». Сессию можно переместить под другую сессию, и тогда она станет дочерней.
• Переименование: пункт «Переименовать» позволяет изменить название прямо в дереве. Сессия, которой вы не дали название, получает его из вашего первого сообщения.
• Метки: пункт «Метка» добавляет к проекту, группе или сессии метку-эмодзи: 🔥 Срочно, ⭐ Важно, 🐛 Ошибка, ✅ Готово, 🚧 В работе, 📌 Закреплено, 💡 Идея, ⚠️ Внимание. Повторный выбор текущей метки снимает её.
• Множественный выбор: ⌘/Ctrl-щелчок добавляет сессию в выделение или убирает её оттуда, Shift-щелчок выделяет диапазон. После этого в контекстном меню доступны пункты «Открыть выбранные сессии», «Разложить выбранные сессии плиткой» (от двух до четырёх сессий), «Переместить выбранное…», «Архивировать выбранные сессии» и «Удалить N выбранных элементов». При перетаскивании перемещается всё выделение.
• Состояние свёрнутых узлов сохраняется между перезапусками.

3. Вкладки

Параметр «Вкладки» (Настройки ▸ Поведение) определяет, как открываются сессии:

• Одна (по умолчанию): щелчок по сессии агента в дереве открывает её в текущей вкладке сессии, как переход по ссылке в браузере. Вкладка, которую вы покидаете, уходит в фон вместе со всеми своими панелями, и её процессы продолжают работать. Терминальные сессии открываются в отдельных вкладках.
• Несколько: каждая сессия открывается в отдельной вкладке.

Пункт «Открыть в новой вкладке» всегда открывает новую вкладку. В обоих режимах переключение на другую вкладку ничего не останавливает; закрытие вкладки (⌘W или ×) завершает её процессы. Для сессий агентов это безопасно: диалог сохраняется, и повторное открытие узла возобновляет его.

Фоновые вкладки отображаются в строке состояния как «Фон N/M»; щёлкните этот элемент, чтобы вернуть вкладку или завершить её. В режиме «Одна» их число ограничивает параметр «Лимит фоновых вкладок» (по умолчанию 32). При превышении лимита самая старая неактивная фоновая вкладка завершается автоматически. Если все фоновые вкладки работают или ждут вас, VelaTerm спрашивает, какую из них завершить.

Особенности панели вкладок:

• ⌘1–9 (в Windows и Linux — Ctrl+1–9) переключает на вкладку по её позиции. Щелчок средней кнопкой мыши закрывает вкладку.
• Кнопка ＋ после вкладок открывает временный терминал. Кнопки справа открывают новый терминал, новый документ, вкладку встроенного браузера (в настольном приложении) и «Игровой центр».
• В контекстном меню вкладки есть пункты «Закрыть вкладку», «Закрыть другие вкладки», «Закрыть вкладки справа», «Закрыть все вкладки», «Свернуть в фоновый режим» (процессы вкладки продолжают работать), а также те же пункты сессии, что и в дереве.

Вкладки документов и браузера описаны в главе Вкладки документов и браузера.

4. Разделение на панели

Вкладка может содержать несколько панелей:

• ⌘D разделяет вправо, ⌘⇧D — вниз (в Windows и Linux — Ctrl+Alt+D и Ctrl+Alt+E); такие же кнопки есть в заголовке панели. Новая панель — это временный терминал, который запускается в рабочем каталоге текущей панели.
• Чтобы показать существующую сессию в текущей вкладке, выберите в её меню «Открыть в панели справа», «Открыть в панели снизу» или «Открыть в активной панели» либо перетащите её из боковой панели в центральную область.
• Пункт «Разложить выбранные сессии плиткой» размещает от двух до четырёх выбранных сессий в одной вкладке.
• Сессии, показанные в другой панели текущей вкладки, подсвечиваются в боковой панели.

Разделители можно перетаскивать. Фоновая работа распространяется на всю вкладку, поэтому раскладка вкладки сохраняется, когда вы уходите с неё и возвращаетесь. ⌘W закрывает текущую панель; закрытие последней панели закрывает вкладку.

5. Временные терминалы

«Новый терминал», ⌘T и кнопка ＋ на панели вкладок открывают временный терминал. Он существует только в виде вкладки: не становится узлом дерева и удаляется при закрытии. Такая вкладка помечена «врем.». Используйте временные терминалы для быстрых команд, а длительную работу ведите в сессиях агентов. Меню временного терминала короткое: «Открыть», «Открыть в новой вкладке», пункты разделения, «Переименовать», «Сведения о сессии» и «Закрыть черновик».

6. Точки статуса и фильтрация

Точка рядом с каждой сессией агента показывает её состояние: зелёная — агент работает, жёлтая — нужно ваше участие, пурпурная — агент ответил и вы видели ответ. Полное описание обозначений приведено в главе Сессии ИИ-агентов, §3.

Строка состояния показывает, сколько сессий находится в состоянии «В работе», «Ожидает» (нужно ваше участие) и «Просмотрено»; счётчик без сессий скрыт. Щёлкните счётчик, чтобы оставить в боковой панели только эти сессии; повторный щелчок снимает фильтр.

У боковой панели есть собственные инструменты:

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

7. Правая панель

• Файлы: дерево файлов рабочего каталога сессии. Дважды щёлкните файл, чтобы открыть его во вкладке документа.
• Информация: сведения о сессии, использование аккаунта, текущий ход и потребление ресурсов; см. Сессии ИИ-агентов, §8.
• Git: ветка, проиндексированные и непроиндексированные изменения, неотслеживаемые файлы, создание коммитов и история коммитов.
• База знаний: база знаний сеансов, архивные сессии и ваши локальные базы знаний; см. Локальные базы знаний и База знаний сеансов.

8. Архивирование: убрать, а не удалить

Завершённую работу не обязательно удалять. Щёлкните сессию правой кнопкой мыши и выберите «Архивировать сессию», чтобы скрыть её: сессия и её дочерние сессии исчезают из дерева, а их процессы завершаются, но все данные сохраняются. «Архивировать группу» архивирует все сессии группы, а «Архивировать выбранные сессии» — выделенные.

Архивные сессии хранятся в базе знаний. Откройте их кнопкой «Архив сессий» в заголовке боковой панели. Архивные сессии сгруппированы по проектам, а поле поиска («Поиск по архиву…») ищет по их содержимому. Для каждой архивной сессии доступно следующее:

• Диалог можно прочитать. Для сессий агентов показываются их сообщения; если диалог недоступен, показывается запись терминала, если она есть. На второй вкладке перечислены статьи базы знаний, созданные на основе сессии.
• «Восстановить как обычную сессию» возвращает её на прежнее место в дереве с сохранённым ID диалога, поэтому при открытии возобновляется исходный диалог.
• «Подготовить для базы знаний сеансов» извлекает из неё знания для повторного использования.
• «Экспортировать полный контекст в Markdown» (Claude и Codex) записывает весь диалог в файл.
• «Удалить навсегда (вместе с записью)» — единственное действие, которое удаляет данные.

9. Глобальный поиск (⌘⇧F)

«Искать во всех сессиях» (⌘⇧F, в Windows и Linux — Ctrl+Alt+G) ищет по содержимому всех сессий: по диалогам агентов и записанному выводу терминала, а не только по названиям.

• Можно сочетать несколько слов в любом порядке; находятся также части слов и текст на китайском, японском или корейском языке. Результаты упорядочены по релевантности.
• Результаты сгруппированы по сессиям слева; предпросмотр справа подсвечивает текущее совпадение. Клавиши ↑/↓ и Enter переходят между совпадениями во всех сессиях.
• «Открыть сессию» открывает сессию в рабочем пространстве.
• Архивные сессии не учитываются, если не отмечен флажок «Включая архив».

Поиск по выводу терминала возможен только при включённой записи сессий (Настройки ▸ Дополнительно ▸ «Запись журналов сессий», по умолчанию выключена). Поиск по диалогам агентов доступен всегда.

10. Безопасное удаление

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

11. Выход и восстановление рабочего пространства

При выходе появляется вопрос «Закрыть VelaTerm?», и работающие сессии терминалов и агентов останавливаются. Если отмечен флажок «Сохранить рабочее пространство», при следующем запуске открываются те же вкладки и разделения. Восстановленные сессии не запускаются сами: в каждой панели отображается сообщение «Восстановлено из сохранённого рабочего пространства. Процесс ещё не запущен.» и кнопка «Запустить». Флажок запоминает ваш последний выбор.