@harmonyos-arkts/d2h 0.1.10 → 0.1.12

package/skills/d2h-hypium-forge/scripts/forge_report.py

@@ -1,325 +1,325 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""forge_report.py — 每工程测试执行报告（HTML，参考 Allure/extent 信息架构，零依赖）。
-
-数据源（.hypium_forge/ 下）：
-  results.json   最新一轮执行结果（case/status/msg/dur）
-  cases.json     用例（含 priority/scenarios/steps/title）
-  scenarios.json 场景注册表（可选，有则出场景维度）
-  reports/<d>/<ts>/  截图：<case>.jpeg（成功）/ <case>_fail.jpeg（失败）
-
-产出：test-report.html
-  ① 执行概况：总数/通过率/优先级分布/耗时统计/场景覆盖
-  ② 用例明细卡片：状态徽标、优先级、场景、步骤、失败原因、耗时、成功&失败截图
-  ③ 结果条形总览（纯 CSS，按用例序排列）
-
-用法（在 .hypium_forge 目录下）:
-  python3 forge_report.py [--run-dir reports/2026-09-27/10-04-05]   # 不指定则取最新
-"""
-import argparse
-import glob
-import html
-import json
-import os
-from datetime import datetime
-
-
-EMBED = False  # --embed：关键帧 base64 内嵌开关
-
-
-def thumb_b64(path, max_w=480):
-    """sips 缩略 → base64（macOS 零依赖；失败返回 None 走原相对路径）。"""
-    import base64 as _b64
-    import subprocess as _sp
-    import tempfile as _tf
-    try:
-        with _tf.NamedTemporaryFile(suffix='.jpeg', delete=False) as tf:
-            tmp = tf.name
-        _sp.run(['sips', '-Z', str(max_w), '-s', 'formatOptions', '55', path, '--out', tmp],
-                capture_output=True, timeout=15)
-        data = open(tmp, 'rb').read()
-        import os as _os
-        _os.unlink(tmp)
-        return 'data:image/jpeg;base64,' + _b64.b64encode(data).decode()
-    except Exception:
-        return None
-
-
-def load(path, default=None):
-    if os.path.exists(path):
-        with open(path, encoding='utf-8') as f:
-            return json.load(f)
-    return default
-
-
-def find_latest_run():
-    runs = sorted(glob.glob(os.path.join('reports', '*', '*')))
-    dirs = [r for r in runs if os.path.isdir(r) and
-            (glob.glob(os.path.join(r, '*.jpeg')) or glob.glob(os.path.join(r, '*.jpg')) or
-             glob.glob(os.path.join(r, '*.png')))]
-    return dirs[-1] if dirs else None
-
-
-__JS__ = '<script>var btns=document.querySelectorAll(".filters button");var f={st:"",pr:""};btns.forEach(function(b){b.onclick=function(){document.querySelectorAll(\'[data-f="\'+b.dataset.f+\'"]\').forEach(function(x){x.classList.remove("on")});b.classList.add("on");f[b.dataset.f]=b.dataset.v;apply();};});document.getElementById("q").oninput=apply;function apply(){var q=document.getElementById("q").value.toLowerCase();document.querySelectorAll("tr.row").forEach(function(tr){var ok=(!f.st||tr.dataset.st===f.st)&&(!f.pr||tr.dataset.pr===f.pr)&&(!q||tr.dataset.kw.indexOf(q)>=0);tr.classList.toggle("hide",!ok);});}</script>'
-
-def main():
-    ap = argparse.ArgumentParser()
-    ap.add_argument('--run-dir', default=None)
-    ap.add_argument('--out', default='test-report.html')
-    ap.add_argument('--embed', action='store_true', help='关键帧缩略图 base64 内嵌（单文件可分发）')
-    args = ap.parse_args()
-
-    global EMBED
-    EMBED = args.embed
-    cases = {c['id']: c for c in load('cases.json', [])}
-    if not cases:
-        import re as _re
-        for pf in glob.glob(os.path.join('testcases', 'T[CP]*.py')):
-            try:
-                src = open(pf, encoding='utf-8', errors='replace').read()
-            except Exception:
-                continue
-            mid = os.path.splitext(os.path.basename(pf))[0]
-            base = mid.split('_')[0]
-            m = _re.search(r'\"\"\"(.+?)\"\"\"', src, _re.S)
-            title = mid
-            if m:
-                title = m.group(1).strip().splitlines()[0][:50]
-            cases[base] = {'id': base, 'title': title, 'priority': '未分级',
-                           'detail': (m.group(1).strip()[:600] if m else '')}
-    results = load('results.json', [])
-    scenarios = {s['id']: s for s in load('scenarios.json', [])}
-    run_dir = args.run_dir or find_latest_run()
-
-    # 结果 → 用例 id 归一（类名带 slug 后缀）
-    norm = []
-    for r in results:
-        rc = r.get('case', '')
-        cid = max((c for c in cases if rc == c or rc.startswith(c + '_')), key=len, default=rc)
-        norm.append((cid, r))
-
-    n = len(norm)
-    p = sum(1 for _, r in norm if r.get('status') == 'PASS')
-    fails = sum(1 for _, r in norm if r.get('status') == 'FAIL')
-    durs = [r.get('dur', 0) for _, r in norm]
-    total_dur = sum(durs)
-
-    pr_stat = {}
-    for cid, r in norm:
-        pr = cases.get(cid, {}).get('priority', '未分级')
-        pr_stat.setdefault(pr, [0, 0])
-        pr_stat[pr][0] += 1
-        pr_stat[pr][1] += 1 if r.get('status') == 'PASS' else 0
-
-    cov = {}
-    for cid, c in cases.items():
-        for fs in c.get('scenarios', []):
-            cov[fs] = cov.get(fs, 0) + 1
-
-    def shot(cid, rc='', suffix=''):
-        """按 类名(rc) → 用例id 逐级匹配截图文件（类名带 slug 后缀，如 TC01_case/TC05_webview）"""
-        if not run_dir:
-            return None
-        for stem in (rc, cid):
-            for ext in ('.jpeg', '.jpg', '.png'):
-                f = os.path.join(run_dir, stem + suffix + ext)
-                if os.path.exists(f):
-                    return os.path.relpath(f)
-        # 前缀兜底：TC05_webview 类名带 slug
-        pats = [os.path.join(run_dir, f'{cid}_*{suffix}.jpeg'), os.path.join(run_dir, f'{cid}_*{suffix}.jpg')]
-        for pat in pats:
-            g = sorted(glob.glob(pat))
-            if g:
-                return os.path.relpath(g[0])
-        return None
-
-    css = """
-  :root{--bg:#f4f6f9;--card:#fff;--ink:#20242c;--sub:#68707e;--line:#e5e8ee;
-        --ok:#0e9f6e;--bad:#e02424;--key:#3b6fd4}
-  *{box-sizing:border-box}
-  body{margin:0;font:14.5px/1.6 -apple-system,"PingFang SC","Microsoft YaHei",sans-serif;background:var(--bg);color:var(--ink)}
-  .wrap{max-width:1100px;margin:0 auto;padding:28px 20px 70px}
-  h1{font-size:23px;margin:.2em 0 .2em}
-  .meta{color:var(--sub);font-size:12.5px}
-  .kpis{display:grid;grid-template-columns:repeat(auto-fit,minmax(140px,1fr));gap:10px;margin:18px 0}
-  .kpi{background:var(--card);border:1px solid var(--line);border-radius:9px;padding:12px 14px}
-  .kpi b{display:block;font-size:22px}
-  .kpi span{font-size:12px;color:var(--sub)}
-  .pass b{color:var(--ok)}.fail b{color:var(--bad)}
-  .bar{display:flex;height:12px;border-radius:6px;overflow:hidden;margin:6px 0 2px}
-  .bar i{display:block;height:100%}
-  .lg{font-size:11.5px;color:var(--sub)}
-  table{width:100%;border-collapse:collapse;background:var(--card);border:1px solid var(--line);
-        border-radius:9px;overflow:hidden;font-size:13px;margin:10px 0 4px}
-  th,td{padding:7px 10px;border-bottom:1px solid var(--line);text-align:left}
-  th{background:#eef2f8;font-size:12px}
-  h2{font-size:17px;border-left:4px solid var(--key);padding-left:9px;margin:30px 0 10px}
-  .case{background:var(--card);border:1px solid var(--line);border-left-width:4px;border-radius:9px;
-        padding:13px 16px;margin-bottom:12px}
-  .case.pass{border-left-color:var(--ok)}.case.fail{border-left-color:var(--bad)}
-  .hd{display:flex;flex-wrap:wrap;gap:8px;align-items:baseline}
-  .hd b{font-size:15px}
-  .badge{font-size:11px;border-radius:4px;padding:1px 7px;color:#fff}
-  .b-pass{background:var(--ok)}.b-fail{background:var(--bad)}.b-l0{background:#b42318}
-  .b-l1{background:#c27803}.b-l2{background:#68707e}.b-dur{background:#3b6fd4}
-  .detail{background:#f8fafc;border-left:3px solid #cbd5e1;padding:8px 10px;font-size:12px;white-space:pre-wrap;color:#475569;margin:6px 0;max-height:220px;overflow:auto}
-  .steps{margin:8px 0 0;padding-left:0;list-style:none;font-size:13px}
-  .steps li{padding:2px 0 2px 18px;position:relative;color:#333}
-  .steps li:before{content:"▸";position:absolute;left:2px;color:#9aa3b2}
-  .steps code{background:#eef1f6;border-radius:3px;padding:0 5px;font-size:12px}
-  .reason{margin-top:8px;background:#fdf3f3;border:1px solid #f3c9c9;border-radius:7px;
-          padding:8px 11px;font:12px/1.6 ui-monospace,Menlo,monospace;color:#a31111;
-          white-space:pre-wrap;word-break:break-all}
-  .shots{display:grid;grid-template-columns:repeat(auto-fit,minmax(190px,1fr));gap:10px;margin-top:10px}
-  .shots figure{margin:0;border:1px solid var(--line);border-radius:8px;padding:7px;text-align:center;background:#fafbfd}
-  .shots img{max-width:100%;max-height:330px;border-radius:5px;border:1px solid var(--line)}
-  .shots figcaption{font-size:11.5px;color:var(--sub);margin-top:4px}
-  .fs{font-size:12px;color:var(--sub);margin-top:4px}
-  .filters{display:flex;flex-wrap:wrap;gap:8px;align-items:center;margin:8px 0}
-  .filters button{border:1px solid var(--line);background:#fff;border-radius:14px;
-                  padding:3px 13px;font-size:12.5px;cursor:pointer}
-  .filters button.on{background:var(--key);color:#fff;border-color:var(--key)}
-  .filters input{border:1px solid var(--line);border-radius:7px;padding:4px 9px;font-size:12.5px;width:170px}
-  tr.hide{display:none}
-  """
-
-    H = [f'<!DOCTYPE html><html lang="zh-CN"><head><meta charset="UTF-8">',
-         '<meta name="viewport" content="width=device-width, initial-scale=1.0">',
-         '<title>测试执行报告</title>', f'<style>{css}</style></head><body><div class="wrap">',
-         f'<h1>测试执行报告 — {os.path.basename(os.getcwd())}</h1>',
-         f'<div class="meta">工程用例目录：{os.getcwd()} ｜ 执行时间：{datetime.now():%Y-%m-%d %H:%M} ｜ '
-         f'截图轮次：{os.path.relpath(run_dir) if run_dir else "无"}</div>']
-
-    # 概况
-    rate = f'{p}/{n}（{p*100//n if n else 0}%）'
-    ok_pct = int(p * 100 / n) if n else 0
-    H += ['<div class="kpis">',
-          f'<div class="kpi pass"><b>{p}/{n}</b><span>通过</span></div>',
-          f'<div class="kpi fail"><b>{fails}</b><span>失败</span></div>',
-          f'<div class="kpi"><b>{rate}</b><span>通过率</span></div>',
-          f'<div class="kpi"><b>{total_dur:.0f}s</b><span>总耗时（单例均值 {total_dur/n if n else 0:.1f}s / 最长 {max(durs) if durs else 0:.0f}s）</span></div>',
-          f'<div class="kpi"><b>{len(cov)}/{len(scenarios) or "—"}</b><span>场景覆盖（引用数）</span></div>',
-          '</div>',
-          '<div class="bar">',
-          f'<i style="width:{ok_pct}%;background:var(--ok)"></i><i style="width:{100-ok_pct}%;background:var(--bad)"></i></div>',
-          f'<div class="lg">通过 {p} ｜ 失败 {fails} ｜ 优先级：'
-          + ' ／ '.join(f'{k} {v[1]}/{v[0]}' for k, v in sorted(pr_stat.items()))
-          + '</div>']
-
-    # 结果总览：可筛选表格
-    H += ['<h2>结果总览</h2>',
-          '<div class="filters">',
-          '<span style="font-size:12.5px;color:var(--sub)">状态：</span>',
-          '<button class="on" data-f="st" data-v="">全部</button>',
-          '<button data-f="st" data-v="PASS">PASS</button>',
-          '<button data-f="st" data-v="FAIL">FAIL</button>',
-          '<span style="font-size:12.5px;color:var(--sub)">优先级：</span>',
-          '<button class="on" data-f="pr" data-v="">全部</button>']
-    for pr in sorted(pr_stat):
-        H.append(f'<button data-f="pr" data-v="{pr}">{pr}</button>')
-    H += ['<input id="q" placeholder="搜索用例号/标题/失败原因…">',
-          '</div>',
-          '<table id="rt"><tr><th>用例</th><th>标题</th><th>结果</th><th>优先级</th>'
-          '<th>耗时</th><th>失败原因</th></tr>']
-    for cid, r in norm:
-        c = cases.get(cid, {})
-        st = r.get('status', '?')
-        stc = 'var(--ok)' if st == 'PASS' else 'var(--bad)'
-        pr = c.get('priority', '未分级')
-        msg = html.escape(str(r.get('msg', ''))[:120])
-        title = html.escape(str(c.get('title', '')))
-        H.append(f'<tr class="row" data-st="{st}" data-pr="{pr}" '
-                 f'data-kw="{html.escape((cid + " " + c.get("title","") + " " + str(r.get("msg",""))).lower()[:200])}">'
-                 f'<td><b>{cid}</b></td><td>{title}</td>'
-                 f'<td style="color:{stc};font-weight:600">{st}</td><td>{pr}</td>'
-                 f'<td>{r.get("dur","?")}s</td><td style="font-size:12px;max-width:340px">'
-                 f'<span style="word-break:break-all">{msg or "—"}</span></td></tr>')
-    H += ['</table>', __JS__]
-
-    # 优先级表
-    H += ['<h2>优先级维度</h2>', '<table><tr><th>优先级</th><th>通过/总数</th><th>说明</th></tr>']
-    desc = {'L0': '冒烟/阻断——失败即阻断发版', 'L1': '重要功能——失败当版修复', 'L2': '次要/边界——择期处理', '未分级': '未标注优先级'}
-    for k, v in sorted(pr_stat.items()):
-        color = 'color:var(--ok)' if v[1] == v[0] else 'color:var(--bad)'
-        H.append(f'<tr><td><b>{k}</b></td><td style="{color}">{v[1]}/{v[0]}</td><td>{desc.get(k,"")}</td></tr>')
-    H += ['</table>']
-
-    # 用例明细
-    H += ['<h2>用例明细</h2>']
-    for cid, r in norm:
-        c = cases.get(cid, {})
-        st = r.get('status', '?')
-        cls = 'pass' if st == 'PASS' else 'fail'
-        pr = c.get('priority', '')
-        prb = f'<span class="badge b-{pr.lower() if pr else "l2"}">{pr}</span>' if pr else ''
-        fs_ids = c.get('scenarios', [])
-        fs_txt = '、'.join(f'{i}({scenarios[i]["name"]})' for i in fs_ids if i in scenarios) or '—'
-        H += [f'<div class="case {cls}">',
-              '<div class="hd">',
-              f'<span class="badge b-{"pass" if st=="PASS" else "fail"}">{st}</span>',
-              f'<b>{cid}</b>{prb}',
-              f'<span>{html.escape(str(c.get("title", "")))}</span>',
-              f'<span class="badge b-dur">{r.get("dur", "?")}s</span>',
-              '</div>',
-              f'<div class="fs">场景：{html.escape(fs_txt)}</div>']
-        steps = c.get('steps', [])
-        if steps:
-            H.append('<ul class="steps">')
-            for s_ in steps:
-                exp = {'exist': ' → 断言存在', 'absent': ' → 断言不存在'}.get(s_.get('expect'), '')
-                H.append(f'<li>{html.escape(str(s_.get("action","")))} '
-                         f'<code>{html.escape(str(s_.get("target","")))}</code>{exp}</li>')
-            H.append('</ul>')
-        elif c.get('detail'):  # 无设计稿（直写 py）：docstring 行为链作为用例详情
-            H.append('<pre class="detail">')
-            H.append(html.escape(str(c['detail'])))
-            H.append('</pre>')
-        if r.get('msg'):
-            H.append(f'<div class="reason">失败原因：{html.escape(str(r["msg"])[:600])}</div>')
-        # 分步画廊：该用例全部步骤图（<case>_NN_label.jpeg）+ 结束/失败图
-        imgs = []
-        if run_dir:
-            pats = [os.path.join(run_dir, r.get('case', cid) + '_*.jpeg'),
-                    os.path.join(run_dir, cid + '_*.jpeg'),
-                    os.path.join(run_dir, cid + '_p*.jpeg')]
-            seen = set()
-            for pat in pats:
-                for g in sorted(glob.glob(pat)):
-                    base = os.path.basename(g)
-                    if base.endswith('_fail.jpeg') or base.endswith('_end.jpeg'):
-                        continue
-                    if base not in seen:
-                        seen.add(base)
-                        lbl = base.split('_', 2)[-1].rsplit('.', 1)[0]
-                        imgs.append((os.path.relpath(g), '步骤：' + lbl))
-            s_fail = shot(cid, r.get('case', ''), '_fail')
-            if s_fail:
-                imgs.append((s_fail, '失败现场'))
-            s_end = shot(cid, r.get('case', ''), '_end')
-            if st == 'PASS' and s_end:
-                imgs.append((s_end, '用例结束页'))
-        if imgs:
-            H.append('<div class="shots">')
-            for i, (path, cap) in enumerate(imgs):
-                src = path
-                if EMBED:  # 关键帧内嵌：fail/end 必嵌 + 过程帧首末张；其余保留相对路径（同目录可看全图）
-                    key = ('失败现场' in cap) or ('结束页' in cap) or i in (0, len(imgs) - 2)
-                    if key:
-                        b64 = thumb_b64(path)
-                        if b64:
-                            src = b64
-                H.append(f'<figure><img src="{src}" loading="lazy"><figcaption>{cap}</figcaption></figure>')
-            H.append('</div>')
-        H.append('</div>')
-
-    H += ['<div class="meta" style="margin-top:30px">由 forge_report.py 生成 ｜ '
-          '数据：results.json + cases.json + scenarios.json ｜ 截图：run_direct 执行时自动采集</div>',
-          '</div></body></html>']
-
-    with open(args.out, 'w', encoding='utf-8') as f:
-        f.write('\n'.join(H))
-    print(f'[written] {args.out}（{n} 用例 / PASS {p} / 截图目录 {os.path.relpath(run_dir) if run_dir else "无"}）')
-
-
-if __name__ == '__main__':
-    main()
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""forge_report.py — 每工程测试执行报告（HTML，参考 Allure/extent 信息架构，零依赖）。
+
+数据源（.hypium_forge/ 下）：
+  results.json   最新一轮执行结果（case/status/msg/dur）
+  cases.json     用例（含 priority/scenarios/steps/title）
+  scenarios.json 场景注册表（可选，有则出场景维度）
+  reports/<d>/<ts>/  截图：<case>.jpeg（成功）/ <case>_fail.jpeg（失败）
+
+产出：test-report.html
+  ① 执行概况：总数/通过率/优先级分布/耗时统计/场景覆盖
+  ② 用例明细卡片：状态徽标、优先级、场景、步骤、失败原因、耗时、成功&失败截图
+  ③ 结果条形总览（纯 CSS，按用例序排列）
+
+用法（在 .hypium_forge 目录下）:
+  python3 forge_report.py [--run-dir reports/2026-09-27/10-04-05]   # 不指定则取最新
+"""
+import argparse
+import glob
+import html
+import json
+import os
+from datetime import datetime
+
+
+EMBED = False  # --embed：关键帧 base64 内嵌开关
+
+
+def thumb_b64(path, max_w=480):
+    """sips 缩略 → base64（macOS 零依赖；失败返回 None 走原相对路径）。"""
+    import base64 as _b64
+    import subprocess as _sp
+    import tempfile as _tf
+    try:
+        with _tf.NamedTemporaryFile(suffix='.jpeg', delete=False) as tf:
+            tmp = tf.name
+        _sp.run(['sips', '-Z', str(max_w), '-s', 'formatOptions', '55', path, '--out', tmp],
+                capture_output=True, timeout=15)
+        data = open(tmp, 'rb').read()
+        import os as _os
+        _os.unlink(tmp)
+        return 'data:image/jpeg;base64,' + _b64.b64encode(data).decode()
+    except Exception:
+        return None
+
+
+def load(path, default=None):
+    if os.path.exists(path):
+        with open(path, encoding='utf-8') as f:
+            return json.load(f)
+    return default
+
+
+def find_latest_run():
+    runs = sorted(glob.glob(os.path.join('reports', '*', '*')))
+    dirs = [r for r in runs if os.path.isdir(r) and
+            (glob.glob(os.path.join(r, '*.jpeg')) or glob.glob(os.path.join(r, '*.jpg')) or
+             glob.glob(os.path.join(r, '*.png')))]
+    return dirs[-1] if dirs else None
+
+
+__JS__ = '<script>var btns=document.querySelectorAll(".filters button");var f={st:"",pr:""};btns.forEach(function(b){b.onclick=function(){document.querySelectorAll(\'[data-f="\'+b.dataset.f+\'"]\').forEach(function(x){x.classList.remove("on")});b.classList.add("on");f[b.dataset.f]=b.dataset.v;apply();};});document.getElementById("q").oninput=apply;function apply(){var q=document.getElementById("q").value.toLowerCase();document.querySelectorAll("tr.row").forEach(function(tr){var ok=(!f.st||tr.dataset.st===f.st)&&(!f.pr||tr.dataset.pr===f.pr)&&(!q||tr.dataset.kw.indexOf(q)>=0);tr.classList.toggle("hide",!ok);});}</script>'
+
+def main():
+    ap = argparse.ArgumentParser()
+    ap.add_argument('--run-dir', default=None)
+    ap.add_argument('--out', default='test-report.html')
+    ap.add_argument('--embed', action='store_true', help='关键帧缩略图 base64 内嵌（单文件可分发）')
+    args = ap.parse_args()
+
+    global EMBED
+    EMBED = args.embed
+    cases = {c['id']: c for c in load('cases.json', [])}
+    if not cases:
+        import re as _re
+        for pf in glob.glob(os.path.join('testcases', 'T[CP]*.py')):
+            try:
+                src = open(pf, encoding='utf-8', errors='replace').read()
+            except Exception:
+                continue
+            mid = os.path.splitext(os.path.basename(pf))[0]
+            base = mid.split('_')[0]
+            m = _re.search(r'\"\"\"(.+?)\"\"\"', src, _re.S)
+            title = mid
+            if m:
+                title = m.group(1).strip().splitlines()[0][:50]
+            cases[base] = {'id': base, 'title': title, 'priority': '未分级',
+                           'detail': (m.group(1).strip()[:600] if m else '')}
+    results = load('results.json', [])
+    scenarios = {s['id']: s for s in load('scenarios.json', [])}
+    run_dir = args.run_dir or find_latest_run()
+
+    # 结果 → 用例 id 归一（类名带 slug 后缀）
+    norm = []
+    for r in results:
+        rc = r.get('case', '')
+        cid = max((c for c in cases if rc == c or rc.startswith(c + '_')), key=len, default=rc)
+        norm.append((cid, r))
+
+    n = len(norm)
+    p = sum(1 for _, r in norm if r.get('status') == 'PASS')
+    fails = sum(1 for _, r in norm if r.get('status') == 'FAIL')
+    durs = [r.get('dur', 0) for _, r in norm]
+    total_dur = sum(durs)
+
+    pr_stat = {}
+    for cid, r in norm:
+        pr = cases.get(cid, {}).get('priority', '未分级')
+        pr_stat.setdefault(pr, [0, 0])
+        pr_stat[pr][0] += 1
+        pr_stat[pr][1] += 1 if r.get('status') == 'PASS' else 0
+
+    cov = {}
+    for cid, c in cases.items():
+        for fs in c.get('scenarios', []):
+            cov[fs] = cov.get(fs, 0) + 1
+
+    def shot(cid, rc='', suffix=''):
+        """按 类名(rc) → 用例id 逐级匹配截图文件（类名带 slug 后缀，如 TC01_case/TC05_webview）"""
+        if not run_dir:
+            return None
+        for stem in (rc, cid):
+            for ext in ('.jpeg', '.jpg', '.png'):
+                f = os.path.join(run_dir, stem + suffix + ext)
+                if os.path.exists(f):
+                    return os.path.relpath(f)
+        # 前缀兜底：TC05_webview 类名带 slug
+        pats = [os.path.join(run_dir, f'{cid}_*{suffix}.jpeg'), os.path.join(run_dir, f'{cid}_*{suffix}.jpg')]
+        for pat in pats:
+            g = sorted(glob.glob(pat))
+            if g:
+                return os.path.relpath(g[0])
+        return None
+
+    css = """
+  :root{--bg:#f4f6f9;--card:#fff;--ink:#20242c;--sub:#68707e;--line:#e5e8ee;
+        --ok:#0e9f6e;--bad:#e02424;--key:#3b6fd4}
+  *{box-sizing:border-box}
+  body{margin:0;font:14.5px/1.6 -apple-system,"PingFang SC","Microsoft YaHei",sans-serif;background:var(--bg);color:var(--ink)}
+  .wrap{max-width:1100px;margin:0 auto;padding:28px 20px 70px}
+  h1{font-size:23px;margin:.2em 0 .2em}
+  .meta{color:var(--sub);font-size:12.5px}
+  .kpis{display:grid;grid-template-columns:repeat(auto-fit,minmax(140px,1fr));gap:10px;margin:18px 0}
+  .kpi{background:var(--card);border:1px solid var(--line);border-radius:9px;padding:12px 14px}
+  .kpi b{display:block;font-size:22px}
+  .kpi span{font-size:12px;color:var(--sub)}
+  .pass b{color:var(--ok)}.fail b{color:var(--bad)}
+  .bar{display:flex;height:12px;border-radius:6px;overflow:hidden;margin:6px 0 2px}
+  .bar i{display:block;height:100%}
+  .lg{font-size:11.5px;color:var(--sub)}
+  table{width:100%;border-collapse:collapse;background:var(--card);border:1px solid var(--line);
+        border-radius:9px;overflow:hidden;font-size:13px;margin:10px 0 4px}
+  th,td{padding:7px 10px;border-bottom:1px solid var(--line);text-align:left}
+  th{background:#eef2f8;font-size:12px}
+  h2{font-size:17px;border-left:4px solid var(--key);padding-left:9px;margin:30px 0 10px}
+  .case{background:var(--card);border:1px solid var(--line);border-left-width:4px;border-radius:9px;
+        padding:13px 16px;margin-bottom:12px}
+  .case.pass{border-left-color:var(--ok)}.case.fail{border-left-color:var(--bad)}
+  .hd{display:flex;flex-wrap:wrap;gap:8px;align-items:baseline}
+  .hd b{font-size:15px}
+  .badge{font-size:11px;border-radius:4px;padding:1px 7px;color:#fff}
+  .b-pass{background:var(--ok)}.b-fail{background:var(--bad)}.b-l0{background:#b42318}
+  .b-l1{background:#c27803}.b-l2{background:#68707e}.b-dur{background:#3b6fd4}
+  .detail{background:#f8fafc;border-left:3px solid #cbd5e1;padding:8px 10px;font-size:12px;white-space:pre-wrap;color:#475569;margin:6px 0;max-height:220px;overflow:auto}
+  .steps{margin:8px 0 0;padding-left:0;list-style:none;font-size:13px}
+  .steps li{padding:2px 0 2px 18px;position:relative;color:#333}
+  .steps li:before{content:"▸";position:absolute;left:2px;color:#9aa3b2}
+  .steps code{background:#eef1f6;border-radius:3px;padding:0 5px;font-size:12px}
+  .reason{margin-top:8px;background:#fdf3f3;border:1px solid #f3c9c9;border-radius:7px;
+          padding:8px 11px;font:12px/1.6 ui-monospace,Menlo,monospace;color:#a31111;
+          white-space:pre-wrap;word-break:break-all}
+  .shots{display:grid;grid-template-columns:repeat(auto-fit,minmax(190px,1fr));gap:10px;margin-top:10px}
+  .shots figure{margin:0;border:1px solid var(--line);border-radius:8px;padding:7px;text-align:center;background:#fafbfd}
+  .shots img{max-width:100%;max-height:330px;border-radius:5px;border:1px solid var(--line)}
+  .shots figcaption{font-size:11.5px;color:var(--sub);margin-top:4px}
+  .fs{font-size:12px;color:var(--sub);margin-top:4px}
+  .filters{display:flex;flex-wrap:wrap;gap:8px;align-items:center;margin:8px 0}
+  .filters button{border:1px solid var(--line);background:#fff;border-radius:14px;
+                  padding:3px 13px;font-size:12.5px;cursor:pointer}
+  .filters button.on{background:var(--key);color:#fff;border-color:var(--key)}
+  .filters input{border:1px solid var(--line);border-radius:7px;padding:4px 9px;font-size:12.5px;width:170px}
+  tr.hide{display:none}
+  """
+
+    H = [f'<!DOCTYPE html><html lang="zh-CN"><head><meta charset="UTF-8">',
+         '<meta name="viewport" content="width=device-width, initial-scale=1.0">',
+         '<title>测试执行报告</title>', f'<style>{css}</style></head><body><div class="wrap">',
+         f'<h1>测试执行报告 — {os.path.basename(os.getcwd())}</h1>',
+         f'<div class="meta">工程用例目录：{os.getcwd()} ｜ 执行时间：{datetime.now():%Y-%m-%d %H:%M} ｜ '
+         f'截图轮次：{os.path.relpath(run_dir) if run_dir else "无"}</div>']
+
+    # 概况
+    rate = f'{p}/{n}（{p*100//n if n else 0}%）'
+    ok_pct = int(p * 100 / n) if n else 0
+    H += ['<div class="kpis">',
+          f'<div class="kpi pass"><b>{p}/{n}</b><span>通过</span></div>',
+          f'<div class="kpi fail"><b>{fails}</b><span>失败</span></div>',
+          f'<div class="kpi"><b>{rate}</b><span>通过率</span></div>',
+          f'<div class="kpi"><b>{total_dur:.0f}s</b><span>总耗时（单例均值 {total_dur/n if n else 0:.1f}s / 最长 {max(durs) if durs else 0:.0f}s）</span></div>',
+          f'<div class="kpi"><b>{len(cov)}/{len(scenarios) or "—"}</b><span>场景覆盖（引用数）</span></div>',
+          '</div>',
+          '<div class="bar">',
+          f'<i style="width:{ok_pct}%;background:var(--ok)"></i><i style="width:{100-ok_pct}%;background:var(--bad)"></i></div>',
+          f'<div class="lg">通过 {p} ｜ 失败 {fails} ｜ 优先级：'
+          + ' ／ '.join(f'{k} {v[1]}/{v[0]}' for k, v in sorted(pr_stat.items()))
+          + '</div>']
+
+    # 结果总览：可筛选表格
+    H += ['<h2>结果总览</h2>',
+          '<div class="filters">',
+          '<span style="font-size:12.5px;color:var(--sub)">状态：</span>',
+          '<button class="on" data-f="st" data-v="">全部</button>',
+          '<button data-f="st" data-v="PASS">PASS</button>',
+          '<button data-f="st" data-v="FAIL">FAIL</button>',
+          '<span style="font-size:12.5px;color:var(--sub)">优先级：</span>',
+          '<button class="on" data-f="pr" data-v="">全部</button>']
+    for pr in sorted(pr_stat):
+        H.append(f'<button data-f="pr" data-v="{pr}">{pr}</button>')
+    H += ['<input id="q" placeholder="搜索用例号/标题/失败原因…">',
+          '</div>',
+          '<table id="rt"><tr><th>用例</th><th>标题</th><th>结果</th><th>优先级</th>'
+          '<th>耗时</th><th>失败原因</th></tr>']
+    for cid, r in norm:
+        c = cases.get(cid, {})
+        st = r.get('status', '?')
+        stc = 'var(--ok)' if st == 'PASS' else 'var(--bad)'
+        pr = c.get('priority', '未分级')
+        msg = html.escape(str(r.get('msg', ''))[:120])
+        title = html.escape(str(c.get('title', '')))
+        H.append(f'<tr class="row" data-st="{st}" data-pr="{pr}" '
+                 f'data-kw="{html.escape((cid + " " + c.get("title","") + " " + str(r.get("msg",""))).lower()[:200])}">'
+                 f'<td><b>{cid}</b></td><td>{title}</td>'
+                 f'<td style="color:{stc};font-weight:600">{st}</td><td>{pr}</td>'
+                 f'<td>{r.get("dur","?")}s</td><td style="font-size:12px;max-width:340px">'
+                 f'<span style="word-break:break-all">{msg or "—"}</span></td></tr>')
+    H += ['</table>', __JS__]
+
+    # 优先级表
+    H += ['<h2>优先级维度</h2>', '<table><tr><th>优先级</th><th>通过/总数</th><th>说明</th></tr>']
+    desc = {'L0': '冒烟/阻断——失败即阻断发版', 'L1': '重要功能——失败当版修复', 'L2': '次要/边界——择期处理', '未分级': '未标注优先级'}
+    for k, v in sorted(pr_stat.items()):
+        color = 'color:var(--ok)' if v[1] == v[0] else 'color:var(--bad)'
+        H.append(f'<tr><td><b>{k}</b></td><td style="{color}">{v[1]}/{v[0]}</td><td>{desc.get(k,"")}</td></tr>')
+    H += ['</table>']
+
+    # 用例明细
+    H += ['<h2>用例明细</h2>']
+    for cid, r in norm:
+        c = cases.get(cid, {})
+        st = r.get('status', '?')
+        cls = 'pass' if st == 'PASS' else 'fail'
+        pr = c.get('priority', '')
+        prb = f'<span class="badge b-{pr.lower() if pr else "l2"}">{pr}</span>' if pr else ''
+        fs_ids = c.get('scenarios', [])
+        fs_txt = '、'.join(f'{i}({scenarios[i]["name"]})' for i in fs_ids if i in scenarios) or '—'
+        H += [f'<div class="case {cls}">',
+              '<div class="hd">',
+              f'<span class="badge b-{"pass" if st=="PASS" else "fail"}">{st}</span>',
+              f'<b>{cid}</b>{prb}',
+              f'<span>{html.escape(str(c.get("title", "")))}</span>',
+              f'<span class="badge b-dur">{r.get("dur", "?")}s</span>',
+              '</div>',
+              f'<div class="fs">场景：{html.escape(fs_txt)}</div>']
+        steps = c.get('steps', [])
+        if steps:
+            H.append('<ul class="steps">')
+            for s_ in steps:
+                exp = {'exist': ' → 断言存在', 'absent': ' → 断言不存在'}.get(s_.get('expect'), '')
+                H.append(f'<li>{html.escape(str(s_.get("action","")))} '
+                         f'<code>{html.escape(str(s_.get("target","")))}</code>{exp}</li>')
+            H.append('</ul>')
+        elif c.get('detail'):  # 无设计稿（直写 py）：docstring 行为链作为用例详情
+            H.append('<pre class="detail">')
+            H.append(html.escape(str(c['detail'])))
+            H.append('</pre>')
+        if r.get('msg'):
+            H.append(f'<div class="reason">失败原因：{html.escape(str(r["msg"])[:600])}</div>')
+        # 分步画廊：该用例全部步骤图（<case>_NN_label.jpeg）+ 结束/失败图
+        imgs = []
+        if run_dir:
+            pats = [os.path.join(run_dir, r.get('case', cid) + '_*.jpeg'),
+                    os.path.join(run_dir, cid + '_*.jpeg'),
+                    os.path.join(run_dir, cid + '_p*.jpeg')]
+            seen = set()
+            for pat in pats:
+                for g in sorted(glob.glob(pat)):
+                    base = os.path.basename(g)
+                    if base.endswith('_fail.jpeg') or base.endswith('_end.jpeg'):
+                        continue
+                    if base not in seen:
+                        seen.add(base)
+                        lbl = base.split('_', 2)[-1].rsplit('.', 1)[0]
+                        imgs.append((os.path.relpath(g), '步骤：' + lbl))
+            s_fail = shot(cid, r.get('case', ''), '_fail')
+            if s_fail:
+                imgs.append((s_fail, '失败现场'))
+            s_end = shot(cid, r.get('case', ''), '_end')
+            if st == 'PASS' and s_end:
+                imgs.append((s_end, '用例结束页'))
+        if imgs:
+            H.append('<div class="shots">')
+            for i, (path, cap) in enumerate(imgs):
+                src = path
+                if EMBED:  # 关键帧内嵌：fail/end 必嵌 + 过程帧首末张；其余保留相对路径（同目录可看全图）
+                    key = ('失败现场' in cap) or ('结束页' in cap) or i in (0, len(imgs) - 2)
+                    if key:
+                        b64 = thumb_b64(path)
+                        if b64:
+                            src = b64
+                H.append(f'<figure><img src="{src}" loading="lazy"><figcaption>{cap}</figcaption></figure>')
+            H.append('</div>')
+        H.append('</div>')
+
+    H += ['<div class="meta" style="margin-top:30px">由 forge_report.py 生成 ｜ '
+          '数据：results.json + cases.json + scenarios.json ｜ 截图：run_direct 执行时自动采集</div>',
+          '</div></body></html>']
+
+    with open(args.out, 'w', encoding='utf-8') as f:
+        f.write('\n'.join(H))
+    print(f'[written] {args.out}（{n} 用例 / PASS {p} / 截图目录 {os.path.relpath(run_dir) if run_dir else "无"}）')
+
+
+if __name__ == '__main__':
+    main()