用对方法，让自动化越跑越稳
同样的工具，用法不同，效果差别很大。以下建议覆盖运行方式、环境隔离、数据与密钥安全、模型选型与用例写法，帮助团队少踩坑，把回归跑得又快又稳。
推荐运行方式：先有头联调，再无头回归
请先在 Windows 或 macOS 桌面端使用有头模式完成联调；待用例运行稳定后，再切换无头模式批量回归；需要流水线时，用 CLI 把回归接入 CI/CD。
有头模式联调
在桌面端打开可见浏览器，逐条验证新用例，直接观察 AI 的点击、填写与校验过程。
无头模式回归
用例稳定后切换无头执行，浏览器在后台批量运行，不占屏幕，适合日常回归。
CLI 接入流水线
在 Windows、macOS 或 Linux 服务器上以 CLI 触发执行，接入 CI/CD 定时回归。
看得见的执行过程
打开可见浏览器运行，适合把用例调通、把步骤写准。
- 新系统接入、新用例首次运行
- 排查控件误定位与页面等待问题
- 配合「AI 智能调试」即时验证单步操作
后台批量，不打扰工作
浏览器在后台运行，适合已验证用例的日常批量回归。
- 日常回归与版本发布前的全量执行
- 与 CLI 配合在服务器上定时运行
- 结果以中文报告与失败截图完整追溯
环境安全：只在测试环境执行
TestMax 会在真实浏览器中执行页面操作，点击、填写、提交都是真实发生的。请务必把执行范围限定在测试环境内。
请勿在生产环境或含真实业务数据的系统中执行自动化，避免误改、误删业务数据；涉及不可逆操作的系统尤其要谨慎。
使用测试环境
联调与回归都在测试环境进行，可反复验证步骤与识别规则，不影响真实业务数据，执行也更快、更稳。
独立测试账号
为自动化准备专用测试账号与预置数据，与人工账号隔离、权限最小化，出现问题时易于定位与恢复。
高风险步骤先复核
涉及提交、删除、支付、发送消息等步骤，先用有头模式逐条确认行为符合预期，再纳入批量回归。
数据脱敏与密钥安全
用例文件会在团队内流转，模型密钥关系到费用与数据出口，两者都值得单独管理。
用例数据脱敏
Excel 用例中不填写真实姓名、手机号、证件号等敏感信息，使用可反复构造的测试数据，报告与截图同样注意脱敏。
API Key 安全
建议使用测试专用 API Key 并定期轮换；密钥只在【配置中心】维护，不会写入用例文件，也不要随截图或文档外发。
敏感数据内网部署
数据敏感度高时，可选用内网部署的 Ollama / 私有大模型，Base URL 指向内网地址，页面与推理数据不出内网，满足合规要求。
按场景选择模型
模型没有绝对的好坏，只有是否匹配当前任务。在【配置中心】→【模型配置】中可随时切换。
日常冒烟 / 回归
选 DeepSeek、通义千问等响应快、费用低的模型，适合步骤清晰的标准业务流程，大规模回归更省 Token。
复杂流程 / 多分支
步骤描述复杂、条件分支较多时，切换能力更强的模型，优先保证理解准确度与执行成功率。
内网 / 合规场景
使用内网私有模型或自定义 API 端点（OpenAI 兼容接口），数据流向可控，满足企业合规要求。
各模型厂商的 Model、API Key、Base URL 配置方法，见 模型配置。
提高用例稳定性的 6 个习惯
稳定性主要靠写法与流程积累，以下习惯能明显减少执行失败。
-
控件名称与页面文字一致
【确定】【任务名称】等写法直接取自页面可见文字，AI 理解与定位都会更准确。
-
一步只做一件事
把长描述拆成短步骤，点击、填写、断言分开写，减少歧义与误操作。
-
同类操作保持同一种说法
全库统一【点击】【填写】【选择】等用词，便于复用已学习的定位规则。
-
新步骤先用「AI 智能调试」验证
用自然语言即时试跑单个步骤，确认可行后再写进 Excel，避免批量执行时才发现问题。
-
首次执行用有头模式
跑通后规则自动学习入库，同页面后续执行直接命中，越跑越快、越跑越稳。
-
失败先看报告与截图
在 report.html 中对照失败截图与步骤明细，把步骤写得更具体后重新执行；缓存异常时可在【更多功能】中清除规则自动学习与步骤规划缓存。
日常回归前自查清单
开始批量执行前，花一分钟过一遍：
- 当前指向的是测试环境，且使用测试专用账号
- Excel 用例已完成数据脱敏，不含真实敏感信息
- API Key 为测试专用，且未写入用例文件
- 新增或修改过的用例，已用有头模式跑通过
- 模型选型与本次任务匹配（冒烟用快模型，复杂流程用强模型）
- 已知悉报告输出位置（report.html / results.xlsx / 失败截图）