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

Вкладки документов и браузера

Вкладки центральной области — это не только терминалы. В этой главе описаны ещё два типа вкладок: вкладки документов (встроенный редактор Markdown и кода) и вкладки браузера (встроенные веб-страницы). Они находятся на одной панели вкладок с вкладками сессий, и открытие сессии никогда их не заменяет.

1. Вкладки документов

1.1 Открытие

Вкладка документа открывается, когда вы:

  • выполняете vopen <file> в любой сессии (в Claude Code то же самое делает навык /vopen, если в разделе «Настройки ▸ Общие» установлены Vela Skills);
  • дважды щёлкаете файл на вкладке «Файлы» правой панели или выбираете «Открыть в редакторе»;
  • открываете заметку из базы знаний (см. Локальные базы знаний);
  • нажимаете «Новый документ» в правом конце панели вкладок.

Способ просмотра зависит от типа файла:

ТипСпособ просмотра
md / markdown / mdxРедактор Markdown с режимами «Визуальный», «Исходный код» и «Сравнение»; открывается в режиме «Визуальный»
Изображения (png, jpg, jpeg, gif, webp, svg, bmp, ico, avif)Средство просмотра изображений с режимами «Вписать» и «1:1»
Все остальные файлыРедактор кода с подсветкой синтаксиса, выбранной по имени файла

Документ Markdown, открытый командой vopen

1.2 Редактор Markdown

  • Визуальный — это визуальный редактор, в котором текст сразу отображается в оформленном виде. Введите /, чтобы открыть меню вставки (заголовки, списки, списки задач, цитаты, блоки кода, таблицы, формулы, изображения и разделители). Огороженные блоки кода mermaid отображаются в виде диаграмм под блоком.
  • Исходный код показывает текст файла точно в том виде, в каком он хранится, включая YAML front matter, с подсветкой синтаксиса Markdown.
  • Сравнение показывает режимы «Визуальный» и «Исходный код» рядом и синхронизирует их, пока вы редактируете любой из них.
  • ⌘/ (в Windows и Linux — Ctrl+/) переключает между режимами «Визуальный» и «Исходный код». Переключение режимов без правок не изменяет файл.
  • Если вставить или перетащить изображение в сохранённый документ, изображение сохраняется в папку assets рядом с документом, а в текст добавляется относительная ссылка на него.

1.3 Редактирование и сохранение

  • ⌘S или кнопка «Сохранить» записывает файл на диск. Точка на вкладке обозначает несохранённые изменения.
  • Активный документ проверяет диск каждые две секунды. Если файл изменила другая программа, появляется баннер с кнопками «Перезагрузить» и «Игнорировать»; если у вас тоже есть несохранённые правки, кнопка перезагрузки называется «Перезагрузить (отбросить мои изменения)». Если файл на диске изменился после того, как вы начали редактирование, перед перезаписью файла появляется окно «Конфликт сохранения» с запросом подтверждения.
  • При закрытии вкладки с несохранёнными изменениями нужно выбрать «Сохранить и закрыть», «Закрыть без сохранения» или «Отмена».
  • ⌘F открывает панель поиска с поиском, заменой, заменой всех совпадений и параметром «Учитывать регистр»; она работает одинаково во всех режимах.
  • Кнопка «Боковая панель» показывает структуру документа («Структура») и дерево файлов его папки («Дерево файлов»); щёлкните файл в дереве, чтобы открыть его. Ширину боковой панели можно изменить.
  • Файлы размером более 10 МБ открываются только для чтения и показывают только первые 10 МБ, чтобы при сохранении не обрезать остальную часть файла.
  • В контекстном меню вкладки документа, помимо обычных команд закрытия, есть пункт «Обновить файл», а для Markdown — ещё и «Экспорт в PDF».

1.4 Новые документы и экспорт в PDF

  • «Новый документ» открывает пустой черновик, который ещё не сохранён на диске и не отображается в дереве проекта. При первом сохранении нужно выбрать место для файла: настольное приложение использует системное окно сохранения, а браузерные клиенты и окна удалённого подключения показывают окно «Сохранить как» для компьютера, на котором работает сессия. Подсветка синтаксиса определяется выбранным именем файла. В контекстном меню вкладки черновика есть также пункт «Сохранить на диск…».
  • «Экспорт в PDF» преобразует документ Markdown в векторный PDF с автоматическими разрывами страниц и встроенными шрифтами CJK. Настольное приложение спрашивает, где сохранить файл; браузерные клиенты скачивают его.

2. Вкладки браузера (только в настольном приложении)

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

Как открыть вкладку браузера:

  • кнопка «Встроенный браузер» в правом конце панели вкладок;
  • сочетание клавиш ⌘⇧B;
  • vopen <URL> в сессии;
  • пункт «Новая страница браузера» в контекстном меню проекта или группы в боковой панели.

Панель инструментов: «Назад», «Вперёд», «Обновить» (или «Остановить загрузку», пока страница загружается), адресная строка («Введите URL или поисковый запрос»; текст, который не является адресом, ищется в Google), «Открыть в системном браузере» и строка «Быстрый доступ» с ChatGPT, Claude, Gemini и Google.

Две формы:

  • Вкладка браузера: открывается кнопкой, сочетанием ⌘⇧B или командой vopen <URL>. Она не сохраняется в дереве проекта и не восстанавливается после перезапуска.
  • Узел страницы браузера: создаётся пунктом «Новая страница браузера». Это узел в дереве проекта, который запоминает свой адрес и сохраняется после перезапуска.

Ссылки, открывающие новые окна: когда страница открывает ссылку в новом окне (например, ссылку с target="_blank"), VelaTerm открывает её в новой вкладке браузера.

Отдельные страницы: кнопка «Игровой центр» в правом конце панели вкладок открывает игровой центр VelaTerm как отдельную страницу. У отдельной страницы нет адресной строки и строки быстрого доступа — только кнопки «Назад», «Вперёд» и «Обновить»; ссылки, которые она открывает, остаются в той же вкладке.

Граница безопасности: встроенная страница рассматривается как обычный внешний сайт. Она не получает никаких разрешений и учётных данных VelaTerm, а открывать можно только адреса http и https.

3. Как сосуществуют вкладки разных типов

  • Вкладки сессий, документов и браузера находятся на одной панели вкладок, и ⌘1–9 переключает между всеми ними.
  • При открытии сессии из дерева повторно используются только вкладки сессий; вкладки документов и браузера никогда не заменяются.
  • Вкладки документов и браузера нельзя разделить на панели. ⌘W закрывает их сразу (документ с несохранёнными изменениями сначала запрашивает подтверждение).