跳转到内容
AggregaAggrega
选择语言: 简体中文
本页面由机器翻译。阅读英文原文。

安装 Aggrega

Aggrega 需要两样东西:已安装的 aggrega 二进制文件,以及(如果要借助 AI 助手编写)已连接到该二进制文件所带 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 客户端

你的 AI 助手的客户端通过运行 aggrega mcp 启动 Aggrega 的 MCP 服务器,连接 MCP 服务器逐个客户端给出添加它的命令或条目。在会安装插件的助手中,Aggrega 插件会一步添加服务器和 Aggrega 技能:参见安装插件。

各种安装方式详解

Aggrega 以单个可执行文件的形式发布。一条命令即可安装它;其后的手动步骤以手工方式完成同样的操作。两种方式都会把它放在你自己的一个文件夹中,每次都是同一个,且都不需要管理员权限:在 Linux 和 macOS 上是 ~/.local/bin/aggrega,在 Windows 上是 %LOCALAPPDATA%\Programs\aggrega\aggrega.exe。在 Windows 上,Windows 安装程序和 winget 会把它安装到同一个文件夹中,同样不需要管理员权限,并将其列入你已安装的应用:参见使用 Windows 安装程序安装和使用 winget 安装。macOS 和 Linux 上的 Homebrew 以及 Windows 上的 Scoop 也能安装它,各自安装到自己的文件夹中:参见使用包管理器安装。

使用一条命令安装

安装命令在 Linux 和 macOS 上是 curl -fsSL https://aggrega.ai/install.sh | sh,在 Windows 的 PowerShell 中是 irm https://aggrega.ai/install.ps1 | iex,即安装二进制文件中的前两条命令。这两个地址会重定向到最新版本附带的安装脚本,因此同样的命令也可以使用该版本自身的地址运行:

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

该命令执行的操作:

  • 它从最新版本中为你的机器选择默认二进制文件:64 位 x86 或 64 位 ARM 上的 Linux 和 macOS,以及 64 位 x86 上的 Windows。对于其他任何系统或处理器,它都会拒绝,并给出一条消息,说明它检测到的是什么,或应改用什么方式。在搭载 Apple 芯片的 Mac 上,即使在通过 Rosetta 2 运行的 shell 中,它也会选择 Apple 芯片二进制文件。
  • 它根据该版本的 SHA256SUMS 校验二进制文件,然后才安装任何内容。如果下载文件的 SHA-256 摘要与列表中给出的不同,该文件会被删除,不安装任何内容,命令会停止并给出一条列出两个摘要的消息。
  • 它只为你一人安装二进制文件:在 Linux 和 macOS 上安装为 ~/.local/bin/aggrega,在 Windows 上安装为 %LOCALAPPDATA%\Programs\aggrega\aggrega.exe;文件夹不存在时会创建它,并一步替换其中较早的副本,因此再次运行该命令即可更新你已有的副本。它从不使用 sudo。在 Windows 上,它还会移除从互联网下载的文件可能带有的标记,就像手动步骤中的 Unblock-File 所做的那样。在 macOS 上,它使用 curl 下载,因此它安装的二进制文件不带隔离标记(参见 macOS 预构建二进制文件)。
  • 它使命令可被找到。 在 Linux 和 macOS 上,如果该文件夹不在你的 PATH 中,它会打印一条命令,将该文件夹加入你的 shell 启动时读取的文件:zsh 为 ~/.zshrc,bash 为 ~/.bashrc(macOS 上为 ~/.bash_profile),fish 为 ~/.config/fish/config.fish(使用一行 fish_add_path),其他任何 shell 为 ~/.profile。它不会自行运行该命令:请运行它并打开一个新终端。在 Windows 上,如果该文件夹不在你的用户 PATH 中,它会将其加入,同时也加入它所运行的 PowerShell 窗口的 PATH,因此 aggrega 可以在该窗口以及之后打开的每个终端中运行,并且它会说明已加入该文件夹。
  • 它检查已安装的二进制文件能否运行,如果不能运行,就在设置任何其他内容之前给出一条消息并停止。当你的 PATH 中有另一个 aggrega 排在它所安装的那个之前时,它会附加一条提示。
  • 它会打印已安装的版本,通过完整路径运行它所安装的二进制文件,因此在你的 PATH 包含该文件夹之前就能显示版本。
  • 最后它会给出后续步骤,列在 Next: 下,每步一行:运行 AI 快速入门的命令,如入门所述;aggrega skills install --global,它会将 Aggrega 技能添加到你机器上的 AI 助手中,如安装时添加助手技能所述;以及本页的地址,用于 shell 补全和上文的连接 MCP 客户端。如果某个选项已经安装了该技能,则省略对应的那一行。

它打印的内容很简短:版本及其安装所针对的系统、下载内容与其校验和匹配后的一行,以及它的安装路径。入门展示了一次完整运行。--verbose 与下文的选项一样在 sh -s -- 之后给出,它还会打印校验和列表的地址、发布文件的名称以及下载该文件的地址;install.ps1 有相同的开关 -Verbose,用于带参数运行脚本,而 irm … | iex 无法为其提供参数。当命令拒绝执行或某个步骤失败时,它会用一行说明:install.sh 输出到标准错误,install.ps1 则以 PowerShell 显示的错误或警告形式给出:

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

安装时设置 shell 补全

使用 --completion 时,install.sh 还会设置 shell 补全,让 Tab 键能补全 aggrega 的命令和标志。选项写在 sh -s -- 之后,它会把选项交给 sh 从管道读取的脚本:

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

irm … | iex 不会向脚本传递任何选项。在 PowerShell 中,请在安装完成后使用 aggrega completion powershell 写出的脚本设置补全,如Shell 补全所述。install.ps1 也接受 -Completion,用于带参数运行脚本。

它只为你一人设置补全,无需管理员权限,针对你的 SHELL 设置所指定的 shell;在 PowerShell 中则针对它所运行的那个 PowerShell。它使用已安装二进制文件自身的 aggrega completion 写出的脚本,并列出它写入或更改的每个文件:

  • bash:它将脚本写入 ~/.local/share/bash-completion/completions,即 bash-completion 软件包读取你自己的补全的文件夹。aggrega 的 Bash 补全需要该软件包。
  • 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 会按各 shell 的读取方式移动这些文件夹和文件。新的终端或窗口会加载补全。再次运行该命令时,只有当已安装的 aggrega 写出不同的脚本时才会重写脚本,并且只会向 ~/.zshrc 或配置文件添加一次这些行;这也是为已有的安装添加补全的方法,因为该命令会顺带重新安装二进制文件。

安装时添加助手技能

使用 --skills(在 PowerShell 中为 -Skills)时,安装命令还会为你机器上的 AI 助手,在你的每个项目中安装 Aggrega 技能——即教 AI 助手安装和使用 Aggrega 的说明。两个选项可以同时给出:

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 Code 的 ~/.claude/skills/aggrega,它们都位于你的主目录下。再次运行该命令会替换之前运行写入的副本,技能正是以这种方式随二进制文件更新到新版本。aggrega skills 介绍该命令、每个助手读取的文件夹,以及每个助手是通过什么找到的。

某个步骤无法完成时

当无法设置补全时——它不支持设置的 shell(例如 dash)、它无法写入的文件夹,或不运行任何配置文件的 PowerShell 执行策略——或无法安装技能时——未找到助手且未指定任何助手、它不认识的标识符,或技能文件夹中存在并非由安装写入的文件——二进制文件仍会被安装并可以运行。该命令会说明步骤失败的原因,打印后续步骤,并以表明哪个步骤失败的状态结束。各状态如下:

状态含义
0aggrega 已安装,且选项要求的每个步骤都已成功
1未安装任何内容,或已安装的 aggrega 未能运行
2命令收到了它不接受的选项,或未指定任何助手的列表;它什么也没做
3aggrega 已安装并可运行,但设置 shell 补全失败
4aggrega 已安装并可运行,但安装技能失败
5aggrega 已安装并可运行,但这两项都失败了

PowerShell 脚本从不关闭它运行所在的窗口,因此它将状态留在 $LASTEXITCODE 中,除 0 以外的每个状态都以错误结束,powershell -Command 和 pwsh -Command 会将其报告为退出状态 1。

使用 Windows 安装程序安装

每个版本都在发布页面 https://github.com/aggrega-ai/aggrega-cli/releases 上附带一个 Windows 安装程序 aggrega-<version>-windows-amd64-setup.exe。下载并运行它。它通过一个简短的向导,只为你一人安装默认的 aggrega.exe,不需要管理员权限,也不会请求管理员权限:

  • 欢迎页面,然后是许可证,即 Aggrega 的 Apache License 2.0:在你按下 I Agree 之前不会安装任何内容。然后是组件:Aggrega 本身,始终安装;以及 Add to PATH,已选中。
  • 安装文件夹,即 %LOCALAPPDATA%\Programs\aggrega,除非你另选一个;它就是安装命令使用的文件夹。
  • 进度,然后是完成页面,它给出该文件夹,说明此次安装是否已将其加入你的 PATH,并列出后续步骤:用 aggrega skills install --global 安装 Aggrega 技能,以及按照连接 MCP 客户端中的说明连接你的 AI 客户端。

它的作用:

  • 选中 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 formula 和一个 Scoop 清单,因此你已在使用的包管理器可以安装 Aggrega 并使其保持最新。两者安装的都是与安装命令相同的默认二进制文件,并根据该版本的 SHA256SUMS 为其给出的 SHA-256 摘要进行校验。

在 macOS 和 Linux 上,brew install aggrega-ai/tap/aggrega 使用 Homebrew 安装它。Homebrew 会在首次使用时添加 aggrega-ai/tap tap,并为你的系统和处理器安装二进制文件:Apple 芯片或 Intel 上的 macOS,64 位 x86 或 64 位 ARM 上的 Linux。新版本发布后,brew upgrade 会连同你安装的其他所有 formula 一起更新它。

在 Windows 上使用 Scoop 时,先通过 scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucket 添加一次 Aggrega bucket,再通过 scoop install aggrega 从中安装。Scoop 将 Windows 二进制文件安装为 aggrega.exe,并通过它在你的 PATH 中维护的 shim 文件夹使其可以作为 aggrega 被找到。新版本发布后,scoop update 会刷新 bucket,scoop update aggrega 会更新它。

Homebrew 和 Scoop 各自安装到自己的文件夹中,而不是 ~/.local/bin 或 %LOCALAPPDATA%\Programs\aggrega,并且只更新它们自己安装的副本。在一台机器上请只使用一种安装方式:由安装命令或手动安装的副本与由 Homebrew 或 Scoop 安装的副本是两个副本,你的 PATH 中哪个文件夹排在前面,就决定运行哪一个。

使用 winget 安装

在 Windows 上,winget install Cognitio.Aggrega 使用 Windows 程序包管理器 winget 安装它。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。

手动安装

每个版本都在发布页面 https://github.com/aggrega-ai/aggrega-cli/releases 上附带适用于 Linux(64 位 x86 和 64 位 ARM)、Windows(64 位 x86)以及 macOS(Apple 芯片和 Intel)的预构建二进制文件。下载适用于你的操作系统和处理器的可执行文件(下文的选择文件列出了每一个),并按该节所述根据该版本的 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 中,请将以下这一行添加到你的 shell 启动时读取的文件中(zsh 为 ~/.zshrc,bash 为 ~/.bashrc,macOS 上为 ~/.bash_profile),然后打开一个新终端:

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

从源码构建:安装 Go 工具链后,从源码树构建 aggrega 命令,并将生成的二进制文件放到同一个文件夹中。

使用 aggrega version 确认安装,与安装二进制文件末尾的做法相同。

选择文件

版本中每个可执行文件的名称为 aggrega-<version>-<system>-<processor>,在 Windows 上带有 .exe:

系统处理器文件
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 芯片aggrega-<version>-darwin-arm64
macOSIntelaggrega-<version>-darwin-amd64

该文件就是安装命令所安装的文件,也是手动安装时应下载的文件。它旁边还有两个变体;安装命令不会安装其中任何一个,二者都可按相同方式手动安装:

  • aggrega-debug-<version>-… 是带有调试信息的同一程序,供调试器或性能分析器读取。它的运行方式和版本报告与默认文件完全相同,只是体积更大。
  • aggrega-light-<version>-… 在构建时不包含内嵌插件:它按照工作区的配置,通过插件级联解析每个插件,而不是在自身内部找到核心插件。

对于 Windows,版本还附带 aggrega-<version>-windows-amd64-setup.exe,即 Windows 安装程序,它会为你安装默认文件。

每个版本还附带 SHA256SUMS,其中以 sha256sum 可读取的格式列出它附带的其他所有文件(包括两个安装脚本)的 SHA-256 摘要。安装命令会自行执行此检查。要在 Linux 上手动检查下载的文件,请将 SHA256SUMS 放在同一目录中:

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

你下载的文件会被报告为 OK;任何其他报告都意味着它不是该版本发布的文件。

Windows 预构建二进制文件

Windows 可执行文件为 aggrega-<version>-windows-amd64.exe(版本中与其并列的 debug 和 light 变体安装方式相同)。将其重命名为 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 已保护你的电脑 检查正是依据该标记。在 PowerShell 中运行 Unblock-File(如上例所示)即可移除该标记;在文件资源管理器中,文件 属性 的 常规 选项卡上的 解除锁定 复选框也有同样效果。
  • 如果开启了智能应用控制(Windows 11),它会在你启动程序时进行检查。按照 Microsoft 的描述,智能应用控制首先询问 Microsoft 的云安全服务该程序是否安全;当该服务无法做出有把握的预测时,它会检查签名,允许具有有效签名的程序运行,并阻止未签名或签名无效的程序。是否开启可在 Windows 安全中心的 应用和浏览器控制 下查看。

macOS 预构建二进制文件

macOS 可执行文件为 aggrega-<version>-darwin-arm64(适用于搭载 Apple 芯片的 Mac)和 aggrega-<version>-darwin-amd64(适用于搭载 Intel 处理器的 Mac);Apple 菜单中的 关于本机 会显示你使用的是哪一种。版本中与其并列的 debug 和 light 变体安装方式相同。搭载 Apple 芯片的 Mac 在安装了 Rosetta 2 时也能运行 Intel 文件,但 Apple 芯片文件才是专为其构建的。

将文件重命名为 aggrega,标记为可执行,并移动到安装命令使用的文件夹 ~/.local/bin 中。例如,在终端中进入下载文件所在的目录,将 <version> 替换为你下载的版本,在 Intel Mac 上将 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 不在 macOS 为新终端提供的 PATH 中,因此请将手动安装中的那一行添加到 ~/.zshrc(bash 则为 ~/.bash_profile),除非其中已有该行。

这些可执行文件已签名并经过公证。 每个文件都带有使用 Cognitio s.r.l. 的 Developer ID(Apple 向开发者颁发、用于在 Mac App Store 之外分发软件的证书)生成的代码签名,启用了强化运行时并带有安全时间戳,且 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 不会像浏览器那样添加该标记。这也是安装命令放置的二进制文件无需经过该评估即可运行的原因。