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

Установка Aggrega

Aggrega нужны две вещи: установленный бинарный файл aggrega и — чтобы писать файлы с помощью ИИ-ассистента — клиент вашего ассистента, подключённый к MCP-серверу, который содержит бинарный файл. Сначала приведены команды; что делает каждая из них и другие способы установки описаны после них.

Установка исполняемого файла

В Linux и macOS, в терминале:

Terminal window
curl -fsSL https://aggrega.ai/install.sh | sh

В Windows, в PowerShell:

Terminal window
irm https://aggrega.ai/install.ps1 | iex

С помощью Homebrew, в macOS и Linux:

Terminal window
brew install aggrega-ai/tap/aggrega

С помощью Scoop, в Windows:

Terminal window
scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucket
scoop install aggrega

С помощью winget, в Windows:

Terminal window
winget install Cognitio.Aggrega

Затем проверьте, что он запускается:

Terminal window
aggrega version

Строка с версией означает, что бинарный файл найден и запускается. Это всё, что нужно MCP-серверу. Раздел Подробно о каждом способе установки описывает, что делает каждая команда, куда она помещает бинарный файл и как установить его установщиком Windows или вручную.

Подключение клиента MCP

Клиент вашего ИИ-ассистента запускает MCP-сервер Aggrega, выполняя aggrega mcp, а страница Подключение MCP-сервера приводит для каждого клиента команду или запись, которая его добавляет. В ассистенте, который устанавливает плагины, плагин Aggrega добавляет сервер и навык Aggrega за один шаг: см. Установка плагина.

Подробно о каждом способе установки

Aggrega поставляется в виде одного исполняемого файла. Его устанавливает одна команда; описанные после неё ручные шаги делают то же самое вручную. Оба способа помещают его в одну и ту же вашу собственную папку и ни один не требует прав администратора: ~/.local/bin/aggrega в Linux и macOS и %LOCALAPPDATA%\Programs\aggrega\aggrega.exe в Windows. В Windows установщик Windows и winget устанавливают его в ту же папку, тоже без прав администратора, и добавляют в список установленных приложений: см. Установка с помощью установщика Windows и Установка с помощью winget. Homebrew в macOS и Linux и Scoop в Windows тоже устанавливают его, каждый в свои папки: см. Установка с помощью менеджера пакетов.

Установка одной командой

Команда установки — это curl -fsSL https://aggrega.ai/install.sh | sh в Linux и macOS и irm https://aggrega.ai/install.ps1 | iex в PowerShell в Windows, первые две команды из раздела Установка исполняемого файла. Эти два адреса перенаправляют на скрипты установки, приложенные к последнему выпуску, поэтому те же команды работают и с собственными адресами выпуска:

Terminal window
curl -fsSL https://github.com/aggrega-ai/aggrega-cli/releases/latest/download/install.sh | sh
Terminal window
irm https://github.com/aggrega-ai/aggrega-cli/releases/latest/download/install.ps1 | iex

Что делает команда:

  • Она выбирает исполняемый файл по умолчанию для вашей машины из последнего выпуска: Linux и macOS на 64-битной x86 или 64-битной ARM, Windows на 64-битной x86. Любую другую систему или процессор она отклоняет с сообщением о том, что обнаружено, или о том, к чему обратиться вместо этого. На Mac с Apple silicon она выбирает файл для Apple silicon, даже из оболочки, работающей через Rosetta 2.
  • Она проверяет исполняемый файл по SHA256SUMS выпуска, прежде чем что-либо устанавливать. Загруженный файл, SHA-256-дайджест которого отличается от указанного в списке, удаляется, ничего не устанавливается, и команда останавливается с сообщением, в котором приведены оба дайджеста.
  • Она устанавливает исполняемый файл только для вас: как ~/.local/bin/aggrega в Linux и macOS и как %LOCALAPPDATA%\Programs\aggrega\aggrega.exe в Windows, создавая папку, если её нет, и заменяя находящуюся там прежнюю копию за один шаг, поэтому повторный запуск команды обновляет имеющуюся у вас копию. Она никогда не использует sudo. В Windows она также снимает метку, которую может нести файл, загруженный из интернета, как это делает Unblock-File в ручных шагах. В macOS она загружает файл с помощью curl, поэтому устанавливаемый исполняемый файл не имеет метки карантина (см. Готовый исполняемый файл для macOS).
  • Она делает команду доступной. В Linux и macOS, если папки нет в вашем PATH, она выводит команду, которая добавляет папку в файл, читаемый вашей оболочкой при запуске: ~/.zshrc для zsh, ~/.bashrc для bash (~/.bash_profile в macOS), ~/.config/fish/config.fish для fish, со строкой fish_add_path, и ~/.profile для любой другой оболочки. Сама она эту команду не выполняет: выполните её и откройте новый терминал. В Windows она добавляет папку в ваш пользовательский PATH, если её там нет, и в PATH окна PowerShell, в котором работает, поэтому aggrega запускается в этом окне и в каждом терминале, открытом после него, и сообщает, что добавила папку.
  • Она проверяет, что установленный исполняемый файл запускается, и, если он не запускается, останавливается с сообщением, прежде чем настраивать что-либо ещё. Она добавляет примечание, если в вашем PATH перед установленным ею файлом находится другой aggrega.
  • Она выводит установленную версию, запуская установленный ею исполняемый файл по полному пути, так что версия отображается ещё до того, как ваш PATH включит эту папку.
  • В конце она выводит следующие шаги, под Next:, по одной строке на каждый: команду, которая запускает быстрый старт с ИИ, как описано на странице Начало работы; aggrega skills install --global, которая добавляет навык Aggrega ИИ-ассистентам на вашей машине, как описано в разделе Добавление навыка ассистента при установке; и адрес этой страницы — для автодополнения в оболочке и раздела Подключение MCP-клиента выше. Если одна из опций уже установила навык, строка для него опускается.

Выводит она немного: версию и систему, для которой выполняется установка, строку, как только загруженный файл совпадёт со своей контрольной суммой, и путь, куда выполнена установка. Страница Начало работы показывает полный запуск. --verbose, переданный после sh -s --, как и опции ниже, также выводит адрес списка контрольных сумм, имя файла релиза и адрес, с которого он загружается; у install.ps1 есть тот же переключатель в виде -Verbose, для запуска скрипта с аргументами, которые irm … | iex передать ему не может. Если команда отказывается работать или шаг завершается ошибкой, она сообщает об этом одной строкой: в стандартный поток ошибок у install.sh и в виде ошибки или предупреждения, которые показывает PowerShell, у install.ps1:

aggrega install: error: <what went wrong> - <what to do>

Скрипту для Linux и macOS, install.sh, нужны curl или wget, uname, а также sha256sum или shasum. Скрипт для Windows, install.ps1, работает в Windows PowerShell 5.1 и в PowerShell 7.

Две настройки меняют то, что она устанавливает; каждая читается из окружения, в котором выполняется скрипт:

  • AGGREGA_VERSION задаёт выпуск для установки, например 0.8.7, с ведущей v или без неё. Если переменная не задана, команда устанавливает последний выпуск — тот, который GitHub помечает как последний (latest); он никогда не бывает предварительным, поэтому предварительный выпуск устанавливается, только если указать его здесь.
  • AGGREGA_INSTALL_DIR задаёт папку для установки вместо папки по умолчанию. Исполняемый файл в ней называется aggrega, в Windows — aggrega.exe, и команда делает эту папку доступной, как описано выше.

В Linux и macOS указывайте настройку перед sh, а не перед curl, чтобы её получил скрипт:

Terminal window
curl -fsSL https://aggrega.ai/install.sh | AGGREGA_VERSION=<version> sh

В PowerShell сначала задайте её в окне; она остаётся заданной там, пока вы не удалите её командой Remove-Item Env:AGGREGA_VERSION:

Terminal window
$env:AGGREGA_VERSION = "<version>"
irm https://aggrega.ai/install.ps1 | iex

Настройка автодополнения в оболочке при установке

С --completion скрипт install.sh также настраивает автодополнение в оболочке, чтобы клавиша Tab дополняла команды и флаги aggrega. Опции указываются после sh -s --, что передаёт их скрипту, который sh читает из конвейера:

Terminal window
curl -fsSL https://aggrega.ai/install.sh | sh -s -- --completion

irm … | iex не передаёт скрипту никаких опций. В PowerShell настройте автодополнение после завершения установки с помощью скрипта, который записывает aggrega completion powershell, как описано в разделе Автодополнение в оболочке. install.ps1 также принимает -Completion для запуска скрипта с аргументами.

Она настраивает автодополнение только для вас, без прав администратора, для оболочки, которую называет ваша настройка SHELL, а в PowerShell — для того PowerShell, в котором работает. Она использует скрипт, который записывает собственная команда aggrega completion установленного бинарного файла, и называет каждый файл, который записывает или изменяет:

  • bash: записывает скрипт в ~/.local/share/bash-completion/completions — папку, из которой пакет bash-completion читает ваши собственные дополнения. Автодополнению Bash для aggrega нужен этот пакет.
  • zsh: записывает _aggrega в ~/.local/share/zsh/site-functions и добавляет в ~/.zshrc три строки, которые помещают эту папку в путь функций zsh и загружают её, запуская compinit, если ничто в файле не запустило его раньше.
  • fish: записывает aggrega.fish в ~/.config/fish/completions, которую fish читает самостоятельно.
  • PowerShell: записывает скрипт как %LOCALAPPDATA%\aggrega\completion.ps1 и добавляет две загружающие его строки в ваш профиль для всех хостов того PowerShell, в котором работает, — $PROFILE.CurrentUserAllHosts. Windows PowerShell и PowerShell 7 хранят отдельные профили, поэтому запустите команду из каждого, которым пользуетесь. Профиль выполняется только тогда, когда политика выполнения, которую получает новое окно, — RemoteSigned, Unrestricted или Bypass; при любой другой, например Restricted, она ничего не записывает и сообщает, какую политику обнаружила. Политику она никогда не меняет.

XDG_DATA_HOME, XDG_CONFIG_HOME, BASH_COMPLETION_USER_DIR и ZDOTDIR перемещают эти папки и файлы так, как их читает каждая оболочка. Автодополнение загружается в новом терминале или окне. Повторный запуск команды перезаписывает скрипт, только если установленный aggrega записывает другой, и добавляет строки в ~/.zshrc или профиль только один раз; так же можно добавить автодополнение к уже имеющейся установке, поскольку команда попутно заново устанавливает бинарный файл.

Добавление навыка ассистента при установке

С --skills (-Skills в PowerShell) команда установки также устанавливает навык Aggrega — инструкции, которые учат AI-ассистента устанавливать и использовать Aggrega, — во все ваши проекты для AI-ассистентов на вашем компьютере. Оба параметра можно указать вместе:

Terminal window
curl -fsSL https://aggrega.ai/install.sh | sh -s -- --completion --skills

В PowerShell, где irm … | iex не передаёт никаких опций, после завершения установки выполните aggrega skills install --global: именно эту команду запускает -Skills.

Она запускает собственную команду установленного исполняемого файла aggrega skills install --global, которая ищет ассистентов на вашем компьютере — каждого, чья папка конфигурации находится в вашем домашнем каталоге или чья команда есть в вашем PATH, — и выводит каждого найденного ассистента и то, по чему он найден. Затем:

  • В терминале она сначала спрашивает. Нажмите Enter, чтобы установить навык для найденных ассистентов, или введите идентификаторы других, чтобы добавить их, через пробел или запятую; идентификаторы выводит aggrega skills list. При curl … | sh скрипт читает себя из канала, поэтому вместо этого спрашивает через ваш терминал.
  • Когда нет терминала, через который можно спросить, как в скрипте, она устанавливает навык для найденных ассистентов.
  • Чтобы выбрать ассистентов самостоятельно, укажите их после параметра через запятую: --skills claude-code,cursor или --skills=claude-code,cursor, а в PowerShell — -Skills claude-code,cursor. Тогда она устанавливает навык для них и не ищет других.

Она выводит каждую записанную папку навыка, например ~/.claude/skills/aggrega для Claude Code; все они находятся в вашем домашнем каталоге. Повторный запуск команды заменяет копии, записанные предыдущим запуском, — так навык следует за исполняемым файлом к более новой версии. aggrega skills описывает команду, папку, которую читает каждый ассистент, и то, по чему находят каждого из них.

Когда шаг не удаётся выполнить

Когда не удаётся настроить автодополнение — оболочка, которую она не настраивает, например dash, папка, в которую она не может записывать, или политика выполнения PowerShell, при которой не запускается ни один профиль, — или не удаётся установить навык — не найдено и не указано ни одного ассистента, неизвестный ей идентификатор или файл в папке навыка, записанный не установкой, — исполняемый файл всё равно установлен и запускается. Команда сообщает, почему шаг не удался, выводит следующие шаги и завершается со статусом, указывающим, какой шаг не удался. Статусы:

СтатусЗначение
0aggrega установлен, и каждый шаг, запрошенный параметром, выполнен успешно
1ничего не установлено, или установленный aggrega не запустился
2команде передан параметр, который она не принимает, или список, не называющий ни одного ассистента; она ничего не сделала
3aggrega установлен и запускается, но настроить автодополнение оболочки не удалось
4aggrega установлен и запускается, но установить навык не удалось
5aggrega установлен и запускается, но оба этих шага не удались

Скрипт PowerShell никогда не закрывает окно, в котором работает, поэтому оставляет статус в $LASTEXITCODE, и каждый статус, кроме 0, завершается ошибкой, которую powershell -Command и pwsh -Command сообщают как код выхода 1.

Установка с помощью установщика Windows

Каждый выпуск содержит установщик Windows, aggrega-<version>-windows-amd64-setup.exe, на странице выпусков https://github.com/aggrega-ai/aggrega-cli/releases. Скачайте и запустите его. Он устанавливает aggrega.exe по умолчанию только для вас, без прав администратора и не запрашивая их, с помощью короткого мастера:

  • Страница приветствия, затем лицензия Aggrega, Apache License 2.0: ничего не устанавливается, пока вы не нажмёте I Agree. Затем компоненты: сам Aggrega, устанавливаемый всегда, и Add to PATH, отмеченный.
  • Папка установки, %LOCALAPPDATA%\Programs\aggrega, если вы не выберете другую; это папка, которую использует команда установки.
  • Ход установки, затем завершающая страница, которая называет папку и сообщает, добавила ли эта установка её в ваш PATH, со следующими шагами: установить навык Aggrega командой aggrega skills install --global и подключить ваш AI-клиент, как описано в разделе Подключение MCP-клиента.

Что он делает:

  • Когда Add to PATH отмечен, он добавляет папку установки в ваш пользовательский PATH, если её там ещё нет. Терминал, открытый после установки, находит aggrega; уже открытый терминал сохраняет PATH, с которым был запущен. Если отметка снята, в ваш PATH ничего не добавляется, и терминал запускает aggrega.exe по полному пути; запись, добавленная предыдущей установкой, остаётся как есть.
  • Он добавляет Aggrega в список установленных приложений с издателем Cognitio s.r.l., поэтому удаляется он через Параметры → Приложения, как любое другое приложение. Программа удаления просит подтверждения, а затем удаляет файлы, которые установщик поместил в папку, запись в PATH и запись в этом списке, а также удаляет папку, если в ней больше ничего не осталось.
  • При повторном запуске он устанавливается поверх имеющегося, предлагая папку, в которую устанавливал в последний раз, поэтому установщик более позднего выпуска обновляет имеющуюся у вас копию, сохраняя одну запись в вашем PATH.
  • Рядом с aggrega.exe в папке находятся uninstall.exe, LICENSE с текстом лицензии и EnVar.dll — компонент, с помощью которого установщик и программа удаления редактируют ваш PATH.

Когда aggrega.exe запущен — редактором или AI-клиентом, — установщик не может его заменить и останавливается с соответствующим сообщением; закройте то, что его запустило, и запустите установщик снова. Программа удаления останавливается так же, ещё ничего не удалив.

Чтобы установить без окна, из скрипта или из инструмента, устанавливающего программы на множество машин, запустите установщик с ключом /S, записанным заглавной буквой; тогда он устанавливает без окна и без вопросов в папку, которую использовала предыдущая установка, а иначе в папку по умолчанию, с Add to PATH, и сообщает о сбое кодом выхода, отличным от 0. Программа удаления принимает тот же ключ:

Terminal window
.\aggrega-<version>-windows-amd64-setup.exe /S
& "$env:LOCALAPPDATA\Programs\aggrega\uninstall.exe" /S

Установщик подписан так же, как исполняемые файлы, с издателем Cognitio S.r.l. и меткой времени: проверки из раздела Готовый исполняемый файл для Windows применимы к нему так же, как к aggrega.exe, как и сказанное там о запросах, которые Windows может показать для загруженного файла. SHA256SUMS содержит его дайджест, как и дайджест любого другого файла выпуска.

Если установщик не подходит, команда установки выше и ручные шаги устанавливают тот же aggrega.exe в ту же папку.

Установка с помощью менеджера пакетов

Каждый выпуск также обновляет формулу Homebrew и манифест Scoop, поэтому менеджер пакетов, которым вы уже пользуетесь, может установить Aggrega и поддерживать его в актуальном состоянии. Каждый из них устанавливает тот же исполняемый файл по умолчанию, что и команда установки, проверяя его по SHA-256-дайджесту, который указан для него в SHA256SUMS выпуска.

В macOS и Linux brew install aggrega-ai/tap/aggrega устанавливает его с помощью Homebrew. Homebrew при первом запуске добавляет tap aggrega-ai/tap и устанавливает исполняемый файл для вашей системы и процессора: macOS на Apple silicon или Intel, Linux на 64-битной x86 или 64-битной ARM. После нового выпуска brew upgrade обновляет его вместе со всеми остальными установленными формулами.

В Windows с помощью Scoop один раз добавьте bucket Aggrega командой scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucket и устанавливайте из него командой scoop install aggrega. Scoop устанавливает исполняемый файл для Windows как aggrega.exe и делает его доступным как aggrega через папку shim-файлов, которую держит в вашем PATH. После нового выпуска scoop update обновляет bucket’ы, а scoop update aggrega обновляет Aggrega.

Homebrew и Scoop устанавливают каждый в свои папки, а не в ~/.local/bin или %LOCALAPPDATA%\Programs\aggrega, и обновляют только установленную ими копию. Используйте на машине один способ установки: копия, установленная командой установки или вручную, и копия, установленная Homebrew или Scoop, — это две копии, и то, какая из них запускается, определяет папка, стоящая в вашем PATH первой.

Установка с помощью winget

В Windows winget install Cognitio.Aggrega устанавливает его с помощью winget, диспетчера пакетов Windows. winget загружает установщик Windows выпуска с его страницы, проверяет его по SHA-256-дайджесту, указанному в манифесте пакета, и запускает в автоматическом режиме. Результат тот же, что и у самого установщика: aggrega.exe в %LOCALAPPDATA%\Programs\aggrega или в папке, которую использовала предыдущая установка, эта папка в вашем пользовательском PATH и Aggrega в списке установленных приложений — всё без прав администратора. winget не меняет PATH терминала, в котором работает, поэтому перед запуском aggrega version откройте новый терминал.

winget upgrade Cognitio.Aggrega устанавливает поверх более поздний выпуск, а winget uninstall Cognitio.Aggrega запускает программу удаления. winget, установщик и команда установки устанавливают в одну и ту же папку, если в установщике не выбрать другую, поэтому aggrega.exe в ней оставляет тот, кто запущен последним.

Установка вручную

Каждый выпуск содержит готовые исполняемые файлы для Linux на 64-битной x86 и на 64-битной ARM, для Windows на 64-битной x86 и для macOS на Apple silicon и на Intel на странице выпусков https://github.com/aggrega-ai/aggrega-cli/releases. Скачайте исполняемый файл для вашей операционной системы и процессора — каждый из них назван ниже в разделе Выбор файла — и проверьте его по SHA256SUMS выпуска, как описано там. Затем сделайте его исполняемым и переместите в ~/.local/bin/aggrega. В Linux, из каталога со скачанным файлом, заменив <version> на скачанную версию, а на 64-битной ARM — amd64 на arm64:

Terminal window
chmod +x aggrega-<version>-linux-amd64
mkdir -p ~/.local/bin
mv aggrega-<version>-linux-amd64 ~/.local/bin/aggrega

Для Windows см. раздел Готовый исполняемый файл для Windows ниже; для macOS — Готовый исполняемый файл для macOS.

Если ~/.local/bin нет в вашем PATH, добавьте эту строку в файл, который ваша оболочка читает при запуске, — ~/.zshrc для zsh, ~/.bashrc для bash (~/.bash_profile в macOS), — и откройте новый терминал:

Terminal window
export PATH="$HOME/.local/bin:$PATH"

Из исходного кода: установив инструментарий Go, соберите команду aggrega из дерева исходного кода и поместите полученный исполняемый файл в ту же папку.

Проверьте установку командой aggrega version, как в конце раздела Установка исполняемого файла.

Выбор файла

Выпуск называет каждый исполняемый файл aggrega-<version>-<system>-<processor>, с .exe в Windows:

СистемаПроцессорФайл
Linux64-битная x86 (uname -m выводит x86_64)aggrega-<version>-linux-amd64
Linux64-битная ARM (uname -m выводит aarch64)aggrega-<version>-linux-arm64
Windows64-битная x86aggrega-<version>-windows-amd64.exe
macOSApple siliconaggrega-<version>-darwin-arm64
macOSIntelaggrega-<version>-darwin-amd64

Именно этот файл устанавливает команда установки, и именно его нужно скачивать вручную. Рядом с ним лежат два его варианта; команда установки не устанавливает ни один из них, и каждый устанавливается вручную тем же способом:

  • aggrega-debug-<version>-… — та же программа с отладочной информацией, которую читает отладчик или профилировщик. Она работает и сообщает свою версию точно так же, как файл по умолчанию, и имеет больший размер.
  • aggrega-light-<version>-… собран без встроенных плагинов: он разрешает каждый плагин через каскад плагинов, как его настраивает рабочее пространство, а не находит основные плагины внутри себя.

Для Windows выпуск также содержит aggrega-<version>-windows-amd64-setup.exe — установщик Windows, который устанавливает для вас файл по умолчанию.

Каждый выпуск также содержит SHA256SUMS — SHA-256-дайджест каждого другого прикреплённого к нему файла, включая оба скрипта установки, в формате, который читает sha256sum. Команда установки выполняет эту проверку сама. Чтобы проверить загруженный файл вручную в Linux, когда SHA256SUMS лежит в том же каталоге:

Terminal window
sha256sum --check --ignore-missing SHA256SUMS

Для скачанного файла выводится OK; любой другой результат означает, что это не тот файл, который опубликован в выпуске.

Готовый исполняемый файл для Windows

Исполняемый файл для Windows — aggrega-<version>-windows-amd64.exe (отладочный и облегчённый варианты рядом с ним в выпуске устанавливаются так же). Переименуйте его в aggrega.exe, переместите в %LOCALAPPDATA%\Programs\aggrega — папку, которую использует команда установки, — и добавьте эту папку в пользовательскую переменную PATH: Windows запускает файл с окончанием .exe, не требуя делать его исполняемым, и находит его под этим именем как команду aggrega. Например, в PowerShell, заменив <version> на скачанную версию:

Terminal window
$dir = "$env:LOCALAPPDATA\Programs\aggrega"
New-Item -ItemType Directory -Force $dir | Out-Null
Move-Item ".\aggrega-<version>-windows-amd64.exe" "$dir\aggrega.exe"
Unblock-File "$dir\aggrega.exe"
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$dir", "User")

Терминал, открытый после этого, находит aggrega; уже открытый терминал сохраняет тот PATH, с которым был запущен.

Исполняемые файлы подписаны. Каждый содержит подпись Authenticode — подпись кода, которую проверяет Windows, и издателем Windows показывает Cognitio S.r.l. Каждая подпись также содержит метку времени: сертификат, стоящий за подписью, действителен лишь несколько дней, и именно метка времени сохраняет подпись действительной после истечения срока сертификата. Чтобы проверить скачанный файл перед запуском:

  • В Проводнике откройте Свойства файла и вкладку Цифровые подписи. В списке подписей указано Cognitio S.r.l.; выберите её, а затем Сведения — там будет сообщение Эта цифровая подпись действительна.

  • В PowerShell, с $dir, как в примере выше:

    Terminal window
    $signature = Get-AuthenticodeSignature "$dir\aggrega.exe"
    $signature.Status
    $signature.SignerCertificate.Subject

    Status сообщает Valid, а субъект начинается с CN=Cognitio S.r.l.. NotSigned или HashMismatch означает, что файл не тот, который был опубликован в выпуске, или был изменён после подписания.

Подпись указывает издателя, но не устраняет все предупреждения. Какое из них вы увидите, зависит от того, как файл был получен и как вы его запускаете:

  • При скачивании браузер может предупредить, что файл скачивают нечасто, и спросить, сохранить ли его. Если сохранить, файл будет сохранён в скачанном виде.
  • При запуске из Проводника или из браузера Windows может показать сообщение Система Windows защитила ваш компьютер. Это сообщение выводит Microsoft Defender SmartScreen, который учитывает репутацию, накопленную файлом и его издателем, поэтому новая версия, даже подписанная, может вызывать его, пока у неё не накопится собственная репутация. Для подписанного файла сообщение указывает издателя: выберите Подробнее, убедитесь, что указаны Cognitio S.r.l. и имя скачанного файла, затем выберите Выполнить в любом случае. При запуске из PowerShell или командной строки тот же файл может запуститься без этого сообщения; так ли это, зависит от версии Windows и её настроек.
  • Unblock-File заранее снимает это сообщение. Скачанный файл помечается как полученный из интернета, и именно на эту метку реагирует проверка Система Windows защитила ваш компьютер. Unblock-File в PowerShell, как в примере выше, удаляет метку; то же делает флажок Разблокировать на вкладке Общие в Свойствах файла в Проводнике.
  • Если включена функция Smart App Control (Windows 11), она проверяет программу при запуске. Согласно описанию Microsoft, Smart App Control сначала запрашивает у облачной службы безопасности Microsoft, безопасна ли программа; если служба не может дать уверенный прогноз, проверяется подпись: программа с действительной подписью запускается, а неподписанная или с недействительной подписью блокируется. Включена ли функция, показано в разделе Управление приложениями и браузером в окне «Безопасность Windows».

Готовый исполняемый файл для macOS

Исполняемые файлы для macOS — aggrega-<version>-darwin-arm64 для Mac с Apple silicon и aggrega-<version>-darwin-amd64 для Mac с процессором Intel; какой у вас Mac, показывает пункт Об этом Mac в меню Apple. Отладочный и облегчённый варианты рядом с ними в выпуске устанавливаются так же. Mac с Apple silicon запускает и файл для Intel — через Rosetta 2, если она установлена, — но собран для него именно файл для Apple silicon.

Переименуйте файл в aggrega, сделайте его исполняемым и переместите в ~/.local/bin — папку, которую использует команда установки. Например, в Терминале, в каталоге со скачанным файлом, заменив <version> на скачанную версию, а на Mac с Intel — arm64 на amd64:

Terminal window
chmod +x aggrega-<version>-darwin-arm64
mkdir -p ~/.local/bin
mv aggrega-<version>-darwin-arm64 ~/.local/bin/aggrega

mkdir создаёт папку, если её ещё нет. ~/.local/bin не входит в PATH, который macOS задаёт новому терминалу, поэтому добавьте строку из раздела Установка вручную в ~/.zshrc или, для bash, в ~/.bash_profile, если её там ещё нет.

Исполняемые файлы подписаны и нотаризованы. Каждый несёт подпись кода, сделанную с Developer ID компании Cognitio s.r.l. — сертификатом, который Apple выдаёт разработчику для программ, распространяемых вне Mac App Store, — с защищённой средой выполнения (hardened runtime) и защищённой меткой времени, а служба нотаризации Apple проверила и нотаризовала каждый из них. Gatekeeper, проверка macOS для программ из интернета, оценивает программу с меткой карантина — меткой, которую веб-браузер добавляет к скачанному файлу, — и принимает программу, нотаризованную Apple, поэтому файл, скачанный со страницы выпусков, запускается как есть. Билет нотаризации нельзя прикрепить к отдельному исполняемому файлу, поэтому Gatekeeper находит билет в сети при первом запуске файла; на Mac, который в этот момент не подключён к сети, Gatekeeper может блокировать файл, пока Mac не сможет связаться с Apple.

Чтобы проверить скачанный файл перед запуском, выполните в Терминале, указав имя скачанного файла:

Terminal window
codesign --verify --strict --verbose=2 aggrega-<version>-darwin-arm64
codesign --display --verbose=2 aggrega-<version>-darwin-arm64

Первая команда сообщает, что файл valid on disk и satisfies its Designated Requirement. Вторая перечисляет удостоверяющие центры подписи, первый из которых — Developer ID Application: COGNITIO SRL с идентификатором команды в скобках, и Timestamp. Файл, не прошедший любую из проверок, — не тот, который опубликован в выпуске, или был изменён после подписания.

Файл, загруженный с помощью curl, не имеет метки карантина, поэтому Gatekeeper его вообще не оценивает: curl не добавляет метку, как это делает браузер. По этой же причине исполняемый файл, который размещает команда установки, запускается без этой оценки.