下载与安装
安装 TestMax，开始自动化测试
TestMax 根据平台提供 Windows / Linux 绿色版和 macOS 通用版。选择与系统及处理器架构一致的版本，按下方步骤完成安装。
请从 官方下载页 获取软件。
Windows
适用于 Windows 10 / 11 64 位系统。当前版本采用绿色包方式，无需安装向导。
- 下载并完整解压。如下载的是压缩包，请先解压到固定目录，不要直接在压缩包内运行。
- 保持目录完整。程序需要同级的
node-runtime、node_modules、config等资源，请勿只移动 EXE 文件。 - 启动图形界面。双击
TestMax_版本号.exe即可打开 TestMax。
首次运行若出现 Windows Defender SmartScreen 提示，请先确认文件来自 TestMax 官方下载渠道，再通过“更多信息”查看并选择运行。企业设备如受安全策略限制，请联系管理员放行。
同一个 EXE 也支持命令行模式。在 CMD 或 PowerShell 中进入软件目录后，可运行
TestMax_版本号.exe --help 查看参数，使用 --headed 显示浏览器或 --headless 后台执行。macOS
通用版同时兼容 Apple 芯片与 Intel Mac，下载文件格式为 DMG。
- 打开磁盘映像。双击下载的
TestMax_版本号_universal.dmg。 - 安装应用。在打开的窗口中，将
TestMax.app拖入“应用程序（Applications）”文件夹。 - 启动应用。进入“应用程序”并打开 TestMax；安装完成后可推出并删除 DMG 文件。
如果系统提示“无法验证开发者”，请先确认安装包来自官方渠道，然后在访达中按住 Control 点击 TestMax，选择“打开”；也可前往“系统设置 → 隐私与安全”查看系统提供的打开选项。仍无法启动时，可在终端执行以下命令移除应用的隔离属性：
sudo xattr -dr com.apple.quarantine /Applications/TestMax.app
应用运行环境已包含在 APP 中。配置、测试用例与输出等用户数据会保存在当前用户的 macOS 应用数据目录中。
Linux
Linux 仅提供 CLI 绿色包：解压后为程序与运行时依赖；不随带 config/。分为 amd64 与 arm64。
系统兼容性：建议使用 Ubuntu 22.04 及以上版本，或具备
libwebkit2gtk-4.1-0 与 libgtk-3-0 的 Debian 系发行版。当前绿色包面向 Debian/Ubuntu；CentOS / RHEL 等需自行解决同等运行库。- 确认系统与架构。优先使用 Ubuntu 22.04 及以上；Intel / AMD 选
amd64，ARM 选arm64。 - 解压绿色包。将
TestMax_版本号_linux.tar解压到任意可写目录，勿只抽出二进制。 - 安装运行库（首次）。二进制仍依赖系统 WebKitGTK / GTK，需用 apt 安装一次。
- 准备配置与用例。Linux 包不含
config/：请从已联调好的 Windows / macOS 目录拷贝整个config（含models.ini、auth.ini、task_config.json），用例放入「测试用例」；也可export AITESTMAX_DATA=...指向已有数据根。 - 运行。在解压目录执行
./TestMax --help。
tar -xf TestMax_版本号_linux.tar
cd TestMax
sudo apt install -y libwebkit2gtk-4.1-0 libgtk-3-0
./TestMax --help
程序、node-runtime、测试用例/缓存/输出与二进制同目录；配置需自行放入或通过
AITESTMAX_DATA 指定。升级时覆盖二进制并保留数据目录即可。首次启动后
安装完成只是第一步，首次执行测试前还需要完成模型、用例和浏览器环境配置。
- 配置 AI 模型。进入“配置中心 → 模型配置”，填写 API 密钥并选择默认模型。
- 准备测试用例。将
.xlsx或.xlsm用例放入“测试用例”目录。 - 确认浏览器环境。启动时检查 Chrome for Testing；未就绪时按软件提示放置浏览器并刷新检查。
- 先有头执行。第一次建议选择“开始有头执行”，观察浏览器操作是否符合预期，再使用无头模式批量回归。