安装 Aegis

选择应用

平台	主要安装资产	用途
macOS	`Aegis-<version>-macos-arm64.dmg`	主桌面应用、Core 控制、Local Gateway、Workbench、Chat、移动端配对。
Windows	`Aegis-<version>-windows-x64.zip`	主桌面应用、Core 控制、Local Gateway、Workbench、Chat、移动端配对。
iPhone / iPad	TestFlight 或签名后的 `Aegis-<version>-ios.ipa`	移动端 Chat、审批、通知、分享/语音/位置上下文、Native Node work。
Android	签名后的 `Aegis-<version>-android.apk` 或 `Aegis-<version>-android.aab`	移动端 Chat、审批、通知、分享/语音/位置上下文、Native Node work。

下载

从 HaloForgeAI/aegis-release 下载最新 release 资产。若 release 提供 SHA256SUMS，安装前先校验。

下载 Aegis-<version>-macos-arm64.dmg。
打开 DMG。
将 Aegis.app 拖入 Applications。
启动 Aegis，并按需授权你希望 Aegis 使用的系统权限。
在桌面应用里启动 Core、查看健康状态，并配对移动设备。

macOS 应用是主要 owner 入口。它应包含桌面 shell 和本地运行所需的 Core/CLI runtime，然后从应用内提供 Workbench、Chat、Local Gateway 和移动端配对。

生成 pairing link 前，先根据网络访问选择移动设备要使用的 Core URL。

下载 Aegis-<version>-windows-x64.zip。
解压到可信的本地文件夹。
从解压后的 app package 启动 Aegis。
在桌面应用里启动 Core、查看健康状态，并配对移动设备。

当前已验证的 Windows release 资产是 Windows App SDK / WinUI 原生应用的 ZIP package。MSIX 和 MSI 属于安装器后续项；在 release CI 真正产出签名安装器之前，不应该把它们写成已可用安装方式。

生成 pairing link 前，先根据网络访问选择移动设备要使用的 Core URL。

有 TestFlight 链接时优先使用 TestFlight。
直接测试时，通过 Apple Configurator、Xcode Devices 或 owner 批准的 MDM 路径安装签名后的 Aegis-<version>-ios.ipa。
打开 Aegis，通过二维码、setup link，或手动 Core URL 加 scoped node token 完成配对。
只在你希望启用对应能力时授权 iOS 权限。

iOS IPA 导出需要 Apple signing asset 和 provisioning profile。Personal Team 足够做 owner 真机测试；更广泛的 TestFlight/App Store 分发需要已加入 Apple Developer Program 的 team。

直接安装使用签名后的 Aegis-<version>-android.apk；走 Play Console 类分发时使用 Aegis-<version>-android.aab。
如果 sideload APK，只安装来自可信 Aegis release 的签名 release 资产。
打开 Aegis，通过 setup link，或手动 Core URL 加 scoped node token 完成配对。
只在你希望启用对应能力时授权 Android 权限。

Unsigned APK 只是构建产物，不是面向用户的安装资产。

首次运行

打开 macOS 或 Windows 桌面应用。
从 Runtime / Workbench 界面启动或连接 Aegis Core。
需要 AI planning 时，从应用设置或受管理的 Core profile 配置 provider secrets。
从桌面端 pairing card 配对 iPhone、iPad 或 Android。
发送一条简短 Chat 请求，确认回复、任务状态和 evidence 都可见。

高级运维路径

CLI、MCP 和 Agent 插件仍支持运维人员与 AI coding 工具使用。它们应该连接到已有 Aegis Core，或连接到桌面应用管理的 Core。