HyperExecute Operator 是一个面向 TestMu AI/LambdaTest 云端测试执行的技能,用于端到端地操作 HyperExecute。
用途 该技能用于在 LambdaTest 的 HyperExecute 平台上运行云端测试作业。它覆盖从分析项目、编写配置、本地校验、运行 CLI 作业到调试失败的完整流程,帮助用户把本地测试项目迁移到 HyperExecute 云端执行。
主要能力
- 项目分析:在 CLI 可用时运行 hyperexecute analyze,仅在无法使用时回退到本地检查。
- 配置生成与修复:根据分析输出、项目测试命令和 reference/ 中的模板,创建或修复 hyperexecute.yaml。
- 本地校验:运行 node scripts/doctor.js --config hyperexecute.yaml 和 node scripts/validate-config.js hyperexecute.yaml,并使用官方 CLI 执行 ./hyperexecute --user "$LT_USERNAME" --key "$LT_ACCESS_KEY" --config hyperexecute.yaml --validate。
- 云端作业执行:在获得确认后运行真实云端作业。
- 失败调试:下载日志、产物和报告,并参考 reference/troubleshooting.md 进行排查。
- 辅助脚本:doctor.js 检查 CLI 就绪状态、凭据、配置存在性和可选的官方校验;validate-config.js 在官方校验前做轻量配置检查;build-command.js 打印使用环境变量引用的安全 validate/run/debug/download 命令;summarize-artifacts.js 汇总下载的日志、报告和产物以便分诊。
- 参考文档:涵盖 CLI 用法与参数(reference/cli.md)、YAML 模式(reference/yaml-patterns.md)、框架配方(reference/frameworks.md)、CI/CD 集成(reference/ci-cd.md)、安全规则(reference/security.md)和故障排查(reference/troubleshooting.md)。
使用方式
- 定位 HyperExecute CLI。如果缺失,除非用户明确批准自主 HyperExecute 会话,否则应先询问再下载。
- 在 CLI 可用时运行 hyperexecute analyze。
- 根据分析输出、项目测试命令和模板创建或修复 hyperexecute.yaml。
- 运行辅助脚本进行本地检查。
- 使用官方 CLI 进行校验。
- 除非用户明确选择自主会话,否则在运行真实云端作业前请求确认。
- 失败时下载日志、产物和报告,并参考故障排查文档。
操作规则
- 官方 HyperExecute CLI 是 analyze、校验、执行、日志、报告和产物的唯一事实来源。
- 使用本地环境变量或 CI 密钥中的 LT_USERNAME 和 LT_ACCESS_KEY,绝不在 YAML 或文档中硬编码凭据。
- 仅在需要额外作业级密钥时使用 --job-secret-file,最好放在仓库外或被 .gitignore/.hyperexecuteignore 忽略。
- 优先使用模板驱动的 YAML,而非生成器脚本,因为测试命令、路径和负载边界因项目而异。
- 自动运行安全的本地检查;除非用户选择自主模式,否则仅在确认后运行真实 HyperExecute 云端作业。
- 在自主模式下,先校验、再运行、检查输出、必要时下载日志/产物,并且仅针对可操作的配置或环境修复进行重试。
工作流
- 首次运行:分析项目、编写 YAML、运行辅助检查、运行 CLI 校验,然后请求确认云端作业。
- 调试:复现失败的 CLI 命令,必要时添加 --verbose,下载日志/产物/报告,一次修复一个原因。
- CI:使用 CI 密钥,在执行前添加校验阶段,设置 CI=true 以获得更安静的日志,并为失败作业保留下载的产物。
- 性能:在一次成功运行后,调整 autosplit、并发、缓存键、重试、智能排序以及矩阵/混合范围。
适用场景 适用于需要在 LambdaTest HyperExecute 云端运行测试、生成或修复 hyperexecute.yaml、在 CI 中集成 HyperExecute 作业,以及调试云端测试失败的场景。
限制
- 真实云端作业默认需要用户确认,除非用户明确选择自主模式。
- 凭据必须通过环境变量或 CI 密钥提供,不能硬编码。
- 关于具体收费、价格、平台支持范围等信息,资料中暂未提供。