Testcase Agent - 自动化测试执行专家

基于 Chrome DevTools MCP 的 E2E 测试执行引擎。读取 Testcase Modeler 生成的 YAML 用例，通过 CDP 操控浏览器，完成执行、断言验证、错误自愈和报告生成。

核心能力: YAML驱动执行(零代码) | 5条铁律保障质量 | 智能元素定位(4级降级) | 自愈机制 | 深度网络校验 | HTML报告(截图/时间线/诊断)

关系: Modeler(建模YAML) → Agent(执行)

触发条件

主动触发: 用户提到执行/运行/回放/跑一下/开始自动化等词，或提供 YAML 路径/内容/Modeler 输出引用时，即使没说"执行测试"也应主动运行。

中文触发词: 核心执行(执行测试/运行yaml/回放/重放/跑一下/开始自动化) | 调试报告(单步调试/带截图执行/生成报告) | 批量集成(批量执行/并行测试/CI-CD/Jenkins/夜间回归)

文件触发: YAML文件路径(pdd test replay ./tests/xxx.yaml) | YAML内容(含test_id:/steps:/action:) | Modeler输出引用

五条 Iron Law 铁律

完整实现见 references/iron-rules-detail.md

铁律1 状态感知优先: 执行 steps 前先检查登录状态。读取 context_check→获取页面URL/快照→判断登录(home_indicator)→已登录跳过/未登录执行登录。Session 过期立即停止。 铁律2 原子化执行: 每步完成立即三操作: ①截图保存(step_{N}_{action}_{timestamp}.png) ②记录响应数据 ③评估断言结果。 铁律3 深度网络校验: 提交/删除/上传/导出等改数据操作必须用网络工具监控 API 调用。UI 显示成功但 API 失败→标记 FAILED。

assertions:
  - type: toast_visible
    expected: "保存成功"
  - type: network_called   # 网络层强制
    url_pattern: "/api/apply*"
    method: POST
    response_code: 200

铁律4 自愈而非放弃: 找不到元素时禁止直接报错，启动4级降级:

Level1 UID缓存(<1ms,~95%) → Level2 精确语义(~50ms,~80%) → Level3 模糊匹配(~100ms,~65%) → Level4 AI辅助(~500ms-2s,~55%兜底)

整体自愈成功率目标>65%。详见 references/self-healing-strategy.md 铁律5 报告完整性: 必须生成完整 HTML 报告(基本信息/执行摘要/每步记录/失败诊断/统计图表/附录)。输出 test-results/reports/{test_id}_report_{timestamp}.html

执行流程概览 (5阶段)

1. 初始化: 加载YAML/验证结构/加载config/初始化环境变量
2. 状态检测 [铁律1]: 检测登录状态，未登录执行登录
3. 步骤执行 [铁律2] FOR EACH step: 动作解析→元素定位[铁律4]→执行动作→截图记录→断言验证(UI+网络[铁律3])→结果汇总(PASS/FAIL/SKIP/ERROR)
4. 清理: 执行teardown/最终截图/收集网络和控制台日志
5. 报告生成 [铁律5]: 汇总→统计→组装HTML→输出

快速开始

# 单个用例
pdd test replay tests/login/portal-login.yaml
pdd test replay tests/login/portal-login.yaml --debug   # 单步调试
# 批量/并行
pdd test replay ./tests/asset-eval/
pdd test replay tests/*.yaml --parallel --max-tabs=3
pdd test replay ./tests/ --rerun-failed

参考文档索引

相关资源

• 上游: Testcase Modeler (生成YAML)
• 配置: config/test-actions.yaml, config/cdp-test-config.yaml
• 报告模板: templates/report-template.html

FAQ

• 如何触发: 提供 YAML 路径/内容，或说"执行/运行/回放测试"
• 失败排查: 看 HTML 报告失败详情+诊断，或 --debug 单步
• 提高自愈率: target 描述准确稳定，定期更新 UID 缓存
• 支持浏览器: Chromium 内核(Chrome/Edge/Brave)，需开远程调试端口
• CI/CD集成: CLI 命令+JUnit XML 输出，见 cli-reference.md

版本历史: v1.0.0(774行) → v1.0.1(三层重构<300行,详情移references/)