Перейти до вмісту
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 у меню Apple показує, який у вас. Налагоджувальний і полегшений варіанти поруч із ними в релізі встановлюються так само. Mac з Apple silicon також запускає файл для Intel через Rosetta 2, якщо її встановлено, але саме файл для Apple silicon зібрано для нього.

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

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 не додає позначку, яку додає браузер. Із цієї самої причини бінарний файл, який розміщує команда встановлення, запускається без цієї оцінки.