用途：为项目提供 Playwright E2E 测试规范，核心是“像用户一样测试”，只验证用户可见行为，不依赖技术实现细节。
主要能力与约定：配置上，单元测试用 Vitest，E2E 用 Playwright 并自动启动开发服务器；测试位于 e2e/ 目录，启用 HTML 报告并在重试时收集 trace；完整 E2E 套件约需 15 分钟。
最佳实践：1）使用语义化定位器，优先 getByRole、getByLabel、getByPlaceholder、getByText，避免 CSS 选择器、类名、ID、data-testid。2）等待用户可见变化，如元素可见或文本出现，避免等待 networkidle、任意 waitForTimeout 或 URL/路径断言。3）简化测试设置，减少 beforeEach，避免清 cookie、重载等冗余步骤。
常用写法示例：page.getByRole("button", { name: "Submit" })；await expect(page.getByRole("heading", { name: "Welcome" })).toBeVisible()；表单交互用 getByLabel 填值后点击提交，并断言成功提示可见；列表用 .first() 定位再操作；条件元素先 isVisible() 再点击。
运行命令：pnpm test:e2e 运行全部（自动启动开发服务器）；pnpm test:e2e e2e/some-file.spec.ts 运行指定文件；pnpm test:e2e --grep "test name" 按名称过滤；pnpm test 运行 Vitest 单元测试。
验证流程：修改或新增 E2E 测试后必须自行运行验证，失败需修复并重跑，通过后再报告结果。
限制：未提供具体项目结构、依赖版本、CI 集成细节及环境变量配置等信息，暂未提供。