问题上报规范

自动化跑出来的失败分两种：用例问题和产品缺陷。先分清再提。

先判断是哪种

现象	多半是	处理
截图里页面正常，但 AI 没找到元素	用例写得不够清楚	改描述，加位置限定词
截图里页面还在加载、白屏	等待不够	前面加 aiWaitFor
被弹窗挡住	环境干扰	beforeEach 关弹窗
重跑一次就过了	偶发	连续两次都挂再提
截图里页面确实显示错了（金额不对、状态不对、报错）	产品缺陷	提单

提单要带什么

1. 标题：一句话说清"在哪里做什么，结果怎么不对"。
   • 好：购物车改数量为 2 后小计仍显示单价
   • 差：购物车有 bug
2. 环境：Web 还是 Android，测试环境地址或包版本，浏览器或机型。
3. 账号：用的哪个测试账号。
4. 复现步骤：直接贴用例里失败 case 的 steps 就行，这就是复现步骤。
5. 预期 vs 实际：预期贴 aiAssert 的内容，实际贴报告里的截图和 AI 判断原因。
6. 附件：midscene_run/report/ 下对应的 HTML 报告整个附上。报告是自包含的单文件，别人双击就能看。
7. 频率：必现、还是连续跑 N 次挂 M 次。

模板

【环境】Web / test.example.com / Chromium 1280×720
【账号】13800000000
【用例】cases/web/cart.yaml → "修改购物车数量"
【步骤】
  1. 打开购物车
  2. 把第一个商品数量改为 2
【预期】小计 = 单价 × 2
【实际】小计仍为单价，见报告第 3 步截图
【频率】必现，连续 3 次
【附件】2026-11-10_153012.html

用例问题怎么处理

• 自己能改的直接改用例，跑通后提交。
• 拿不准的在群里贴报告截图问。
• 涉及框架、节点（nodes/、midscene.config.ts）的改动找框架负责人。

提交用例的要求

• 新用例在本地至少跑通一次再提交。
• 不要提交 .env、midscene_run/。
• 一个 PR 一个业务模块，方便 review。