Руководство пользователя

Использование терминала

В этой главе рассматривается сам терминал: ввод/вывод, поиск внутри терминала, копирование/вставка и изображения, команда vopen, выбор оболочки на Windows и запись сессии.

1. Основы

Сессия терминала — это настоящая оболочка (стандартная системная оболочка на macOS / Linux; по умолчанию cmd на Windows, её можно изменить — см. §5). Рабочая директория по умолчанию — корень проекта, её можно изменить в режиме редактирования сессии, где также предусмотрена опция «Команда при запуске» — команда, которая выполняется автоматически при каждом запуске сессии (например, pnpm dev).

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

2. Поиск внутри терминала (⌘F)

Поиск в истории прокрутки текущего терминала с возможностью навигации вперед/назад:

Поиск внутри терминала

Для поиска в разных сессиях и истории используйте глобальный поиск (⌘⇧F) — см. Управление интерфейсом и сессиями §8.

3. Копирование и вставка

  • Выделите элемент, чтобы он подсветился; контекстное меню предлагает опции копирования/вставки, а обычные клавиши ⌘C / ⌘V также работают.
  • В программах TUI, которые используют мышь (vim, htop), удерживайте Option/Alt при перетаскивании, чтобы обеспечить обычный выбор текста.

Вставка изображений — это способ подачи изображений в агенты: вставьте скриншот или файл изображения в терминал, и VelaTerm сохранит изображение во временное место, а затем введет его путь в терминал — именно то, чего ожидают CLI вроде claude. Связанные настройки: «Вставка изображений» позволяет выбрать между вариантами «Загрузить как файл» (всегда сохраняется в конкретный путь) и «Стандарт для агентов»; опция «Автоматическое удаление вставленных изображений» периодически удаляет эти временные изображения, имеется кнопка «Удалить сейчас».

4. vopen: открытие файлов и страниц из терминала

Каждая сессия содержит три простых команды PATH (без установки): vopen, vspawn, vspawn-tree. Обратите внимание, что речь идет о командах терминала — навыки / с такими же именами, используемые внутри разговоров в Claude, — это отдельная вещь и требуют включения опции Vela Skills в Разделе настроек ▸ Общие. vopen отправляет данные в центральную панель:

vopen README.md          # markdown → WYSIWYG editor
vopen src/main.rs        # source code → syntax-highlighted editor
vopen diagram.png        # image → built-in image viewer
vopen https://crates.io  # URL → built-in browser tab (desktop only)

Полные вкладки документов (редактирование в двух режимах, поиск и замена, экспорт PDF): Вкладки документов и браузера. Создание с помощью vspawn: Создание сессий и совместная работа с Git.

5. Выбор оболочки (только Windows)

В режиме Windows сессии терминала могут явно выбрать оболочку — PowerShell / pwsh / cmd / Git Bash — через подменю «Создать», выпадающий список в форме редактирования сессии или правой кнопкой мыши «Оболочка ▸»; действующая сессия применит изменения при перезапуске. В Разделе настроек ▸ Терминал ▸ «Стандартная оболочка» задается значение по умолчанию для новых сессий.

О встроенном Git Bash: полная версия установщика включает полную комплектацию (git, ssh, perl); минимальный установщик включает только основной набор команд, а отсутствующие команды запускают запрос к загрузке полной версии по мере необходимости (также можно сделать это правой кнопкой мыши «Загрузить полную версию Git Bash»). Сессии агентов не затрагиваются — они всегда используют PowerShell.

macOS / Linux не имеют выбора оболочки; сессии используют стандартную оболочку системы ($SHELL).

6. Запись сессий

Раздел настроек ▸ Расширенные ▸ «Записывать логи сессий» (по умолчанию выключено). При включении содержимое терминала записывается в локальный файл с момента начала сессии (максимум 50 МБ на сессию). Это дает два преимущества:

  • Архивированные сессии позволяют воспроизвести терминал точно таким, каким он был;
  • Глобальный поиск позволяет находить вывод из обычного терминала (разговоры с агентами не требуют записи — у них есть транскрипты).

Файлы записи удаляются при удалении сессии.

7. Распространённые сокращения

macOS — значения по умолчанию; в режимах Windows / Linux замените ⌘ на Ctrl+Alt (с несколькими исключениями — смотрите страницу Настройки). Всё, кроме ⌘1–9 и трёх параметров размера шрифта, можно перенастроить в Настройки ▸ Сокращения.

ДействиеСокращение
Открыть проект⌘O
Новая терминал-оболочка Scratch⌘T
Новая вкладка браузера⌘⇧B
Закрыть панель / вкладку⌘W
Разделить вправо / разделить вниз⌘D / ⌘⇧D
Найти в терминале⌘F
Поиск во всех сессиях⌘⇧F
Сохранить документ⌘S
Перейти к вкладке N⌘1–9 (фиксировано)
Увеличить/уменьшить размер шрифта в терминале/сбросить⌘+ / ⌘- / ⌘0 (фиксировано)