Установка Aggrega
Aggrega нужны две вещи: установленный бинарный файл aggrega и — чтобы писать файлы с помощью ИИ-ассистента — клиент вашего ассистента, подключённый к MCP-серверу, который содержит бинарный файл. Сначала приведены команды; что делает каждая из них и другие способы установки описаны после них.
Установка исполняемого файла
В Linux и macOS, в терминале:
curl -fsSL https://aggrega.ai/install.sh | shВ Windows, в PowerShell:
irm https://aggrega.ai/install.ps1 | iexС помощью Homebrew, в macOS и Linux:
brew install aggrega-ai/tap/aggregaС помощью Scoop, в Windows:
scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucketscoop install aggregaС помощью winget, в Windows:
winget install Cognitio.AggregaЗатем проверьте, что он запускается:
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, первые две команды из раздела Установка исполняемого файла. Эти два адреса перенаправляют на скрипты установки, приложенные к последнему выпуску, поэтому те же команды работают и с собственными адресами выпуска:
curl -fsSL https://github.com/aggrega-ai/aggrega-cli/releases/latest/download/install.sh | shirm 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, чтобы её получил скрипт:
curl -fsSL https://aggrega.ai/install.sh | AGGREGA_VERSION=<version> shВ PowerShell сначала задайте её в окне; она остаётся заданной там, пока вы не удалите её командой Remove-Item Env:AGGREGA_VERSION:
$env:AGGREGA_VERSION = "<version>"irm https://aggrega.ai/install.ps1 | iexНастройка автодополнения в оболочке при установке
С --completion скрипт install.sh также настраивает автодополнение в оболочке, чтобы клавиша Tab дополняла команды и флаги aggrega. Опции указываются после sh -s --, что передаёт их скрипту, который sh читает из конвейера:
curl -fsSL https://aggrega.ai/install.sh | sh -s -- --completionirm … | 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-ассистентов на вашем компьютере. Оба параметра можно указать вместе:
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, при которой не запускается ни один профиль, — или не удаётся установить навык — не найдено и не указано ни одного ассистента, неизвестный ей идентификатор или файл в папке навыка, записанный не установкой, — исполняемый файл всё равно установлен и запускается. Команда сообщает, почему шаг не удался, выводит следующие шаги и завершается со статусом, указывающим, какой шаг не удался. Статусы:
| Статус | Значение |
|---|---|
0 | aggrega установлен, и каждый шаг, запрошенный параметром, выполнен успешно |
1 | ничего не установлено, или установленный aggrega не запустился |
2 | команде передан параметр, который она не принимает, или список, не называющий ни одного ассистента; она ничего не сделала |
3 | aggrega установлен и запускается, но настроить автодополнение оболочки не удалось |
4 | aggrega установлен и запускается, но установить навык не удалось |
5 | aggrega установлен и запускается, но оба этих шага не удались |
Скрипт 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. Программа удаления принимает тот же ключ:
.\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:
chmod +x aggrega-<version>-linux-amd64mkdir -p ~/.local/binmv aggrega-<version>-linux-amd64 ~/.local/bin/aggregaДля Windows см. раздел Готовый исполняемый файл для Windows ниже; для macOS — Готовый исполняемый файл для macOS.
Если ~/.local/bin нет в вашем PATH, добавьте эту строку в файл, который ваша оболочка читает при запуске, — ~/.zshrc для zsh, ~/.bashrc для bash (~/.bash_profile в macOS), — и откройте новый терминал:
export PATH="$HOME/.local/bin:$PATH"Из исходного кода: установив инструментарий Go, соберите команду aggrega из дерева исходного кода и поместите полученный исполняемый файл в ту же папку.
Проверьте установку командой aggrega version, как в конце раздела Установка исполняемого файла.
Выбор файла
Выпуск называет каждый исполняемый файл aggrega-<version>-<system>-<processor>, с .exe в Windows:
| Система | Процессор | Файл |
|---|---|---|
| Linux | 64-битная x86 (uname -m выводит x86_64) | aggrega-<version>-linux-amd64 |
| Linux | 64-битная ARM (uname -m выводит aarch64) | aggrega-<version>-linux-arm64 |
| Windows | 64-битная x86 | aggrega-<version>-windows-amd64.exe |
| macOS | Apple silicon | aggrega-<version>-darwin-arm64 |
| macOS | Intel | aggrega-<version>-darwin-amd64 |
Именно этот файл устанавливает команда установки, и именно его нужно скачивать вручную. Рядом с ним лежат два его варианта; команда установки не устанавливает ни один из них, и каждый устанавливается вручную тем же способом:
aggrega-debug-<version>-…— та же программа с отладочной информацией, которую читает отладчик или профилировщик. Она работает и сообщает свою версию точно так же, как файл по умолчанию, и имеет больший размер.aggrega-light-<version>-…собран без встроенных плагинов: он разрешает каждый плагин через каскад плагинов, как его настраивает рабочее пространство, а не находит основные плагины внутри себя.
Для Windows выпуск также содержит aggrega-<version>-windows-amd64-setup.exe — установщик Windows, который устанавливает для вас файл по умолчанию.
Каждый выпуск также содержит SHA256SUMS — SHA-256-дайджест каждого другого прикреплённого к нему файла, включая оба скрипта установки, в формате, который читает sha256sum. Команда установки выполняет эту проверку сама. Чтобы проверить загруженный файл вручную в Linux, когда SHA256SUMS лежит в том же каталоге:
sha256sum --check --ignore-missing SHA256SUMSДля скачанного файла выводится OK; любой другой результат означает, что это не тот файл, который опубликован в выпуске.
Готовый исполняемый файл для Windows
Исполняемый файл для Windows — aggrega-<version>-windows-amd64.exe (отладочный и облегчённый варианты рядом с ним в выпуске устанавливаются так же). Переименуйте его в aggrega.exe, переместите в %LOCALAPPDATA%\Programs\aggrega — папку, которую использует команда установки, — и добавьте эту папку в пользовательскую переменную PATH: Windows запускает файл с окончанием .exe, не требуя делать его исполняемым, и находит его под этим именем как команду aggrega. Например, в PowerShell, заменив <version> на скачанную версию:
$dir = "$env:LOCALAPPDATA\Programs\aggrega"New-Item -ItemType Directory -Force $dir | Out-NullMove-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.SubjectStatusсообщает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:
chmod +x aggrega-<version>-darwin-arm64mkdir -p ~/.local/binmv aggrega-<version>-darwin-arm64 ~/.local/bin/aggregamkdir создаёт папку, если её ещё нет. ~/.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.
Чтобы проверить скачанный файл перед запуском, выполните в Терминале, указав имя скачанного файла:
codesign --verify --strict --verbose=2 aggrega-<version>-darwin-arm64codesign --display --verbose=2 aggrega-<version>-darwin-arm64Первая команда сообщает, что файл valid on disk и satisfies its Designated Requirement. Вторая перечисляет удостоверяющие центры подписи, первый из которых — Developer ID Application: COGNITIO SRL с идентификатором команды в скобках, и Timestamp. Файл, не прошедший любую из проверок, — не тот, который опубликован в выпуске, или был изменён после подписания.
Файл, загруженный с помощью curl, не имеет метки карантина, поэтому Gatekeeper его вообще не оценивает: curl не добавляет метку, как это делает браузер. По этой же причине исполняемый файл, который размещает команда установки, запускается без этой оценки.