TestMax TestMax 文档中心
文档常见问题
产品使用答疑

常见问题，快速解答

汇总安装环境、能力边界、执行方式、模型配置与稳定性排查中的常见疑问，帮助你快速定位问题并找到解决方法。

TestMax 支持哪些操作系统？

提供 Windows、macOS 与 Linux 三个平台的安装包：

  • Windows：适用于 Windows 10 / 11 64 位系统，绿色版解压即用，包含 GUI 与 CLI；
  • macOS：通用 DMG，同时兼容 Apple 芯片与 Intel Mac；
  • Linux：仅提供 CLI 绿色包，推荐 Ubuntu 22.04 及以上或 Debian 12 及以上，分 amd64 与 arm64。

各平台详细安装步骤见 安装指南。

安装或首次启动时被系统安全提示拦截怎么办？

请先确认安装包来自 官方下载页，再按平台处理：

  • Windows SmartScreen：通过"更多信息"查看并选择运行；企业设备受安全策略限制时，请联系管理员放行；
  • macOS"无法验证开发者"：在访达中按住 Control 点击 TestMax 选择"打开"，或前往"系统设置 → 隐私与安全"查看打开选项；
  • 仍无法启动（macOS）：在终端执行 sudo xattr -dr com.apple.quarantine /Applications/TestMax.app 移除应用的隔离属性。

启动时提示缺少 Chrome for Testing 怎么办？

TestMax 在本机真实浏览器中执行测试，启动时会自动检测 Chrome for Testing 环境：

  • 未就绪时，按软件弹窗提示的路径放置浏览器；
  • 放置完成后点击刷新检查，确认顶部显示运行环境就绪；
  • 首次执行建议选择开始有头执行，观察浏览器操作是否符合预期，再切换无头模式批量回归。

哪些网页操作 TestMax 暂时做不了？

以下场景暂不建议写入关键自动化流程：

  • 依赖系统文件窗口的上传与下载，以及本地文件内容校验；
  • 系统剪贴板的读取、写入与校验；
  • 拖拽元素排序、拖动进度条与验证滑块；
  • 图片或滑块验证码识别、扫码、短信接收等真人验证；
  • 文件选择器、权限询问等浏览器或操作系统级弹窗；
  • 多个浏览器标签页或窗口之间的切换；
  • 按距离、屏数或指定容器的精确滚动。

如果业务流程中无法避开这类操作，欢迎 联系 TestMax 技术支持（support@testmax.cn 或微信），我们会结合你的场景评估可行方案。完整能力边界说明见 使用限制。

有头执行和无头执行有什么区别？

两种模式执行的用例与校验逻辑完全一致，区别只在是否显示浏览器窗口：

  • 有头执行：显示浏览器窗口，可实时观察页面操作，适合首次联调新系统、排查失败用例；
  • 无头执行：不显示浏览器窗口、后台运行，适合日常批量回归，也是 CLI 的默认模式；
  • 推荐流程：先用有头模式验证少量核心用例，确认稳定后再切换无头模式扩大回归范围。

如何接入 CI/CD 流水线？

使用 TestMax CLI 即可在终端、定时任务或 CI 环境中执行自动化用例：

  • CLI 与 GUI 共用模型配置、任务配置、测试用例和输出数据，无需重复配置；
  • 默认无头模式执行，无需额外子命令，适合无桌面的 Linux 服务器或 CI 环境；
  • 首次联调可加 --headed 参数显示浏览器窗口，方便排查问题。

完整参数与用法见 使用 CLI。

为什么预置模型都是国产的？

当前平台默认集成的模型均为国内主流大模型，主要基于三点考虑：

  • 数据合规：您的业务数据默认存储在国内服务器，符合数据安全相关法规要求；
  • 响应效率：国内节点访问国产模型，延迟更低，体验更稳定；
  • 中文场景优化：国产模型在中文语义理解上经过专门调优，更贴合本地业务需求。

我想用国外模型怎么办？

平台不限制您接入任何第三方模型。如果您有海外业务或特定模型需求，可以通过 Custom 配置自由接入 OpenAI、Anthropic 等国外模型服务，完全由您自主决定。

Agent 经常做错或中途失败，如何提升稳定性？

问题表现：Agent 能识别你的意图，却在实际操作时卡住、点错位置，或者完成后没有得到预期结果。

这类问题通常不是由单一因素引起。建议由浅入深检查，逐步缩小问题范围：

  1. 用最小任务验证基础操作

    暂时放下完整流程，只让 TestMax 完成一个动作，例如打开某个菜单。你可以使用AI智能调试功能快速尝试并观察执行过程。若单个动作仍不稳定，应先确认目标元素是否可见、可点击，以及页面是否已加载完成。

  2. 对比不同模型的执行效果

    选择能力更强的模型运行同一条任务。如果结果明显改善，说明原模型可能难以处理当前页面结构或任务复杂度。

  3. 把目标改写成可执行步骤

    不要只描述最终目的，同时说明操作位置、先后顺序和成功标志。流程较长时，可拆成多个短任务逐一执行，降低一次性理解和决策的难度。

  4. 让 TestMax 了解业务语境

    在 用例步骤 中补充页面用途、业务名词、入口位置及特殊规则。上下文越明确，Agent 越不容易误解相似按钮或页面状态。

  5. 查看运行日志定位问题

    通过运行日志查看软件获得的页面内容，重点确认按钮文字、表单标签和结果提示没有在处理过程中丢失。若日志中缺少关键内容，需要先调整页面或解析配置。