子流程 B：Excel 用例 → 执行 → HTML 报告

工具

执行流程

Step 1: get_grouped_cases   → 了解全貌，规划顺序
Step 2: 登录（如需）        → 建立 session
Step 3: 按模块循环           → get_excel_cases → 逐条执行
Step 4: save_test_results   → 每模块完成后立即保存（含 HTML 报告）

Step 1：查看分组

python
1get_grouped_cases(project="huudi", excel_path="huudi_cases_v1.xlsx")

返回各模块用例数。执行顺序：高优先级模块先跑，用例数最多的模块最后（防止 context 不够）。

Step 2：登录前置

从 project.yaml 的 login 段读取：

yaml
1login:
2  url: "https://..."
3  account: "user@example.com"
4  password_value: "Password123"

登录操作：

1. browser_navigate(login.url)
2. browser_snapshot() → 确认登录页加载
3. 找邮箱框 → browser_type(account)
4. 找密码框 → browser_type(password_value)
5. 找登录按钮 → browser_click()
6. browser_snapshot() → 确认已登录（URL 变化 或 出现用户名/头像）

登录成功后复用同一 session，整个执行过程不重复登录。 登录失败 → 停止执行，报告原因，不继续。

Step 3：逐条执行

执行顺序（每条用例）

precondition → 全部 S → 统一验证所有 E

S 和 E 不是一一对应的。先把所有 S 做完，再统一验证所有 E。

处理 precondition

执行 S 步骤

每步必须先 snapshot，用 snapshot 返回的 ref 定位元素：

S 执行失败（元素找不到 / 超时）：

1. browser_screenshot(path="/abs/path/fail_{case_id}.png") 截图，记录绝对路径
2. 记录 passed: false, error: "S{n} 失败: {原因}"
3. 跳过该用例剩余所有 S 和 E

验证所有 E

全部 S 完成后，做一次 browser_snapshot()，然后逐条验证：

E 验证结果：

• 所有 E 通过 → passed: true
• 任一 E 不通过 → passed: false, error: "E{n} 失败: 期望 xxx，实际 yyy"
• 无法自动验证 → passed: null, error: "SKIP: {原因}"

Step 4：保存结果（每模块）

每个模块执行完后立即保存：

python
1save_test_results(
2    project="huudi",
3    results=[
4        {"case_id": "HUUDI-T0001", "module": "用户注册和登录", "title": "...", "passed": True},
5        {"case_id": "HUUDI-T0002", "module": "用户注册和登录", "title": "...", "passed": False, "error": "E2 失败: ..."},
6        {"case_id": "HUUDI-T0003", "module": "用户注册和登录", "title": "...", "passed": None, "error": "SKIP: 需要预置数据"},
7    ],
8    excel_path="huudi_cases_v1.xlsx",
9    screenshots=[
10        # 只传 FAIL 用例的截图，路径为 browser_screenshot 返回的绝对路径
11        {"case_id": "HUUDI-T0002", "path": "/abs/path/fail_HUUDI-T0002.png"},
12    ]
13)

返回中包含 report_html_path（HTML 文件路径），向用户展示：

✅ 用户注册和登录 执行完成
   结果已保存：projects/huudi/artifacts/huudi/report.html
   通过 28 / 失败 1 / 跳过 2 — 共 31 条

结束：输出总汇总

所有模块执行完后，汇总输出：

═══════════════════════════════════
  Huudi 测试执行报告
═══════════════════════════════════
  用户注册和登录    ✅ 29/31  (1 FAIL, 1 SKIP)
  KYC验证          ✅ 22/28  (3 FAIL, 3 SKIP)
  投资流程         ✅ 24/26  (0 FAIL, 2 SKIP)
───────────────────────────────────
  总计: 85 条  通过 75  失败 4  跳过 6
  报告: projects/huudi/artifacts/huudi/report.html
═══════════════════════════════════

关键规则

1. 每步操作前必须 snapshot — 用 ref 定位，不猜 CSS selector
2. 失败立即截图 — browser_screenshot() 保存现场
3. 按模块分批 — 不要一次加载全部用例
4. 模块完成即保存 — 不要等全部跑完才 save
5. 法语/英语界面文本照搬 — 不翻译按钮名
6. 登录 session 全程复用 — 不重复登录