用途：执行端到端测试，模拟真实用户跨整个应用栈的操作，涵盖浏览器交互、API 调用、数据库操作与第三方集成。适用场景为需要专门端到端测试的任务，触发语如“run…”。
主要能力：识别关键用户旅程（注册登录、主功能工作流如创建/编辑/删除、搜索筛选、结算或支付、错误处理如 404、表单校验、会话过期）；用页面对象模型封装可复用交互；按用户旅程组织测试文件；高效处理认证，如用 Playwright storageState 保存并复用登录会话、创建每个 worker 只运行一次的认证 fixture；配置多浏览器与响应式测试（Chromium、Firefox、WebKit，移动 375px、平板 768px、桌面 1280px）；加入重试与稳定性机制（自动等待 locator、CI 最多重试 2 次、networkidle 或 domcontentloaded、失败时截图/trace/视频）；生成含截图、trace 和失败详情的 HTML 报告。
使用方式与先决条件：需已安装 E2E 框架（Playwright、Cypress 或 Selenium WebDriver）；应用运行在带种子测试数据的测试环境；已安装浏览器二进制（npx playwright install 或 Cypress binary）；已创建已知凭据的测试账户；已配置 base URL、API key 与测试凭据等环境变量。测试建议放在 tests/e2e/ 或 e2e/，页面对象放在 tests/e2e/pages/，并配好浏览器与视口矩阵的配置文件、认证状态文件和 HTML 报告。
限制与常见问题：元素找不到或超时多因选择器变化或懒加载，建议用 data-testid 并调整等待；本地通过而 CI 失败可能与无头行为差异或环境更慢有关；认证状态过期需重新生成；动画导致的偶发失败可禁用 CSS 动画或用 force 点击；数据库状态污染可在 beforeEach 重置或用事务回滚。
参考资源：Playwright 文档 https://playwright.dev/docs/intro、Cypress 文档 https://docs.cypress.io/、POM 模式 https://playwright.dev/docs/pom、Playwright 最佳实践 https://playwright.dev/docs/best-practices、测试策略 https://martinfowler.com/bliki/TestPyramid.html。