下载与安装
Windows 安装
Windows 用户下载 zip 包后解压即可使用，无需安装任何依赖，内置完整 Python 运行时。
- 在「Agent 下载」页面点击 Windows 下载按钮，获取 zip 安装包
- 解压到任意目录（建议路径不含中文和空格）
- 双击
start.bat启动 Agent - 首次启动会自动初始化 Python 运行环境（约一分钟，仅一次），请等待完成
- 浏览器会自动打开 Agent 页面
macOS 安装
macOS 用户下载后解压，在终端运行启动脚本即可。内置完整 Python 运行时，无需 brew 或 pip。
- 在「Agent 下载」页面点击 macOS 下载按钮
- 解压到任意目录
- 打开终端，进入解压目录，执行
chmod +x start.command && ./start.command（zip 解压会丢失执行权限，需先 chmod） - 浏览器会自动打开 Agent 页面
- 如需登录后自动启动，在客户端「设置」页打开「登录后自动启动」开关（macOS 默认关闭，开启后写入用户级 LaunchAgent，下次登录生效）
Linux（Ubuntu）安装
Linux 用户下载后解压，运行启动脚本即可。内置完整 Python 运行时，无需 apt 或 pip。
- 在「Agent 下载」页面点击 Linux 下载按钮
- 解压到任意目录，例如
mkdir -p ~/aiorange && tar -xzf agent-*-linux.tar.gz -C ~/aiorange - 进入解压目录，执行
chmod +x start.sh && ./start.sh（解压会丢失执行权限，需先 chmod） - 桌面环境会自动打开 Agent 页面；无桌面的服务器请浏览器访问
http://127.0.0.1:19200
Ubuntu 自启动（登录后启动）
Linux 端默认已开启「登录后自动启动」：客户端首次启动时自动写入用户级 systemd 服务
~/.config/systemd/user/aiorange-agent.service 并 enable（只 enable、不加 --now，避免和正在运行的实例撞成双实例）。在客户端「设置」页可随时开关，也可用下列命令手工管理。- 查看是否已开启：
systemctl --user is-enabled aiorange-agent.service - 手动开启：
systemctl --user enable aiorange-agent.service - 手动关闭：
systemctl --user disable aiorange-agent.service - 本次会话立即启动 / 停止：
systemctl --user start aiorange-agent.service/systemctl --user stop aiorange-agent.service - 查看状态与日志：
systemctl --user status aiorange-agent.service、journalctl --user -u aiorange-agent.service -f - 无人值守服务器若要「不登录也常驻」，再执行一次
sudo loginctl enable-linger $USER（否则用户级服务只在登录后运行）