用途:当需要为 TestMu AI(原 LambdaTest)云端的 SmartUI 视觉回归测试生成配置、进行截图对比时使用。触发词包括 SmartUI、visual regression、screenshot comparison、visual testing。技能框架无关,可与 Playwright、Selenium、Cypress、Puppeteer 配合。
主要能力:生成 SmartUI 快照代码,例如 Playwright 中调用 smartuiSnapshot(page, 'Homepage');Selenium 中执行 ((JavascriptExecutor) driver).executeScript("smartui.takeScreenshot=Login Page")。支持通过 smartui.config.json 配置多浏览器(chrome、firefox、safari)与多视口(如 [1920,1080]、[1366,768]、[375,812]),并设置 waitForPageRender(如 5000)与 waitForTimeout(如 1000)。集成 Storybook 与 CI/CD。
使用方式:先安装 npm install @lambdatest/smartui-cli --save-dev;再生成配置 npx smartui config:create smartui.config.json;执行时用 npx smartui exec -- node test.js 或 npx smartui exec -- npx playwright test;Storybook 用 npx smartui storybook http://localhost:6006 --config smartui.config.json。CLI 方式需设置 PROJECT_TOKEN;Selenium/Playwright 云端方式需设置 LT_USERNAME 与 LT_ACCESS_KEY,并在能力中加入 smartUI.project 等选项。
审批流程:首次运行创建基线截图,后续运行与基线对比,差异在仪表盘高亮,可批准或拒绝;批准的截图成为新基线。仪表盘地址为 https://smartui.lambdatest.com。
限制与注意事项:仅在任务与上游来源及本地项目上下文明确匹配时使用;应用改动前需验证命令、生成的代码、依赖、凭证和外部服务行为;示例不能替代环境特定测试、安全审查,以及对破坏性或高成本操作的用户批准。高级模式、调试指南、CI/CD 集成与最佳实践见 reference/playbook.md。其他细节暂未提供。