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

aggrega version

aggrega version выводит версию CLI aggrega.

Вывод

По умолчанию aggrega version выводит строку с версией в удобочитаемом виде.

С -o json команда выдаёт машиночитаемый объект с отступом в два пробела, в той же структуре, которую каждая команда aggrega использует для вывода JSON. Читайте его парсером JSON; потребитель, который вместо этого сопоставляет текст, должен удалять пробельные символы перед сопоставлением, поскольку контрактом являются имена полей, а окружающее форматирование — нет.

{
"version": "1.2.3",
"committed": "2026-07-09T18:07:57Z",
"commit": "a1b2c3d",
"abiVersion": "v1beta1",
"goVersion": "go1.23.0",
"platform": "linux/amd64"
}

Поля берутся из метаданных сборки, встроенных в исполняемый файл. committed — это временная метка коммита, и она присутствует, только если сборка её записала. abiVersion — это версия ABI плагинов, которую поддерживает исполняемый файл; конвейер может прочитать её, чтобы проверить совместимость плагинов, не загружая плагин. Отладочная сборка без встроенной версии сообщает значение-маркер (например, (devel)), а не завершается с ошибкой.

Когда использовать -o json

  • Расширение редактора сравнивает версию, которую сообщает демон, с версией, для которой оно было собрано, чтобы обнаружить несовместимый исполняемый файл aggrega serve до начала работы с ним.
  • Инструменты CI и отслеживания происхождения записывают точную сборку компилятора, которая создала артефакт.

См. также

  • ./aggrega-serve.md — демон, версию которого клиент проверяет на совместимость.

Синтаксис

aggrega version [flags]

Описание

Print the aggrega CLI's build identity.
By default the output is a single human-readable line followed by a
one-line pointer to the plugins compiled into the binary. With
-o json, the output is a structured JSON object suitable for
programmatic consumption (the VS Code extension uses this form to
read the binary's version at activation time), in the same indented
shape every aggrega command's JSON output uses.
With --verbose, the output replaces the pointer line with a table of
the embedded plugins — type, name, served capabilities, and commit —
under a header naming the count and their shared version. With
--verbose -o json, the JSON object gains an embeddedPlugins array
carrying the same detail.
Version strings are v-less (1.0.0, not v1.0.0), homogeneous with the
version form catalog entities use. Tagged release builds report the
release version, a build stamped with a version reports that version,
and a build carrying no version stamp reports the literal "(devel)",
which marks an unreleased build.

Флаги

ФлагПо умолчаниюОписание
--output, -otextФормат вывода: text|json.
--verbosefalseвключить в вывод набор встроенных плагинов