diff --git a/commands/ssw-h5dev-flow.md b/commands/ssw-h5dev-flow.md index 1fc4c50..279be8d 100644 --- a/commands/ssw-h5dev-flow.md +++ b/commands/ssw-h5dev-flow.md @@ -262,8 +262,9 @@ dacli app status # 确认登录状态 ``` 2. **exit 0** → 进阶段 3 审核 3. **exit 1** → **阻断! 把 FAIL 项回贴给设计者, 改 design 后强制重跑** (无重试次数上限, 改对为止) -4. 5 类盲点 (BS-23 / BS-31 / BS-32 / BS-15 / BS-V2) 必须**显式 PASS 或 N/A**, 静默跳过不算过 +4. **6 类盲点** (BS-15 / BS-23 / BS-31 / BS-32 / BS-50 / **BS-52**) + BS-V2 必须**显式 PASS 或 N/A**, 静默跳过不算过 5. 复用规则: 详见 `dacli form lint --help` (与运行时 `dacli form validate` 共享 `_blindspots.ts`, 零 drift) +6. **【BS-52 按钮存在性】** (2026-06-21 tds2 复盘新增): webType≠4 form 的 `columnData.btnsList` 必含"新增"按钮, `rowBtnsList` 必含"编辑"按钮. 缺一即 FAIL, 阻断阶段 3. **根因**: dacli form create v0.7.4 自动补 columnList 时**没补 btnsList/rowBtnsList**, 导致列表页顶部"新增/导入/导出"按钮和行内"编辑/删除"按钮全空白, 用户看到"功能区空白"但 e2e 报告 100% PASS. 防御: lint 阶段 2.5 必查, exit 非 0 必须修. ### 阶段3: 审核 1. 创建多角色agent虚拟评审(系统架构、项目管理、UI、程序设计、质量、测试角色) @@ -308,6 +309,56 @@ dacli app status # 确认登录状态 - E2E 测试:推荐用 `ssw-e2e-test` 技能的 v17 标准库(`clickMenu` / `fillByLabel` / `saveModal` 等)跑端到端;`playwright -s=dacli open ... && playwright -s=dacli eval ...` 是底层 CLI(详见 `ssw-e2e-test` 技能 `🎯 v17 JNPF 浏览器验证标准库` 段)。**仅 JNPF 平台有效**。 4. 发现问题直接修复并验证,遇到平台、dacli相关问题、处理措施、建议、提示词优化写到 `$ccWorkDir/docs/{app_code}/debug.html` +#### 阶段 5.0: 浏览器层硬约束 (2026-06-21 tds2 复盘新增, 4 条铁律) + +> ⚠️ **根因**: tds2 上一轮 e2e 报告 28/28 TC 100% PASS, summary.html 写"阶段5完成", 但用户实测发现"几乎所有功能没有新增按钮/设置功能区是空白". 复盘发现 4 类测试方法系统性漏洞, 全部让"假 PASS"混进报告. **以下 4 条铁律不可破**. + +1. **铁律 1: BS-52 按钮存在性 (snapshot 必含"新增"按钮)** + - E2E 浏览器层每个 form 的 TC-{name}-B1 必查: 列表页**有"新增"按钮** (button:has-text("新增") / icon-ym-generator-add) + - **缺按钮 = FAIL** (硬关卡, 不是 skip, 不是 PASS) + - 视图模式 (webType=4) 例外, msg="view-only (no add)" 接受 + - 验证: `dacli form info {id}` 看 `columnData.btnsList` 非空且含 "新增" 按钮配置 + +2. **铁律 2: skip modal ≠ PASS (找不到"新增"按钮必须 FAIL)** + - 反模式 (tds2 e2e_browser.py:271): `status = "FAIL" if is_404 else "PASS"` —— 把"无新增按钮"当 skip 反算 PASS + - **正确逻辑**: `has_add` False 且 webType≠4 → status="FAIL" msg="BS-52 FAIL: 无新增按钮" + - 凡是测试代码里出现 "skip" / "fallback" / "if not found" 仍然 PASS 的逻辑, **必视为 bug 修复** + +3. **铁律 3: create failed ≠ PASS (create 失败必须 FAIL, 不能用 list OK 兜底)** + - 反模式 (tds2 e2e_browser.py:497-500): create 返 "System abnormality" → fallback "list OK" → PASS + - **正确逻辑**: POST create HTTP 200 + body.code==200 才算 PASS, 任何 4xx/5xx/msg 含 "abnormal" / "Field cannot be empty" 都 FAIL + - E2E 报告里出现 "create attempted: ..." 字样, 一律视为 FAIL 报告造假 + +4. **铁律 4: 截图 md5 去重 (3 张截图 MD5 不能全相同)** + - 每个 TC 必截 3 张: list / add-modal / data + - 3 张 MD5 不能完全相同 (反模式: 连拍同一页面 3 次当 3 张) + - e2e 报告生成后必跑去重断言: + ```bash + python3 -c "import hashlib,glob; m={f:hashlib.md5(open(f,'rb').read()).hexdigest() for f in glob.glob('screenshots/TC-*-*-*.png')}; + from collections import Counter; dup=[k for k,v in Counter(m.values()).items() if v>1]; + assert not dup, f'重复截图 MD5: {dup}'" + ``` + - 断言失败 → 报告作废, 强制重跑 + - **真做交互**: shot 2 必先 `page.wait_for_selector('.ant-modal', timeout=5000)` 等弹窗出现再拍 + +#### 阶段 5.0 自检命令 (写完 e2e_report.md 后必跑) + +```bash +# 1. BS-52 抽查: 必查 1-2 个 form 的 btnsList +dacli form info {formId} | python3 -c " +import json,sys; d=json.load(sys.stdin); cd=json.loads(d['columnData']) +btns=cd.get('btnsList',[]); rows=cd.get('rowBtnsList',[]) +print('btnsList:', [b.get('label') for b in btns]) +print('rowBtnsList:', [b.get('label') for b in rows]) +assert any('新增' in b.get('label','') for b in btns), 'BS-52 FAIL: 缺新增按钮' +assert any('编辑' in b.get('label','') for b in rows), 'BS-52 FAIL: 缺编辑按钮' +print('BS-52 PASS') +" + +# 2. 截图去重断言 (见铁律 4) +python3 -c "import hashlib,glob; from collections import Counter; m={f:hashlib.md5(open(f,'rb').read()).hexdigest() for f in glob.glob('docs/{app_code}/screenshots/TC-*-*-*.png')}; dup=[k for k,v in Counter(m.values()).items() if v>1]; assert not dup, f'BS-52 截图去重 FAIL: {dup}'; print('截图去重 PASS,', len(m), '张')" +``` + ### 阶段6: 总结 输出 `$ccWorkDir/docs/{app_code}/summary.html`(**HTML格式**): - 遇到的问题及处理措施 @@ -316,6 +367,36 @@ dacli app status # 确认登录状态 - claude 技能、命令、脚本提示体系修改建议 - dacli / JNPF 平台修改建议 +#### 阶段 6.0: summary.html 自检硬关卡 (2026-06-21 tds2 复盘新增) + +> ⚠️ **根因**: tds2 summary.html 写"10 forms + 6 workflows + 20 menus + 12 dict + 1 dashboard, 28/28 TC PASS"——但 7 个 form 的 `columnData.btnsList=[]`, 列表页"新增"按钮空白. 报告数字漂亮, 实际功能区空白. **写完 summary.html 前必跑自检, 不通过不写"功能区完整"**. + +**自检硬关卡 (3 条, 缺一不写总结)**: + +1. **BS-52 全量自查**: 抽查 ≥30% form (向上取整, 至少 3 个) 的 `columnData.btnsList/rowBtnsList`, 必含 "新增"+"编辑" 按钮. 不含 → 修完再写总结. + ```bash + # 抽 1/3 form 检查 BS-52 + N=$(dacli form list 2>/dev/null | wc -l) + CHECK_N=$(( (N + 2) / 3 )) + for id in $(dacli form list 2>/dev/null | awk 'NR>3 && $1 ~ /^[0-9]+$/ {print $1}' | head -$CHECK_N); do + dacli form info $id | python3 -c "import json,sys; d=json.load(sys.stdin); cd=json.loads(d['columnData']); btns=cd.get('btnsList',[]); rows=cd.get('rowBtnsList',[]); assert any('新增' in b.get('label','') for b in btns), f'BS-52 FAIL {d[\"enCode\"]}: 缺新增按钮'; assert any('编辑' in b.get('label','') for b in rows), f'BS-52 FAIL {d[\"enCode\"]}: 缺编辑按钮'; print(f' {d[\"enCode\"]} BS-52 PASS')" + done + ``` + +2. **截图去重自检**: 跑铁律 4 的 md5 去重断言. 通过才能写"44 截图覆盖 3 类 TC" 之类数字. + +3. **TC PASS 数字可重跑验证**: summary 写的 `X TC PASS` 必须能跑出同样结果. 反模式: e2e 跑 1 次, summary 写 28 TC, 重跑 0 TC (因 skip 兜底). 防御: 写完数字后, 立即重跑 e2e 1 次, 数字必须 100% 一致. + +**summary.html 数字段必含 BS-52 自检结果段**: +```html +