e2e

E2E 命令

此命令调用 e2e-runner 智能体（Agent）来使用 Playwright 生成、维护和执行端到端测试（End-to-End Tests/E2E）。

此命令的作用

1. 生成测试旅程（Test Journeys） - 为用户流创建 Playwright 测试
2. 运行 E2E 测试 - 在不同浏览器上执行测试
3. 捕获产物（Artifacts） - 在失败时捕获截图、视频和追踪（Traces）
4. 上传结果 - 生成 HTML 报告和 JUnit XML
5. 识别不稳定测试（Flaky Tests） - 隔离不稳定的测试

何时使用

在以下场景使用 /e2e：

• 测试关键用户旅程（登录、交易、支付）
• 验证多步骤流程的端到端运行情况
• 测试 UI 交互和导航
• 验证前端与后端之间的集成
• 为生产环境部署做准备

工作原理

e2e-runner 智能体将执行以下操作：

1. 分析用户流并识别测试场景
2. 使用页面对象模型（Page Object Model/POM）模式生成 Playwright 测试
3. 在多个浏览器（Chrome、Firefox、Safari）上运行测试
4. 通过截图、视频和追踪捕获失败信息
5. 生成报告，包含结果和产物
6. 识别不稳定测试并推荐修复方案

使用示例

用户：/e2e 测试市场搜索和查看流程

智能体 (e2e-runner):
# E2E 测试生成：市场搜索和查看流程

## 识别出的测试场景

**用户旅程：** 市场搜索 → 查看结果 → 点击市场 → 查看详情

**测试覆盖范围：**
1. 导航到市场页面
2. 执行语义搜索
3. 验证搜索结果
4. 点击第一个结果
5. 验证市场详情页面加载
6. 验证图表渲染

## 生成的测试代码

```typescript
// tests/e2e/markets/search-and-view.spec.ts
import { test, expect } from '@playwright/test'
import { MarketsPage } from '../../pages/MarketsPage'
import { MarketDetailsPage } from '../../pages/MarketDetailsPage'

test.describe('Market Search and View Flow', () => {
  test('user can search markets and view details', async ({ page }) => {
    // 1. 导航到市场页面
    const marketsPage = new MarketsPage(page)
    await marketsPage.goto()

    // 验证页面加载
    await expect(page).toHaveTitle(/Markets/)
    await expect(page.locator('h1')).toContainText('Markets')

    // 2. 执行语义搜索
    await marketsPage.searchMarkets('election')

    // 等待 API 响应
    await page.waitForResponse(resp =>
      resp.url().includes('/api/markets/search') && resp.status() === 200
    )

    // 3. 验证搜索结果
    const marketCards = marketsPage.marketCards
    await expect(marketCards.first()).toBeVisible()
    const resultCount = await marketCards.count()
    expect(resultCount).toBeGreaterThan(0)

    // 截取搜索结果截图
    await page.screenshot({ path: 'artifacts/search-results.png' })

    // 4. 点击第一个结果
    const firstMarketTitle = await marketCards.first().textContent()
    await marketCards.first().click()