SuperAPI AI 工具集

meticulous-cli-ci

部署与运维

查看项目

更新于 10-15 19:56

技能介绍

用途:在 CI/CD 流水线中运行 Meticulous 视觉回归测试,支持云端与本地两种执行方式。

主要能力与用法:

  • ci upload-assets:上传静态构建产物(HTML/JS/CSS)并触发云端测试,无需隧道。用法:meticulous ci upload-assets --appDirectory=<path> 或 --appZip=<path>,可选 --apiToken、--commitSha、--baseSha、--repoDirectory、--rewrites、--waitForBase、--waitForTestRunToComplete、--dryRun。若 --baseSha 等于 --commitSha 则提前退出。
  • ci upload-container:推送本地 Docker 镜像到 Meticulous 仓库并触发云端测试,适用于需要服务端进程的应用。用法:meticulous ci upload-container --localImageTag=<tag>,可选 --containerPort、--containerEnv 等。
  • ci run-with-tunnel:从云端向本地应用建立安全隧道并派发云端测试,是本地应用配合云端 worker 的主要 CI 命令。用法:meticulous ci run-with-tunnel --appUrl=<url>,需 --apiToken 或 METICULOUS_API_TOKEN。
  • ci run-local:使用 Puppeteer 在本地并行运行全部测试,失败退出码为 1。用法:meticulous ci run-local --appUrl=<url>,可选 --baseCommitSha、--baseTestRunId、--githubSummary、--noParallelize、--parallelTasks、--maxRetriesOnFailure、--rerunTestsNTimes、--testsFile、--dryRun。
  • ci prepare:确保当前 PR 存在基线测试运行,在 ci run-with-tunnel 前使用。用法:meticulous ci prepare --triggerScript=<path>,仅在提交关联 PR 时执行触发脚本,并设置 METICULOUS_DISABLE_RECURSIVE_TRIGGER=true 防止递归。
  • ci start-tunnel:底层命令,通过安全隧道暴露本地 HTTP 服务,进程收到 SIGINT 前保持开启,仅对超级用户可见。用法:meticulous ci start-tunnel --port=<port>。

共享选项:run-local 与 run-with-tunnel 共享浏览器执行选项(如 --headless、--networkStubbing、--maxDurationMs 等)和截图差异选项(--diffThreshold、--diffPixelThreshold、--storyboard)。

限制:部分命令依赖 API Token;start-tunnel 仅超级用户可见;资料未提供收费、价格或平台支持范围等信息。