# 安装说明

## macOS

优先使用 DMG 双击安装器；也可以运行：

```bash
./install-macos.command
```

如果 macOS 提示“Apple 无法检查 App 是否包含恶意软件”或“无法验证开发者”，不要反复双击。先右键点击安装器 App，选择“打开”；仍然打不开时，到“系统设置 -> 隐私与安全性”点击“仍要打开”。完整说明见 `manuals/macOS安全打开说明.md`。

## Windows

优先使用 Windows EXE。如果 EXE 被公司内网安全软件、终端管控、云壳、杀毒软件或微信下载路径策略拦截，不要关闭公司安全软件，改用 ZIP 备用版：

1. 下载 `AIOS国际站商家AW安装包-Windows内网ZIP备用版-20260612.zip`。
2. 右键 ZIP，选择“全部解压”。
3. 把解压后的文件夹放到桌面或文档目录，不要放在微信缓存目录。
4. 双击 `install-windows-double-click.cmd`。

也可以在解压目录运行：

```powershell
powershell -ExecutionPolicy Bypass -File .\install-windows.ps1
```

如果 CMD / PowerShell 也被公司策略禁用，按客户公司 IT 流程报备本 ZIP 或安装脚本，不建议让客户关闭终端防护。详细说明见 `manuals/Windows内网ZIP备用安装说明.md`。

## 安装行为

- 安装前备份目标 AW 账号目录。
- 安装/更新 AIOS 自己的 Agent、Skill、bindings、Harness、manuals 和最小工作区。
- 清理 AIOS 工作区内旧版 legacy 目录，避免客户继续看到旧教材入口。
- 不清空客户其他 Agent、Skill、聊天、账号配置。
