Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

Команды

Что делает команда, когда вы её запускаете

Каждая команда завершается чем-то, что вы можете увидеть. Ничто не завершается успешно молча, потому что команда, которая ничего не говорит, выглядит точно так же, как команда, которая никогда не запускалась.

  • Выбор сущности Release меняет два индикатора и не вызывает уведомления. Вы уже видите результат, и уведомление об этом лишь приучило бы вас закрывать уведомления не читая.
  • Валидация и lint сообщают, сколько проблем они нашли, — в том числе когда не нашли ни одной. Чистый запуск так и сообщает, а не оставляет панель Problems нетронутой, заставляя вас гадать, была ли выполнена команда.
  • Создание черновика сущности и просмотр завершаются документом, открытым во вкладке. Показ конфигурации завершается панелью, а не документом, потому что он сообщает список настроек, который нужно прочитать сверху вниз, а не файл, который нужно сохранить.
  • Длительная операция показывает ход выполнения с кнопкой Cancel. Это касается всего, что обращается к реестру, отрисовывает или разрешает сущность Release, обходит каталог или запускает плагин над вашими входными данными: валидации, lint, сборки, предварительной сборки, графа топологии, загрузки, просмотра, отправки, подписи, пометки устаревшим и импорта. Создание черновика документа, отчёт о действующей конфигурации и обслуживание кэшей к этому не относятся, поэтому выполняются без неё. Кроме того, обслуживание кэша вообще нельзя прервать — у компилятора нет способа остановить его на полпути, — поэтому оно защищено предварительным подтверждением, а не кнопкой, которая могла бы лишь прекратить ожидание редактора.
  • Нажатие Cancel останавливает компилятор, а не только ожидание редактора. Через языковой сервер расширение отправляет отмену для выданного им запроса; через подпроцесс оно завершает процесс. Отмена компиляции вступает в силу на собственных границах фаз компиляции, поэтому уже идущая тяжёлая фаза сначала завершается, — вот почему сообщение говорит, что операция была остановлена, а не что она остановилась мгновенно. В любом случае результат сообщается как stopped, никогда как сбой.
  • Операция с кэшем, которая что-то удаляет, сначала спрашивает и называет кэши, которых она коснётся. Очистка и обрезка затрагивают собственные кэши этой рабочей области и кэши скомпилированных модулей и описаний плагинов, общие для всех проектов на этой машине, поэтому эти подтверждения называют и те, и другие. Сокращение затрагивает только общий кэш скомпилированных модулей, поэтому его подтверждение называет только его и сообщает, что собственные кэши рабочей области не затрагиваются. Затем сообщение говорит, что было удалено и сколько было оставлено на месте, потому что это открыто другим процессом, если такое есть; отказ сообщает, что ничего удалено не было.
  • Отправка, подпись и пометка устаревшим сообщают, что теперь верно для потребителей — что опубликованная вами версия — это то, что теперь получают другие, загружая её, что подпись на месте и может быть проверена, что маркер устаревания — это то, что теперь видят механизмы разрешения. Каждая из этих операций называет реестр, которого она достигла, и покинуло ли что-либо на самом деле эту машину, судя по тому, что сделал компилятор, а не по тому, что было запрошено, поэтому публикация, которая ничего не доставила, никогда не подаётся как доставившая.
  • Сбой показывает собственное сообщение компилятора с кнопкой рядом, а никогда не пересказанную сводку вместо него. Сообщение компилятора обычно называет, что запустить или что исправить, а кнопка Show output переводит вас к полному тексту в канале вывода Aggrega. Операция, которая запускает двоичный файл aggrega и получает отказ, называет статус, с которым завершился двоичный файл, а затем без изменений приводит слова, которые он написал при отказе, и канал вывода заканчивается тем же предложением, строка в строку. Просмотр, отклонённый из-за документа, который объявляет сущность, вместо этого предлагает Open document, потому что сообщение касается именно этого документа, а в канале больше ничего нет.

Команды

Палитра команд, отфильтрованная по командам Aggrega.

  • Aggrega: Get started — вернуть страницу приветствия после того, как вы её отключили, и открыть её. Команда снова включает aggrega.getStarted.show, поэтому отключение страницы — это выбор, который можно отменить, а не дверь, захлопнувшаяся за вами. Установка флажка внизу страницы снова включает ту же настройку и ничего не открывает: вы уже находитесь на этой странице, поэтому флажок сохраняет фокус клавиатуры, и клавиша Space поочерёдно устанавливает и снимает его. Значок дома в строке заголовка панели Commands — другое дело: он открывает страницу и не меняет никаких настроек, поэтому взгляд на страницу никогда не становится одновременно решением о запуске.

  • Aggrega: Stop opening the welcome page on startup — отключить открытие страницы приветствия при запуске, выключив aggrega.getStarted.show в ваших собственных настройках. Это прекращает её появление без запроса, но не делает её недоступной: Aggrega: Get started возвращает её. Снятие флажка внизу страницы запускает эту же команду, поэтому решение можно принять как из палитры, так и там, где страница читается.

  • Aggrega: Open settings — открыть параметры этого расширения. Также шестерёнка в правом верхнем углу панели Commands. Команда открывает собственную страницу настроек редактора, отфильтрованную по этому расширению, поэтому параметр хранится в одном месте и записывается в одном месте. Отличается от Show config, которая сообщает, что компилятор определил для рабочей области, а не то, как настроен ваш редактор.

  • Aggrega: Select Release… — выбрать сущность Release, с которой работает редактор. Вступает в силу сразу, повторно проверяет открытые файлы относительно неё и заставляет панель Catalog заново прочитать свой список; ничего не перезапускается. Также доступна по щелчку на индикаторе Release в строке состояния. См. Выбор Release.

  • Aggrega: Set the selected Release as this workspace’s default — записать выбранную сущность Release в .aggrega/active-release, чтобы последующий сеанс начинался с неё. Файл записывает языковой сервер, и он отказывает, своими словами, если .aggrega или маркер — это ссылка, ведущая за пределы рабочей области Aggrega. Действует локально для вашей рабочей копии и не меняет текущий выбор.

  • Aggrega: Set authoring_release in .aggrega-config.yaml… — открыть файл конфигурации, чтобы задать build.authoring_release — зафиксированное в репозитории значение по умолчанию, общее для команды. Оно имеет приоритет над файлом-маркером. Файл конфигурации, о котором языковой сервер сообщает как о ссылке, ведущей за пределы рабочей области Aggrega, не открывается, и ошибка объясняет почему.

  • Aggrega: Select Compiler Version — выбрать версию компилятора aggrega, которую запускает эта машина, из выпусков, с которыми работает это расширение, после подтверждаемого вами предупреждения; новая версия заменяет прежнюю только после того, как языковой сервер запустится на ней. См. Получение компилятора.

  • Aggrega: Start or restart the language server — запускает языковой сервер, если он не запущен, а если запущен — завершает его и запускает новый, сбрасывая счётчик попыток перезапуска. Команда никогда не исключается из палитры команд: запуск — это её назначение, поэтому скрывать её, когда ничего не запущено, означало бы скрывать её в единственной ситуации, где она нужна. Также доступна по щелчку на индикаторе языкового сервера в строке состояния. Если ни одна папка в окне не распознаётся Aggrega, команда сообщает об этом, а не создаёт впечатление, что ничего не делает.

  • Aggrega: Toggle the artifact-rendering stage while inspecting — переключает настройку aggrega.server.buildOnInspect на месте, так что интерфейс настроек всегда с ней согласован, и предлагает перезапуск, который её применяет, — языковой сервер читает настройку при запуске. Также доступна из меню быстрых действий в строке состояния, которое показывает, включена ли настройка сейчас. Этап добавляет рекомендации, которые aggrega build выдаёт при отрисовке, и ни одной из проверок, на которых сборка останавливается. Результаты приходят с пометкой слоя, который их выдал, поэтому рекомендации этапа группируются на панели Problems отдельно от валидации и очищаются независимо от неё. Перезапуск, применяющий изменение, очищает панель Problems и снова проверяет открытые файлы, поэтому при выключенном этапе его рекомендации исчезают с панели, а при включённом возвращаются при следующей отрисовке графа.

  • Aggrega: Validate active file / Build / Preview build / Lint — запустить соответствующую операцию компилятора через языковой сервер. Build, preview build и pull действуют на выбранную сущность Release, а не спрашивают её каждый раз. Build компилирует выбранную сущность Release со всеми включёнными проверками и записывает сгенерированные артефакты в каталог dist/ в вашей папке проекта, чтобы они оказались рядом с работой, которую вы решили открыть, — или, если папка проекта не выбрана либо выбранная папка не находится внутри вашего рабочего пространства Aggrega, в каталог dist/ в корне рабочего пространства Aggrega, — а завершающая строка сборки и её уведомление называют каталог, в который она записала. aggrega build, запущенная в терминале, записывает в каталог dist/ в корне рабочего пространства Aggrega, откуда бы её ни запустили, поэтому при папке проекта ниже этого корня редактор и терминал записывают в два разных каталога; preview build выполняет ту же компиляцию и сообщает, что она записала бы, не трогая выходной каталог.

    На панели Commands рядом с кнопкой Build есть стрелка под названием Build options, открывающая параметры, применяемые к следующей сборке, — Auto pull перед рендерингом разрешает зависимости выбранной сущности Release в файл блокировки и выключен, пока вы его не включите, что совпадает с собственным значением по умолчанию командной строки для того же выбора. Пока Build не может запуститься, стрелка остаётся на месте, затенённая, а наведение на неё показывает причину, по которой Build не может запуститься; она ничего не открывает, пока Build не сможет запуститься. Рядом с каждым параметром есть флажок — пустой, когда параметр выключен, отмеченный, когда включён, — так что его состояние можно прочитать, ничего не нажимая, а предложение, объясняющее, что делает его включение, появляется, когда вы наводите указатель на строку или дошли до неё клавишами со стрелками. Переключение параметра ничего не запускает и оставляет список открытым, так что можно переключить другой; нажатие Build — или снова стрелки — скрывает список. Параметры действуют в течение сеанса и нигде не записываются, поэтому закрытие окна отбрасывает их, и они принадлежат только Build: preview build сообщает, что записала бы сборка, ничего из этого не записывая, а разрешение зависимостей записывает файл блокировки, поэтому preview build не принимает никаких параметров.

    Обе помещают на панель Problems находки, у которых есть позиция в документе, помеченные уровнем, который их породил, — среди них отказ, который компилятор выдаёт при рендеринге, привязанный к документу, который он называет, например к сущности Recipe, сущность Workload которой он отклонил, а её короткий код открывает страницу с пояснением, тогда как сборка или предварительный просмотр завершается собственными словами компилятора в канале вывода и в уведомлении, — и записывают предупреждения, не называющие никакой позиции, — отозванный пин, неразрешимый родитель — в канал вывода Aggrega вместе со списком артефактов. Закрытие файла убирает его собственные находки с панели Problems и оставляет то, что нашли в нём сборка, предварительный просмотр или граф: они относятся к сущности Release, а не к файлу, который был открыт, поэтому остаются, пока компилятор не перестанет о них сообщать. Build, Preview или граф, которые компилятор отклоняет, потому что зависимость не разрешается, тоже помещают этот отказ на панель Problems — на документ, который называет компилятор, или на сущность Release, если он не называет никакого, — и отказ остаётся при открытии и закрытии этого файла, пока следующие Build, Preview или граф этой сущности Release не получат ответ без него.

    Сборка с Auto pull записывает перед ними, что сделало разрешение зависимостей: по строке на каждую закреплённую ссылку с версией, в которую она разрешилась, её видом, если компилятор его называет, и, если компилятор об этом сообщает, тем, откуда этот запуск взял ссылку, словом, которое для неё выводит aggrega pull --detail, — fetched-fresh, cache-reuse, local, in-binary или external, — а затем сводку, которую aggrega pull выводит в терминале, Pull complete:, за которым следуют записанный файл блокировки, названный от корня рабочего пространства, и количества того, что зафиксировало разрешение.

    Lint проверяет соглашения о публикации и помещает каждую находку на панель Problems, так что щелчок по ней открывает сущность, к которой она относится. Каждая помечена коротким кодом, который aggrega lint выводит для правила, её породившего, и метка открывает страницу с пояснением этого кода; правило без короткого кода помечается вместо этого собственным именем. Находка, привязанная к файлу, но не к строке, располагается в начале этого файла, а не в угаданной позиции, и каждая находка также записывается в канал вывода Aggrega под документом, к которому относится, в виде строки, которую aggrega lint для неё выводит: её серьёзность, короткий код правила, собственный идентификатор правила и собственная формулировка правила без изменений. Если ваша конфигурация задаёт своим сущностям Releases собственные директории каталога в workspace.releases, Lint проверяет каталог один раз для каждой сущности Release, по директориям, которые читает эта сущность Release, — сущности Releases, читающие одни и те же директории, проверяются вместе, — и сообщает о каждой проверке отдельно: канал вывода начинает её строкой, которой её начинает aggrega lint, называя её сущности Releases и прочитанные директории, и перечисляет под ней её находки; итоговое уведомление сообщает, что нашла каждая проверка и в скольких сущностях, для её собственных сущностей Releases; а каждая запись в Problems заканчивается названиями сущностей Releases, проверка которых её нашла, так что находка в директории, которую читают две проверки, указывается по одному разу для каждой.

    Все четыре сообщают, сколько находок они дали, в том числе когда ответ — ни одной, так что чистый запуск можно отличить от команды, которая не запускалась; все четыре во время работы показывают ход выполнения с кнопкой Cancel.

  • Aggrega: Pull — запустить бинарный файл aggrega для выбранной сущности Release и передавать его вывод потоком в канал вывода Aggrega. Команда разрешает в кэш зависимости каталога и исходников, объявленные сущностью Release, и записывает lock-файл для каждой сущности Release, фиксируя в нём внешние входные данные, которые потребляет отрисовка этой сущности Release, чтобы последующая сборка брала их из локального хранилища. Она обращается к реестру, поэтому показывает ход выполнения с кнопкой Cancel и завершается сообщением о том, что сделала. Build, Preview или открытый вами граф, которые компилятор отклоняет, потому что у сущности Release нет lock-файла, завершаются одним уведомлением: Aggrega: <release> has no lockfile., за которым следует собственная фраза компилятора, с кнопкой Pull: её нажатие запускает эту команду с бинарным файлом, настроенным в расширении, для сущности Release, названной компилятором, — или для выбранной сущности Release, если компилятор ничего не назвал, — а канал вывода содержит фразу компилятора в строке, которой завершается операция. Перерисовка, которую вы не запрашивали, например открытого графа после сохранения, выдаёт то же уведомление не чаще, чем позволяют две настройки aggrega.notifications. Что бы ни записало lock-файл выбранной сущности Release — эта команда, сборка с Auto pull или aggrega pull, введённая в терминале, — открытые файлы проверяются относительно него заново, и предупреждение о расхождении lock-файла само исчезает с панели Problems, как только запись его устранила: открытый для этой сущности Release граф перерисовывается, что снова проверяет lock-файл, а если ни один граф не показывает эту сущность Release — ни один не открыт или открытый всё ещё показывает ранее выбранную сущность Release, — расширение один раз запрашивает её граф, ничего не отрисовывая. Так отслеживается только lock-файл выбранной сущности Release и только внутри папок, открытых в окне; предупреждение для lock-файла другой сущности Release остаётся, пока вы не покажете граф этой сущности Release.

  • Aggrega: Draft entity… — выбрать вид из тех, которые поддерживает компилятор, затем запросить у языкового сервера начальный документ и открыть его в новой несохранённой вкладке. Виды запрашиваются, а не хранятся в расширении, поэтому выбор следует за запущенным у вас компилятором: новый вид, который он получает, предлагается без изменения этого расширения. Вы читаете имя, которое будет носить ваш документ, а черновик запрашивается по собственному токену компилятора для этого вида — и запрос, который затем спрашивает имя, говорит, какой вид он называет, теми же словами, которые вы только что прочитали. На диск ничего не записывается: черновик можно редактировать, сохранить или отбросить. Вызов с видом, который компилятор не распознаёт, — такой может содержать сочетание клавиш или записанный рабочий процесс, — возвращается с собственным сообщением компилятора, называющим виды, которые он распознаёт. Это также вторая строка панели Catalog, Draft entity.

  • Aggrega: Inspect… — выбрать сущность, видимую рабочей области, и посмотреть, во что она разрешается, в новой вкладке. Инспектирование адресуется по имени, поэтому сущность, разрешённая из настроенной директории каталога, предлагается здесь наряду с сущностью, объявленной в рабочей области. Разрешение выполняется в терминах выбранной сущности Release, и предлагаемые сущности — это те, которые панель Catalog перечисляет для этой сущности Release: имя, которое объявляют несколько вариантов, по одному на сущность Release, разрешается в вариант выбранной сущности Release, а имя, которое эта сущность Release не разрешает, сообщается как неразрешённое с причиной от компилятора, называющей запись этой сущности Release в workspace.releases. Если сущность Release не выбрана, разрешение идёт через собственные директории каталога рабочей области. Если документ в рабочей области объявляет сущность, а каталог ничего из него не разрешил — например, документ нарушает схему своего вида или находится вне всех директорий каталога, — уведомление сообщает, что сущность нельзя проинспектировать из-за документа, который её объявляет, затем приводит собственную фразу компилятора о том, что не так, а его кнопка Open document открывает этот документ; канал вывода Aggrega содержит ту же фразу. Инспектирование, отклонённое по любой другой причине, завершается так же, как любая неудачная операция. Чтение того, какие сущности содержит рабочая область, показывает ход выполнения и может быть остановлено, как и последующее разрешение. При нажатии на панели Commands сущности предлагаются в меню рядом с кнопкой; при запуске отсюда — в виде списка для выбора. Инспектирование, которое предлагает строка панели Catalog, — это то же самое, и оно завершается так же.

  • Aggrega: Import into Aggrega — см. Импорт в Aggrega.

  • Aggrega: Cache… — выбрать операцию с кэшем, затем выполнить её через языковой сервер. При нажатии на панели Commands четыре операции предлагаются в меню рядом с кнопкой; при запуске отсюда — в виде списка для выбора. Никакой процесс не порождается, и каждый ответ возвращается как структурированный результат, о котором сообщает панель: status перечисляет все кэши, их содержимое и степень общего доступа к каждому и ничего не удаляет; prune удаляет записи, на которые не ссылается ни один lock-файл, и называет то, что сохранил, вместе со всем, что у него не было оснований освободить, и операцией, которая это сделала бы; evict сначала запрашивает ограничение размера — величину в байтах, например 5GiB или 512MiB, или число байтов, которое читается тем же парсером, что и в командной строке, — и сокращает общий кэш скомпилированных модулей до него; clear очищает все кэши. Три операции, которые что-то удаляют, сначала просят подтверждения, и каждое подтверждение называет кэши, которых операция действительно касается: очистка касается собственных кэшей сущностей, исходных артефактов и внешних входных данных этой рабочей области и кэшей скомпилированных модулей, описаний плагинов, пакетов документации и плагинов CLI, общих для всех проектов на этой машине; prune касается тех же кэшей рабочей области и общих кэшей скомпилированных модулей, описаний плагинов и плагинов CLI; а сокращение касается только общего кэша скомпилированных модулей. Каждый размер, о котором сообщают эти операции, записывается в той же нотации, в которой читается ограничение, поэтому число из отчёта о кэше можно сразу ввести в запрос ограничения. Ограничение, которое компилятор не может прочитать, возвращается с собственным сообщением компилятора о том, как выглядит ограничение размера. Очищенные и сокращённые кэши заполняются заново при следующей сборке, которой они нужны. Windows отказывается удалять файл, открытый другим процессом, и тогда prune, сокращение или очистка оставляют его на месте и продолжают с остальным, а не завершаются ошибкой: канал вывода Aggrega называет каждую запись, оставленную prune или сокращением, с её классом, степенью общего доступа и размером, а для каждого кэша, которого коснулась очистка, указывает, сколько файлов там осталось и их размер; сообщение, которым завершается операция, говорит, сколько осталось на месте, просит выполнить операцию снова, когда этот процесс завершится, и указывает на канал, чтобы узнать, какие именно. Если ничего не осталось на месте, а так происходит при каждом запуске на платформе, которая удаляет открытый файл, ни то, ни другое об этом не упоминает.

  • Aggrega: Push… / Sign… / Deprecate… — операции, которые меняют то, что разрешают другие люди. Push спрашивает, какую из сущностей, перечисленных на панели Catalog, опубликовать — меню рядом с кнопкой на панели Commands, список для выбора при запуске отсюда, — затем упаковывает её и публикует в настроенный реестр. Sign и deprecate запрашивают ссылку на уже опубликованный артефакт, потому что обе изменяют опубликованные байты, а не рабочую область: sign прикрепляет подпись, deprecate прикрепляет подписанный маркер устаревания и запрашивает серьёзность — warning, error или retracted — и причину, которую он записывает. Все три обращаются к языковому серверу, все три показывают ход выполнения с кнопкой Cancel, которая прекращает публикацию, а не только ожидание, и каждая завершается указанием того, что компилятор действительно сделал: ссылки и версии, в которые разрешилась сущность, и дайджеста, на который теперь указывает эта версия, дайджеста, который фиксирует каждая подпись, или собственного дайджеста маркера. Публикация, обнаружившая, что те же байты уже опубликованы, сообщает об этом, а не отчитывается так, будто что-то опубликовала. Их результаты и полный отчёт направляются в канал вывода Aggrega.

  • Aggrega: Show config — открывает панель со списком всех настроек, объявленных схемой конфигурации; панель генерируется из этой схемы, поэтому у настроек, их имён, значений по умолчанию и допустимых значений ровно один источник, а новая настройка появляется без каких-либо изменений здесь. Панель открывается в виде таблицы с отдельной строкой для каждой настройки под строкой заголовка для каждой группы конфигурации — workspace, build, plugins, mcp, signing и остальных, — причём настройки верхнего уровня идут первыми. Каждая строка содержит настройку в том виде, в каком вы записали бы её в файле, её имя словами, её значение, то, что настройка принимает, и откуда взялось значение. Имя выводится из ключа: аббревиатура пишется заглавными буквами, а там, где имена двух настроек читались бы одинаково, добавляется группа, в которой находится каждая, поэтому никакие две строки не имеют одного имени. Единственный столбец значения показывает, что действует сейчас: значение, заданное в файле или в окружении, либо значение, не являющееся объявленным в схеме значением по умолчанию, отмечается ●, а наведение указателя на отметку объясняет причину и показывает объявленное значение по умолчанию — так можно найти изменённые вами настройки; настройка без действующего значения показывает none, а пустой список показывает [].

    Дополняющий компаньон списка — например, workspace.catalog_dirs_append рядом с workspace.catalog_dirs — не имеет собственной строки: он указан под путём своего списка, а строка списка показывает одно значение и один источник, которые отчёт компилятора приводит для обоих вместе, и из этого не видно, какие записи добавил компаньон. Настройка, принадлежащая машине, а не одному проекту, — реестр и его политика доверия к подписям, кеш скомпилированных модулей, список плагинов, добавляющих команды, — отмечена в своей строке как Global. Собственное описание настройки находится за небольшим кружком с пометкой i в последнем столбце с заголовком Description, что выносит из строки самый длинный элемент настройки: нажмите на него или наведите указатель, чтобы прочитать описание, в котором любой упомянутый код показан как код. Путь настройки переносится только после _ или ., а значение или путь к файлу — только после /, . или _ либо на пробеле, поэтому ничто не разрывается посреди слова.

    Таблица всё равно шире закреплённой панели и прокручивается в ней по горизонтали, а ключ настройки при этом остаётся на виду, поэтому рядом со значением, до которого вы прокрутили, всегда находится настройка, к которой оно относится; подпись над таблицей переносится по ширине панели. У каждого подписанного заголовка столбца на правом краю есть уголок изменения размера: перетащите его, чтобы расширить или сузить этот столбец. Расширение столбца не расширяет таблицу, поэтому столбец следует за указателем, пока у других столбцов есть место, которое они могут уступить, и останавливается, как только все они достигнут минимальной ширины; там, где панель слишком узка для таблицы даже при её минимальной ширине — например, при закреплении на боковой панели, — каждый столбец уже имеет эту ширину, и уголки ничего не сдвигают. Столбец перестаёт сужаться на самом широком фрагменте, который нельзя перенести, — своём заголовке, слове из имени настройки или части пути либо значения между двумя местами, где допустим перенос, — а столбец настройки сохраняет собственную минимальную ширину; всё остальное в суженном столбце переносится внутри него, а не заходит на следующий. Панель не выполняет никаких скриптов, и из этого следуют три ограничения: заданная вами ширина сохраняется лишь до перерисовки панели, поэтому переключение на другой вид, повторное нажатие Show config или повторное открытие панели заново рисует каждый столбец с шириной, которую ему даёт таблица; столбец нельзя по запросу подогнать под содержимое ни двойным щелчком, ни иначе; а до уголка можно добраться указателем, но не клавиатурой.

    Элемент управления над таблицей переключает на второй вид, в котором каждая настройка получает собственный блок, с описанием и областью действия, показанными на месте, и правилом для отметки Global, изложенным в начале; панель снова открывается в том виде, который вы использовали последним. Каждая настройка показывает действующее значение и, если компилятор может это сообщить, из какого файла это значение взято. Отчёт компилятора указывает источник каждой настройки, а для компаньона списка — в строке самого списка; там, где он нигде не называет настройку, — например, если отчёт не удалось прочитать, — панель прямо об этом сообщает, а не намекает на источник, которого у неё нет: такая настройка показывается со своим объявленным значением по умолчанию, отмеченным как объявление, а не как прочитанное значение, и без источника, а блок в начале панели перечисляет каждую из них.

    Нажатие Show config при открытой панели выводит её на передний план и заново читает конфигурацию. Если конфигурацию прочитать не удаётся, нажатие закрывает панель, была она открыта или нет, и одно уведомление объясняет причину; если причина в том, что языковой сервер не запущен, уведомление предлагает Start, что выполняет Aggrega: Start or restart the language server. Панель сообщает; она не записывает. Изменить настройку — значит отредактировать файл конфигурации.

  • Aggrega: Show topology graph — открывает граф топологии для выбранной сущности Release. Чтобы нарисовать его, эта сущность Release компилируется до топологии, поэтому отображается ход выполнения с кнопкой Cancel.

  • Aggrega: Attach a Feature to the connection at the cursor — подключает сущность Feature к соединению из записи этого соединения в вашем документе. Команда доступна в контекстном меню редактора и в палитре команд, причём только в документе, который языковой сервер считает одной из сущностей Aggregates или Releases рабочей области. Она спрашивает у языкового сервера, внутри записи какого соединения находится курсор, — в терминах выбранной сущности Release, как и другие функции курсора: это запись, которой компонент проводит соединение под псевдонимом соединения, или запись, которую сущность Release пишет для соединения. На такой записи команда открывает граф топологии для выбранной сущности Release с выделенным соединением, и вы подключаете из его раздела May attach, как после щелчка по ребру соединения, с той лишь разницей, что запись пишется в документ, в котором вы выполнили команду. В любом другом месте она ничего не открывает и объясняет причину: курсор не находится внутри записи соединения, соединение провела сущность Feature, или запись сущности Release относится к соединению, которого нет в её скомпилированном графе. Если сущность Release не выбрана, команда предлагает выбрать её, как это делает Aggrega: Show topology graph, а отказ языкового сервера показывается его собственными словами. Несохранённые изменения сначала отправляются языковому серверу, поэтому положение курсора определяется по тому тексту, который вы видите.

  • Aggrega: Search published catalog — открывает список фильтров, позволяет сузить поиск по произвольному тексту, виду, меткам, возможности, сокету плагина или ограничению числа результатов, затем выполнить его и скопировать найденную ссылку. Каждый параметр можно редактировать в любом порядке, после чего происходит возврат к списку, так что весь фильтр можно прочитать до запуска. Пока расширение работает в окне, список открывается с фильтром, оставшимся от последнего поиска, а Reset search filter, расположенная прямо над Search, очищает все параметры без поиска. Поиск, не нашедший ничего, называет выполненный фильтр и, если у настроенного реестра ещё нет индекса, реестры, в которых он искал, затем те, в которых не искал, и как построить их индекс; это другой ответ, чем у индекса, который вообще не удалось прочитать, — во втором случае сообщается собственное сообщение компилятора, а полный текст отправляется в канал вывода Aggrega вместе со строкой актуальности, где указан каждый просмотренный реестр и время последнего обновления его индекса. Эта команда также является первой строкой панели Catalog — Search catalog.

  • Aggrega: Refresh plugins — перезагружает панель Plugins.

  • Aggrega: Refresh registries — заново читает настроенные реестры. При этом ни к одному реестру не выполняется обращение, поэтому повторять это недорого.

  • Aggrega: Refresh workspace catalog — заново спрашивает у языкового сервера, какие сущности видны рабочей области. Команда читает рабочую область, которую сервер уже открыл, и не обращается ни к одному реестру, поэтому повторять её недорого. Панель сама спрашивает заново, когда языковой сервер становится доступен для ответа, когда меняется выбранная сущность Release, после того как документ создан, изменён или удалён на диске, и после того как редактор закрывает документ, так что эта команда нужна для того, что ни один из этих случаев не охватывает, например для изменения, которое ещё находится в несохранённом буфере. Она расположена в строке заголовка панели Catalog и является там единственным элементом: она перечитывает этот список, а не действует на его содержимое, поэтому относится к панели, а не к рабочей области.