@harmonyos-arkts/d2h 0.1.2 → 0.1.5

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

@@ -0,0 +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()

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

@@ -0,0 +1,114 @@
+#!/usr/bin/env python3
+"""
+inject_resource_ids.py — 资源化文案工程的 ID 注入器（DFT-010 场景）。
+
+流程：target 文本 → string.json 资源名 → 全工程搜 $r('app.string.X') 引用点
+     → 组件属性链内注入 .id('tc_<file>_<hash>')（幂等，已有 tc_ id 复用）
+
+输出 injected_ids.json（target → id 映射，供脚本生成器消费）
+用法: inject_resource_ids.py <harmony_root> <targets_json文件或逗号分隔> [--cases cases.json]
+"""
+import argparse
+import json
+import os
+import re
+import hashlib
+
+
+def build_res_map(root):
+    res_map = {}
+    for dp, _d, files in os.walk(root):
+        if 'oh_modules' in dp or '/build' in dp or '.testdesign' in dp or '.hypium_forge' in dp:
+            continue
+        for f in files:
+            if f == 'string.json':
+                try:
+                    for item in json.load(open(os.path.join(dp, f), encoding='utf-8')).get('string', []):
+                        res_map.setdefault(item['value'], item['name'])
+                except Exception:
+                    pass
+    return res_map
+
+
+def collect_src(root):
+    out = []
+    for dp, _d, files in os.walk(root):
+        if 'oh_modules' in dp or '/build' in dp or '.testdesign' in dp or '.hypium_forge' in dp:
+            continue
+        for f in files:
+            if f.endswith('.ets'):
+                out.append(os.path.join(dp, f))
+    return out
+
+
+ID_RE = re.compile(r"\.id\('tc_[a-z0-9_]+'\)")
+
+
+def inject_in_file(sf, rx):
+    """在 sf 中找 rx 引用行，属性链内注入 id；返回 (tid or None)。幂等。"""
+    src = open(sf, encoding='utf-8', errors='ignore').read()
+    lines = src.split('\n')
+    for i, ln in enumerate(lines):
+        if rx.search(ln):
+            seg = '\n'.join(lines[i:i + 12])
+            m = ID_RE.search(seg)
+            if m:
+                return m.group(0)[5:-2]  # 已有 → 复用
+            for k in range(i, min(len(lines), i + 10)):
+                if re.match(r'^\s*\.[a-zA-Z]', lines[k]):
+                    indent = re.match(r'(\s*)', lines[k]).group(1)
+                    tid = 'tc_' + os.path.splitext(os.path.basename(sf))[0].lower() + '_' + \
+                          hashlib.md5(ln.encode()).hexdigest()[:6]
+                    lines.insert(k, f"{indent}.id('{tid}')")
+                    open(sf, 'w', encoding='utf-8').write('\n'.join(lines))
+                    return tid
+    return None
+
+
+def main():
+    ap = argparse.ArgumentParser()
+    ap.add_argument('root')
+    ap.add_argument('--cases', help='forge 格式 cases.json（取 target）')
+    ap.add_argument('--targets', help='逗号分隔 target 列表（二选一）')
+    ap.add_argument('--out', default=None)
+    args = ap.parse_args()
+
+    targets = []
+    if args.cases:
+        for c in json.load(open(args.cases, encoding='utf-8')):
+            for s in c.get('steps', []):
+                t = s.get('target')
+                if t and not t.startswith('请输入') and t != '数量':
+                    targets.append(t)
+    else:
+        targets = args.targets.split(',')
+    targets = list(dict.fromkeys(targets))
+
+    res_map = build_res_map(args.root)
+    src_files = collect_src(args.root)
+
+    injected, unresolved = {}, []
+    for t in targets:
+        resname = res_map.get(t)
+        tid = None
+        if resname:
+            rx = re.compile(r"\$r\(\s*['\"]app\.string\." + re.escape(resname) + r"['\"]")
+            for sf in src_files:
+                tid = inject_in_file(sf, rx)
+                if tid:
+                    injected[t] = tid
+                    break
+        if not tid:
+            unresolved.append(t)
+
+    out = args.out or os.path.join(args.root, '.hypium_forge', 'injected_ids.json')
+    json.dump(injected, open(out, 'w', encoding='utf-8'), ensure_ascii=False, indent=1)
+    print(f'资源命中注入: {len(injected)} / 未解析: {len(unresolved)} → {out}')
+    for t, tid in sorted(injected.items()):
+        print(f'  + {t} → {tid}')
+    if unresolved:
+        print('未解析（动态文案/图标按钮，脚本走文本/兜底定位）:', unresolved[:15])
+
+
+if __name__ == '__main__':
+    main()

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

@@ -0,0 +1,80 @@
+#!/usr/bin/env python3
+"""lint_asserts.py — 断言强度门禁（白盒直写形态，2026-09-29 none 臂对照实证落地）。
+
+背景：none 臂（无 skill）LLM 凭通用能力达成 34% 强断言（hilog 防污染/dump Toast 轮询/
+剪贴板），B 线（抄模板）仅 15%——模板能力边界效应。本门禁把下限固化：
+  - 强断言步骤占比 ≥ 30%（默认阈值），低于即 FAIL
+  - vacuous 用例点名（纯点击链、无任何值级断言）——对应 assert_audit.py 语义（.py 版）
+
+值级断言原语：checked/unchecked/enabled/equals/text_equals/text_absent/toast_text_seen/
+hilog_tail(关键字)/pasteboard/剪贴板/_dump_layout 断言性使用/text_contains/count
+用法: python3 lint_asserts.py --dir testcases [--threshold 30]
+"""
+import argparse
+import glob
+import os
+import re
+import sys
+
+STRONG_CALLS = re.compile(
+    r'\b(checked|unchecked|enabled\(|disabled|text_equals|text_absent|toast_text_seen|'
+    r'hilog_clear|hilog_tail|pasteboard|剪贴板|text_contains|find_all_components\s*\(\s*BY\.)'
+    r'[^)]*\)|\bchecked\s*\(\s*True\)|assert\s')
+STEP_PAT = re.compile(r'^\s*(?:Step\(|step_shot\(|#)', re.M)
+ACTION_PAT = re.compile(r'\b(id_click|text_click|click_text|click_tab|id_input|d\.touch|press_back|swipe|scroll_click)\b')
+
+
+STRONG_STEP_WORDS = ('断言', '校验', 'equals', 'checked', 'absent', 'toast', 'hilog',
+                     '剪贴板', 'pasteboard', '包含', '等于', '消失', '翻转为', '已开启', '已关闭',
+                     '一致性', '业务数据', '关键字', 'dump')
+
+
+VALUE_CALLS = re.compile(
+    r'\b(text_equals|text_absent|toast_text_seen|hilog_clear|hilog_tail|pasteboard|'
+    r'find_all_components|checked\s*\(|asserts?\s*\.|\.assert)')
+
+
+def audit_file(path):
+    """双轨审计（两种白盒写法都覆盖）：
+    轨1 Step 结构：Step 描述含值级断言语义词 = 强步骤；
+    轨2 无 Step（内联代码）：值级断言调用数 / (值级调用+动作调用) 为强度。"""
+    src = open(path, encoding='utf-8').read()
+    steps_all = re.findall(r'Step\(\s*"([^"]+)"', src)
+    value_calls = len(VALUE_CALLS.findall(src))
+    if steps_all:
+        strong = sum(1 for t in steps_all if any(w in t.lower() for w in STRONG_STEP_WORDS))
+        return len(steps_all), 0, strong, strong > 0 or value_calls > 0
+    actions = len(ACTION_PAT.findall(src))
+    return value_calls + actions, 0, value_calls, value_calls > 0
+
+
+def main():
+    ap = argparse.ArgumentParser()
+    ap.add_argument('--dir', required=True)
+    ap.add_argument('--threshold', type=int, default=30)
+    args = ap.parse_args()
+    total_steps = total_strong = vacuous = n = 0
+    vacuous_list = []
+    for p in sorted(glob.glob(os.path.join(args.dir, 'TC*.py'))):
+        steps, marks, strong_steps, has_value = audit_file(p)
+        n += 1
+        total_steps += steps
+        total_strong += (strong_steps or marks)
+        if not has_value:
+            vacuous += 1
+            vacuous_list.append(os.path.basename(p))
+    pct = round(total_strong / total_steps * 100, 1) if total_steps else 0
+    print(f'断言强度: 强断言 {total_strong}/{total_steps} 步 = {pct}%（下限 {args.threshold}%）')
+    if vacuous_list:
+        print(f'⚠ vacuous 用例（无任何值级断言）{vacuous} 个: {", ".join(vacuous_list[:8])}')
+    if n and pct < args.threshold:
+        print(f'✗ FAIL：断言强度 {pct}% < {args.threshold}%——按场景目的补值级断言（最佳区间 40~70%）'
+              f'（Toast→toast_text_seen；系统事件→hilog 轮询+用例前 hilog_clear；'
+              f'状态→checked；文案→text_equals；消失→text_absent）后重检')
+        sys.exit(1)
+    print('✓ PASS')
+    sys.exit(0)
+
+
+if __name__ == '__main__':
+    main()

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

@@ -0,0 +1,60 @@
+#!/usr/bin/env python3
+"""lint_locate.py — 脚本定位方式自检门禁（铁律①的执行期强制）。
+
+统计 testcases/*.py 的定位调用（id_click 等 BY.key 原语 vs text_click/click_text），
+text 定位占比超阈值（默认 20%）即 FAIL 并列出改写建议（ids.json 有映射优先）。
+写完脚本后必须先过本门禁再执行。
+
+用法: python3 lint_locate.py --dir testcases [--ids ids.json] [--threshold 20]
+"""
+import argparse
+import glob
+import json
+import os
+import re
+import sys
+
+KEY_PRIMS = r'\bid_click\(|BY\.key\('
+TEXT_PRIMS = r'\btext_click\(|\bclick_text\(|BY\.text\((?![^)]*CONTAINS)|find_component\(\s*BY\.text'
+
+
+def main():
+    ap = argparse.ArgumentParser()
+    ap.add_argument('--dir', required=True)
+    ap.add_argument('--ids', default=None)
+    ap.add_argument('--threshold', type=int, default=20)
+    args = ap.parse_args()
+    ids = {}
+    if args.ids and os.path.exists(args.ids):
+        ids = json.load(open(args.ids, encoding='utf-8'))
+    total_key = total_text = 0
+    offenders = []
+    for p in sorted(glob.glob(os.path.join(args.dir, 'TC*.py'))):
+        src = open(p, encoding='utf-8').read()
+        k = len(re.findall(KEY_PRIMS, src))
+        t = len(re.findall(TEXT_PRIMS, src))
+        total_key += k
+        total_text += t
+        if t > k:
+            hint = ''
+            m = re.findall(r'(?:text_click|click_text)\(\s*d\s*,\s*[\'"]([^\'"]+)[\'"]', src)
+            mapped = [f"{x} → {ids[x]}" for x in m if x in ids][:3]
+            if mapped:
+                hint = ' | ids.json 有映射: ' + '; '.join(mapped)
+            offenders.append(f"{os.path.basename(p)}: key={k} text={t}{hint}")
+    total = total_key + total_text
+    pct = round(total_key / total * 100) if total else 100
+    print(f"定位统计: BY.key={total_key} / text={total_text} → key 占比 {pct}%（阈值 ≥{100 - args.threshold}%）")
+    if offenders:
+        print(f"text 主导的脚本 {len(offenders)} 个：")
+        for o in offenders[:15]:
+            print('  -', o)
+    if total and pct < 100 - args.threshold:
+        print(f"✗ FAIL：text 定位占比 {100 - pct}% > {args.threshold}% —— 须把 ids.json 有映射的 text_click 改写为 id_click 后重过门禁")
+        sys.exit(1)
+    print('✓ PASS')
+    sys.exit(0)
+
+
+if __name__ == '__main__':
+    main()