Настройки
Шестерёнка в правом верхнем углу панели Commands открывает их — это собственная страница настроек редактора, отфильтрованная по этому расширению, и другого интерфейса настроек нет. Всё перечисленное ниже также доступно из обычного редактора Settings и из вашего файла настроек.

Каждая из этих настроек принадлежит вам, а не проекту. Каждая описывает ваше собственное окружение или ваши привычки чтения — где находится ваш бинарный файл, сколько ждать перед повторной валидацией, сколько перезапусков допускать, показывать ли значения, которые можно прочитать через ваше плечо, как вы хотите видеть отрисовку панели, — поэтому каждая ограничена вашими пользовательскими настройками, а при работе на удалённом или контейнеризованном хосте — вашими удалёнными настройками. Последнее особенно важно для пути к бинарному файлу: компилятор запускается на том же хосте, что и расширение, поэтому путь может различаться на вашем ноутбуке и в контейнере, и каждый хост хранит собственное значение.
Это следствие намеренное: репозиторий не может закрепить ни одну из этих настроек для того, кто его открывает. Запись такой настройки в .vscode/settings.json рабочей области не имеет эффекта — редактор помечает её как неприменимую там и продолжает использовать ваше значение. Если вы хотите, чтобы выбор был записан в самой рабочей области, это делают две команды для сущности Release из раздела Выбор Release, и они записывают .aggrega/active-release или .aggrega-config.yaml, а не настройку редактора.
| Настройка | По умолчанию | Назначение |
|---|---|---|
aggrega.getStarted.show | true | Открывается ли страница приветствия при запуске. Эту одну настройку меняют три элемента интерфейса, и они остаются согласованными: флажок внизу самой страницы, Aggrega: Stop opening the welcome page on startup и Aggrega: Get started. Отключение прекращает открытие страницы, а не удаляет её; повторное включение с помощью Aggrega: Get started также открывает её. |
aggrega.server.binaryPath | aggrega | Путь к двоичному файлу aggrega. Простое имя ищется в PATH; путь, начинающийся с ~/ (~\ в Windows) или ${userHome}, читается из вашей домашней папки на хосте, где работает расширение; любой другой путь используется так, как записан. |
aggrega.server.debounceMs | 300 | Окно устранения дребезга для упреждающей валидации при изменении. |
aggrega.server.respawnAttempts | 5 | Сколько раз в пределах окна, указанного ниже, языковой сервер запускается снова после того, как он остановился без запроса, прежде чем расширение оставит его остановленным и выдаст уведомление о том, что сервер перестал отвечать. Повторно запущенный сервер, остановившийся до того, как ответил, учитывается так же, как остановившийся во время работы. См. Жизненный цикл. |
aggrega.server.respawnWindowSeconds | 180 | Скользящее окно в секундах, в пределах которого подсчитываются эти перезапуски. |
aggrega.server.restartGraceSeconds | 5 | Льготное окно перед тем, как расширение автоматически перезапустит языковой сервер после изменения binaryPath. Строка состояния показывает обратный отсчёт; меню быстрых действий предлагает Restart now и Cancel restart. |
aggrega.server.buildOnInspect | false | Запускать этап отрисовки артефактов при инспектировании графа, чтобы рекомендации, которые aggrega build выдаёт при отрисовке, также отображались как проблемы в редакторе. Он не добавляет ни одной из проверок, на которых сборка останавливается. Инспектирование при этом обходится дороже; на диск ничего не записывается. |
aggrega.graph.showSensitiveValues | false | Показывать в графе топологии значения, которые сущность Feature объявляет чувствительными, отображая учётные данные, передаваемые по значению, в открытом виде; пока настройка включена, запрос графа запрашивает их у языкового сервера. Если она выключена, языковой сервер не включает их в отправляемый граф, и они снова удаляются перед отрисовкой графа. |
aggrega.operations.layout | buttons | Как панель Commands отрисовывает свои группы — buttons помещает все операции в один переносимый поток кнопок, ничего не рисуя между группами, sections делает каждую группу разделом, раскрываемым под собственным заголовком. В обоих случаях группы, операции и порядок одинаковы. |
aggrega.notifications.toastDebounceMode | time | Как часто уведомление о том, что у сущности Release нет lock-файла, показывается повторно для работы, которую вы не запрашивали, например для открытого графа, перерисованного после сохранения: time показывает его снова, когда с момента закрытия предыдущего прошло toastThrottleSeconds, session показывает его один раз до перезапуска языкового сервера. Build, Preview или открытый вами граф, отклонённые из-за отсутствия lock-файла, всегда показывают уведомление. |
aggrega.notifications.toastThrottleSeconds | 300 | Число секунд после закрытия уведомления об отсутствии lock-файла, прежде чем оно будет показано снова для работы, которую вы не запрашивали. Читается, только когда toastDebounceMode равно time. |