#!/usr/bin/env python3 # -*- coding: utf-8 -*- """反向验证:证明八道闸门的十四条判据「坏了会响、好了不响」(2026-11 第七轮起常驻)。 `gridcheck` / `rhythmcheck` / `tagcheck` / `btnrowcheck` / `footercheck` / `btnclustercheck` / `tableaudit` 量像素,`semanticcheck` 量辅助技术语义与真实按键——八道闸门自己也需要被体检一次:豁免写宽一格、阈值调松一档, 闸门就会永远安静地返回 0,而页面该修的地方一个都没修。 这里不碰源码、不触发 HMR——直接在页面上种两块 fixture: · `pb-*`(bad) :故意造出十六种缺陷——同族子块该用栅格却自然排列、流程条横向滚动、 同一行裸控件没坐进控件行(中心差 35px)、同一容器两档纵向间距、 收缩错位、标签铺语义色块、按钮组被劈成 2+1、 格子里并排内容越出单元格、整句散文当只读标签捅出容器右缘、 卡头行里还剩一整块没挪走却先把标题切成两行、 header 里那组横排按钮被劈成 2+1(第 17 轮删掉的旧豁免不许复活)、 浮层底部三颗按钮挤成 2+1(footercheck 管的那一族)、 不带任何类名的一簇按钮挤成 2+1(btnclustercheck 管的那一族)、 `div[role=button]` 没补 tabindex 的鼠标热区、带 `data-clickable` 却没键盘 路径的可点行、我们自己写的 `role=tab` 没进走位清单 (三条都是 semanticcheck 管的那一族) ——十六条缺陷,每条判据必须**点名**到它; · `pg-*`(good):故意造出十九种**合法**形态(卡底 mt-auto 钉底、整块居中的排版、 正文 max-w-[72ch] 栏宽、.nex-chipbar 胶囊流、 容器自适应的流程条、让位后与字段同行的复选框、 放得下的「进度条 + 百分数」单元格、 kit Tag 自己收窄成 ellipsis 的长标签、 右端整块掉到第二行之后标题拿到整行的卡头、 整组竖排等宽的按钮组(现行唯一那条豁免)、 整组竖排等宽的浮层底部(ActionGroup 翻竖排之后的形状)、 补了 `tabindex=0` 的自定义控件、原生 `button`、热区里那颗 pointer 图标、 有按钮的行连同它里面的图标、自绘的 `role=img`、antd v5 的图标根节点、 antd 自己的页签(阶段 2 的既定修法与 antd 内部结构,闸门必须放行)。 任何一条对不上就退出 1——说明闸门瞎了或者过敏,先修闸门再谈页面。 同一块夹具会被几条判据分别评,所以夹具种数(16 bad + 19 good)与判据条数(14)本来就对不上: 末行 `GATEPROBE_OK 14/14` 数的是**判据**,别拿它去核对 fixture 个数。 用法: .venv/bin/python scripts/ui/gateprobe.py """ import importlib.util import os import pathlib import sys from playwright.sync_api import sync_playwright HERE = pathlib.Path(__file__).resolve().parent BASE = os.environ.get("NEX_BASE", "http://127.0.0.1:5173") USER = os.environ.get("NEX_USER", "admin") PWD = os.environ.get("NEX_PASS", "admin1234") def load(mod_name: str): """按路径加载闸门模块,直接复用它们的探针 JS,避免同一份判据写两遍。""" spec = importlib.util.spec_from_file_location(mod_name, HERE / f"{mod_name}.py") mod = importlib.util.module_from_spec(spec) spec.loader.exec_module(mod) return mod tagcheck = load("tagcheck") rhythmcheck = load("rhythmcheck") gridcheck = load("gridcheck") btnrowcheck = load("btnrowcheck") footercheck = load("footercheck") btnclustercheck = load("btnclustercheck") tableaudit = load("tableaudit") semanticcheck = load("semanticcheck") FIXTURE = r"""() => { const old = document.getElementById('nex-gateprobe'); if (old) old.remove(); const host = document.createElement('div'); host.id = 'nex-gateprobe'; host.style.cssText = 'padding:24px;display:flex;flex-direction:column;gap:0'; host.innerHTML = `
反向验证标签
甲 乙乙乙 丙丙
完整视频
音效
字幕
交付包
完整视频
音效
字幕
交付包
环境声
环境声
反向验证长标签整句散文当只读标签必然捅出容器右缘
合法长标签整句散文当只读标签由 kit 收在容器内
pb-tspill
100%
pg-tspill
100%
pb-head镜头质检结论汇总清单表
重新质检 / 导出报告
pg-head模型配置已迁移至独立管理中心请前往模型控制台
重新质检 / 导出报告
`; (document.querySelector('main') || document.body).appendChild(host); /* 语义热区的夹具必须种在 **body 直下**(第 8.5 轮的教训):semanticcheck 的 HOTSPOT 只审我们自己写的标记,main 是 `.ant-layout-content`、整棵树又裹在 `.ant-app` 里, 夹具种进 main 就会被「这是 antd 的东西」顺手放过——夹具假绿比没夹具更糟。 它同时是这条判据的**视力表**:这一族空转过一次(12 路由 × 3 视口恒 0), 靠的就是这对 fixture 报出来的。 */ const old2 = document.getElementById('nex-gateprobe-sem'); if (old2) old2.remove(); const host2 = document.createElement('div'); host2.id = 'nex-gateprobe-sem'; host2.style.cssText = 'display:flex;flex-direction:column;gap:8px;width:400px'; host2.innerHTML = `
反向验证热区
补过 tabindex 的热区
可点的行行里的图标
有按钮的行
自绘的图标标注 antd 图标 `; document.body.appendChild(host2); return [...host.querySelectorAll('[class]'), ...host2.querySelectorAll('[class]')].length; }""" def names(rows, key): """把检出结果摊平成「元素标记串」,再用 fixture 的类名点名。 `key` 可以是字段名,也可以是函数:tableaudit 的 PROBE 会把页面上**每一张**表 都返回(不管有没有违规),按 `title` 摊平的话合法 fixture 也会出现在串里, 「必须放行」永远对不上——所以给它一个只摊平违规明细的函数。 """ # COLLECT 这类探针一次返回一整个 dict(热区/Tab 目标/aria/live/状态各一桶), # 不是行数组。直接 for r in dict 摊到的是**键名**(字符串),r.get 当场 AttributeError。 if isinstance(rows, dict): rows = [rows] if callable(key): return " | ".join(str(x) for r in rows for x in key(r)) return " | ".join(str(r.get(key, "")) for r in rows) def main() -> int: fails = [] with sync_playwright() as pw: b = pw.chromium.launch() pg = b.new_context(viewport={"width": 1440, "height": 1600}).new_page() pg.set_default_timeout(20000) pg.goto(BASE + "/login") pg.wait_for_selector("#login-user") pg.fill("#login-user", USER) pg.fill("#login-pass", PWD) pg.click("button[type=submit]") pg.wait_for_url(lambda u: "/login" not in u, timeout=20000) pg.goto(BASE + "/assets") pg.wait_for_timeout(1400) n = pg.evaluate(FIXTURE) pg.wait_for_timeout(300) print("fixture nodes:", n) checks = [ ("tagcheck", tagcheck.JS, "el", [("pb-tag", True), ("ant-input", False)]), # 整句散文当只读标签、捅出容器右缘必须响;换成 kit Tag(max-width+ellipsis 自己收窄)必须放行 ("tagcheck.SPILL", tagcheck.SPILL, "el", [("pb-spill", True), ("pg-spill", False)]), ("rhythmcheck.GAP", rhythmcheck.GAP, "el", [("pb-gap", True), ("pg-pin", False)]), ("rhythmcheck.RAG", rhythmcheck.RAG, "el", [("pb-rag", True), ("pg-center", False), ("pg-measure", False)]), ("gridcheck", gridcheck.JS, "el", [("pb-grid", True), ("pg-chipbar", False), # 流程条横滚必须响;容器自适应 grid 铺开的流程条必须放行 ("pb-rail", True), ("pg-rail", False), # 同行裸复选框贴着标签行(中心差 35px)必须响; # 让出标签块、坐进 32px 控件行的必须放行(glue ⑥ 的形态) ("pb-ctl", True), ("pg-ctl", False)]), # 按钮组被劈成 2+1 必须响;栅格那块(三种宽度三种控件的横排)与胶囊流不是它管的 ("btnrowcheck", btnrowcheck.JS, "el", [("pb-btn", True), ("pb-grid", False), ("pg-chipbar", False)]), # 唯一那条豁免必须放行;旧那条「父级是 header 的组在 <1024 允许分行」 # 第 17 轮删了,这里钉住它不许悄悄复活:header 里的横排组被劈成 2+1 一样要响 ("btnrowcheck.exempt", btnrowcheck.JS, "el", [("pg-stack", False), ("pb-header", True)]), # 卡头标题被切成两行(行里还剩着一整块没挪走)必须响; # 右端整块掉到下一行、标题拿到整行的必须放行——判据②的两面 ("btnrowcheck.HEAD", btnrowcheck.HEAD, "el", [("pb-head", True), ("pg-head", False)]), # 浮层底部(第 17 轮补):抽屉/对话框吸底那几条按钮以前不在任何闸门的路线表里, # 现在 Overlay.DRAWER_ACTIONS = ActionGroup,底部由 footercheck 开层量。 # 摊平用函数:只看判据算下来真违规的那几条的类名。 ("footercheck", footercheck.JS, (lambda r: [r["cls"]] if r.get("bad") else []), [("pb-footer", True), ("pg-footer", False)]), # 裸按钮簇(第 17 轮续):不带任何 kit 类名的一组按钮被劈成 2+1 必须响; # 整簇换行、每颗占满内宽必须放行——这把尺子的价值全在「不认类名」, # 没有这对 fixture,它绿了也证明不了自己在看东西。 ("btnclustercheck", btnclustercheck.JS, (lambda r: [r["cls"]] if r.get("bad") else []), [("pb-cluster", True), ("pg-cluster", False)]), # 格子里并排内容越出单元格 / 互相压叠必须响,放得下必须放行。 # 摊平用函数:只看 spill 明细里的元素标识,不看那些本来就没违规的表名。 ("tableaudit", tableaudit.PROBE, lambda r: [it["k"] for it in r.get("spill", [])], [("pb-tspill", True), ("pg-tspill", False)]), # 键盘可达(第 8.5 轮补):pointer 热区没 tabindex 必须响; # 补了 tabindex=0 的自定义控件与原生 button 必须放行—— # 前者钉住阶段 2 的修法不许退化,后者证明这条不是「见 div 就咬」。 # 摊平用函数:hotspots 只带 sig,别的判据返回的形状不一样。 ("semanticcheck.HOTSPOT", semanticcheck.COLLECT, (lambda r: [h["sig"] for h in r.get("hotspots", [])]), [("pb-sema", True), ("pb-semb", True), ("pg-sema", False), ("pg-semb", False), ("pg-semc", False), ("pg-semd", False), # antd 的图标根节点连候选都不该进:收进来就等于把 antd 的 DOM 当我们的契约 ("pg-simg", False)]), # 同一个判据的**硬档**单独验一遍:软/硬分档写错(role 非空就算硬)时, # 上面那条看不出差别——它只比候选清单,而 pg-semf 本来就该在候选里。 ("semanticcheck.HOTSPOT-hard", semanticcheck.COLLECT, (lambda r: [h["sig"] for h in r.get("hotspots", []) if h.get("hard")]), [("pb-sema", True), ("pb-semb", True), ("pg-sema", False), ("pg-semb", False), ("pg-semc", False), ("pg-semd", False), ("pg-semf", False)]), # TAB 的输入是「自定义角色元素清单」。两头都要钉: # 我们写的页签漏了 = TAB 永远查不到它(判据瞎); # antd 自己的页签混进来 = 每次走位都报它找不到(假阳性,实测每主题 3 条)。 ("semanticcheck.TABTARGET", semanticcheck.COLLECT, (lambda r: [t["sig"] for t in r.get("tabTargets", [])]), [("pb-semt", True), ("pg-semt", False)]), ] for label, js, key, expectations in checks: rows = pg.evaluate(js) hay = names(rows, key) for marker, should_fire in expectations: hit = marker in hay ok = hit == should_fire print(f"{'OK ' if ok else 'FAIL'} {label:<18} {marker:<12} " f"{'必须点名' if should_fire else '必须放行'} " f"→ {'点名了' if hit else '没点名'}") if not ok: fails.append(f"{label}/{marker}") print(" 实际:", hay[:400]) b.close() if fails: print("GATEPROBE_FAIL", " ".join(fails)) print("→ 闸门本身出问题:不是漏检(豁免写宽了)就是误报(豁免没生效),先修闸门") return 1 print(f"GATEPROBE_OK {len(checks)}/{len(checks)} 闸门坏了会响、好了不响") return 0 if __name__ == "__main__": sys.exit(main())