方案一:老手纯终端安装
高级方式。全流程都在终端里完成,日志最完整,适合会看命令行输出的人。
老手/客服排障入口:直接运行安装脚本
适合:pkg 打不开、需要客服远程指导、需要完整日志、或明确知道自己要选本地安装/隔离安装的用户。普通用户优先用方案二。
- 打开 macOS 自带的"终端"。
- 复制下面整行命令并回车。
- 服务授权码会自动带入并校验;按终端提示选择本地安装或隔离安装。
—
方案二:终端启动可视化向导 推荐
主推方案。终端只负责下载和启动,本地浏览器里确认环境、网络、安装位置和配置方式。
启动本地浏览器向导,在网页中完成安装
隔离安装不是 Docker/虚拟机;它是 HOME、npm prefix、PATH、配置和数据目录隔离,用来避免污染用户原有环境。
- 打开 macOS 自带的"终端"。
- 复制下面整行命令并回车。
- 服务授权码会自动绑定到向导;本地浏览器会打开安装向导。
- 在网页里选择安装模式、位置和网络策略。
- 点击开始安装,实时查看日志和安装结果。
—
Windows 安装 推荐
- 按 Win + X,选择"终端(管理员)"或"PowerShell(管理员)"。
- 复制下面整行命令,粘贴后回车。
- 浏览器会打开 AgentDeploy 安装向导。
- 在向导里选择安装位置,点击"开始安装"。
- 安装成功后点击"打开安装目录",双击对应
Open xxx.bat 启动。
—
方案一:Windows PowerShell 在线安装
—
备用:下载 Windows ZIP
在线命令无法打开时,下载 ZIP 并解压,双击 StartAgentDeployWizard.bat。
下载 Windows ZIP
方案三:下载 APP / PKG 包
不需要复制终端命令,更接近普通软件安装。但当前测试版没有 Apple Developer ID 签名和公证,macOS 可能提示无法验证开发者。
如果系统提示"无法验证此安装包"或"已阻止使用",这是未签名测试包的 Gatekeeper 拦截,不代表安装器已经损坏。
- 点击"下载 pkg",下载后双击安装包。
- 如果 macOS 拦截,先点"完成"或关闭提示。
- 打开"系统设置" → "隐私与安全性"。
- 在"安全性"区域找到 AgentDeploy,点击"仍要打开"或"允许"。
- 再次打开安装包;安装完成后到
/Applications/AgentDeploy 双击 AgentDeploy.command。
下载 pkg