自 v0.7.0 起，macOS 产物带 Developer ID 签名并经公证，校验 SHA-256 后直接打开即可。Windows 版的 Authenticode 签名尚未完成，SmartScreen 仍会提示一次，这也是渠道仍叫技术预览版的原因之一。
1. 下载并校验
从下载中心选择与你的平台和架构匹配的产物。需要校验时，与 GitHub Releases 随发行公布的校验清单逐字核对。
2. 启动 BootAgent
macOS 打开 DMG 后把应用拖入「应用程序」，Windows 运行安装器，Linux 给下载的文件加可执行权限。界面在本机回环地址上提供服务，不暴露到局域网或公网；关闭应用后本地服务随之退出。
macOS 首次打开
自 v0.7.0 起，macOS 产物带 Developer ID 签名，并已通过 Apple 公证。首次打开只有 macOS 对下载文件的常规确认，不再出现“无法验证开发者”的拦截，也不需要在系统设置里放行任何东西。
如果你打开的是 v0.6.x 或更早的历史预览版，Gatekeeper 仍会拦截它——那些包没有签名。不要为旧版本添加放行例外：升级到当前版本，拦截随签名一起消失。
这条边界不变：BootAgent 从不要求你执行 spctl --master-disable、关闭 Gatekeeper 或降低系统整体安全设置。
3. 选择 Agent
选择你真正要使用的工具。标记为“官方安装引导”的 Agent 仍可进入流程，安装与配置由官方渠道完成，BootAgent 如实标注这一点。
4. 连接自己的 Provider
选择 Provider 或自定义兼容端点，并使用你自己的 API Key。BootAgent 不提供共享 Key，不建立统一模型网关，也不代收模型费用。
5. 测试真实协议
模型列表可达不等于 Agent 一定可用。BootAgent 会按 Agent 使用的协议测试连接：OpenAI Chat Completions、Anthropic Messages 或 OpenAI Responses。
6. 复核写入与下一步
完成页会展示每个 Agent 的结果、配置位置与启动方式。配置前会创建备份；错误不会被静默推迟到 Agent 的第一次请求。
Key 只写入目标 Agent 工作所需的本地配置或 BootAgent 环境文件，不写入 BootAgent profile、日志、截图或遥测。
遇到问题
- 缺少 Agent：按页面给出的官方来源安装，不使用不明镜像脚本。
- Key 被拒绝：回到 Provider 控制台检查权限与余额，不要把 Key 发到聊天或 Issue。
- 协议不兼容：换用明确支持该 Agent 协议的模型，而不是只验证
/v1/models。 - 下载校验不一致：不要运行文件，保留文件名、下载地址与实际 SHA-256。
- macOS 提示“已损坏，无法打开”：先核对 SHA-256。如果打开的是 v0.6.x 或更早的旧版本，这通常是旧包的公证拦截，升级到当前签名版本即可；当前版本哈希一致仍报损坏，就重新下载一次。