用途:为 TanStack Start 应用(FMC/TILDA)提供端到端测试与浏览器自动化能力,分三层使用。项目 E2E 用 @playwright/test 写 tests/.spec.ts 并提交仓库,负责回归与 CI;代理探索用 agent-browser MCP 做交互式调试;一次性脚本(外部站点、无 MCP)通过 /tmp/playwright-test-.js 配合 run.js 运行。仓库内应回归的内容优先写项目 E2E。
主要能力与用法:先在 playwright.config.ts 中加载环境变量(dotenv 读取仓库、应用与 .env.test),再配置 webServer 与 baseURL,本地用 bun run dev,CI 用 bun run build && bun run start。脚本示例:"e2e": "playwright test --project=chromium",常用命令 bun add -d @playwright/test dotenv、bunx playwright install chromium、bun run e2e、bun run e2e -- tests/smoke、bun run e2e -- --ui。提供冒烟测试(公共路由、尾斜杠重定向、区域 beforeLoad)、打桩管理员/用户鉴权夹具、真实 OAuth 回归(RUN_OAUTH_E2E=1),以及控制台与服务端错误收集工具。地图场景提供 waitForMapLoad、verifyMapRendered、verifyMapNetworkRequests 等辅助,点击地图可考虑 MapGrab。应用侧用 VITE_PLAYWRIGHT_ENABLED 与 playwrightTestId 暴露测试钩子,仅在 E2E 生效,不影响生产 HTML。
适用场景:TanStack Start 迁移后的冒烟与回归、鉴权页面测试、地图渲染与瓦片校验、CI 流水线。
限制:并行操作同一数据库行时需 workers: 1 或串行模式;Docker/数据库需在 Playwright 外启动,除非 CI 已验证;定位优先 getByRole 等语义方式,避免脆弱的 CSS 链;临时脚本不得提交到技能目录;官方无 llms.txt,文档需按给定 URL 获取。其他未在资料中说明的能力暂未提供。