#!/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 管的那一族)、 只装了一颗 `aria-label=upload` 图标的裸按钮——它的辅助技术名称整个 就是英文字形码(S-2 管的那一族) ——十七条缺陷,每条判据必须**点名**到它; · `pg-*`(good):故意造出二十二种**合法**形态(卡底 mt-auto 钉底、整块居中的排版、 正文 max-w-[72ch] 栏宽、.nex-chipbar 胶囊流、 容器自适应的流程条、让位后与字段同行的复选框、 放得下的「进度条 + 百分数」单元格、 kit Tag 自己收窄成 ellipsis 的长标签、 右端整块掉到第二行之后标题拿到整行的卡头、 整组竖排等宽的按钮组(现行唯一那条豁免)、 整组竖排等宽的浮层底部(ActionGroup 翻竖排之后的形状)、 补了 `tabindex=0` 的自定义控件、原生 `button`、热区里那颗 pointer 图标、 有按钮的行连同它里面的图标、自绘的 `role=img`、antd v5 的图标根节点、 antd 自己的页签(阶段 2 的既定修法与 antd 内部结构,闸门必须放行)、 字形码图标但宿主自己写了 aria-label(名称被接管,必须仍然被采到)、 同一只图标改成 `aria-hidden=true`(登记表的修法)、图标被显式给了 中文名「清空搜索」(后两种必须连候选都不进,S-2)。 任何一条对不上就退出 1——说明闸门瞎了或者过敏,先修闸门再谈页面。 同一块夹具会被几条判据分别评,所以夹具种数(17 个 `pb-*` + 22 个 `pg-*`,按类名实数) 与判据条数(17)本来就对不上:末行 `GATEPROBE_OK 17/17` 数的是**判据**,别拿它去核对 fixture 个数。 最后一条判据(`classaudit.GATE2-*`)不在页面上:**静态闸门读的是源文件,页面上种不出反例**, 所以把真登记表抄进临时目录、改出三种绕过 `decorative()` 的写法喂给 classaudit—— 坏形状必须逐条点名、真登记表必须全程静音,锚点在登记表里找不到时直接停(不许退化成恒真)。 用法: .venv/bin/python scripts/ui/gateprobe.py """ import importlib.util import os import pathlib import subprocess import sys import tempfile 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") CLASSAUDIT = HERE / "classaudit.mjs" REGISTRY = HERE.parents[1] / "frontend" / "src" / "components" / "icons" / "index.ts" # 判据 ⑰ 的反例:登记表里**真实存在**的三行,逐行换成三种「绕过 decorative()」的写法。 # 锚点找不到就直接停——登记表改名时这条反向验证会先喊,而不是悄悄退化成恒真。 BAD_SHAPES = [ ("export const IconUpload = decorative(UploadOutlined, 'IconUpload')", "export { UploadOutlined } from '@ant-design/icons'\nexport const IconUpload = UploadOutlined"), ("export const IconChevronDown = decorative(DownOutlined, 'IconChevronDown')", "export const IconChevronDown = decorative(DownOutlined, 'IconArrowDown')"), ] 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 run_classaudit(src: pathlib.Path): """在临时源码目录上跑一遍 classaudit,只取图标闸的两类点名行。 其余八闸在只有两三个文件的空目录里必然报 BP 噪音,所以这里**不看退出码**, 只核对 `ICONA `(登记表出口形状)与 `ICON `(绕过登记表的外部 import)。 """ out = subprocess.run(["node", str(CLASSAUDIT), str(src)], capture_output=True, text=True, timeout=300) lines = (out.stdout or "").splitlines() return [ln for ln in lines if ln.startswith("ICONA ")] + [ln for ln in lines if ln.startswith("ICON ")] def gate2_static(): """把真登记表抄进临时目录,喂给 classaudit 跑「好形状 / 坏形状」各一遍。""" reg = REGISTRY.read_text(encoding="utf8") with tempfile.TemporaryDirectory(prefix="nex-gate2-") as td: root = pathlib.Path(td) bad_src = reg for old, new in BAD_SHAPES: if bad_src.count(old) != 1: raise SystemExit(f"GATEPROBE_FAIL classaudit.GATE2 —— 反向验证的锚点在登记表里找不到:{old}" " → 登记表那行改名/删除时,先同步这里的 fixture,别让这条判据变成空转") bad_src = bad_src.replace(old, new, 1) shapes = {} for tag, text, extra in (("good", reg, "import { IconUpload } from './components/icons'\n"), ("bad", bad_src, "import { StarOutlined } from '@ant-design/icons'\n")): d = root / tag (d / "components" / "icons").mkdir(parents=True) (d / "components" / "icons" / "index.ts").write_text(text, encoding="utf8") (d / "Probe.tsx").write_text(extra, encoding="utf8") shapes[tag] = " || ".join(run_classaudit(d)) return shapes 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)]), # S-2(2026-11-08 起常驻):**外泄清单**只收「宿主没有自己的可读名称」那一种。 # b/c/d 三种形状都必须不出现在这里——b 是名称已被宿主接管(AT 念的是人话), # c/d 连候选都不该进。放错任何一条,这条判据不是恒绿就是 78 只装饰图标全响。 ("semanticcheck.GLYPH", semanticcheck.COLLECT, (lambda r: [g["host"] + " " + g["tok"] for g in r.get("glyphs", []) if not g["own"]]), [("pb-glyph", True), ("pg-glyph", False), ("pg-glyph2", False), ("pg-glyph3", False)]), # 同一条判据的**采集面**:遮蔽那种(b)必须仍然被采到,否则上一条里 # 「pg-glyph 必须放行」是空转——没采到、和采到但判为遮蔽,串里看不出差别。 ("semanticcheck.GLYPH-seen", semanticcheck.COLLECT, (lambda r: [g["host"] for g in r.get("glyphs", [])]), [("pb-glyph", True), ("pg-glyph", True), ("pg-glyph2", False), ("pg-glyph3", False)]), ] def verdict(label, marker, should_fire, hay): hit = marker in hay ok = hit == should_fire print(f"{'OK ' if ok else 'FAIL'} {label:<22} {marker:<26} " f"{'必须点名' if should_fire else '必须放行'} " f"→ {'点名了' if hit else '没点名'}") if not ok: fails.append(f"{label}/{marker}") print(" 实际:", hay[:400]) for label, js, key, expectations in checks: rows = pg.evaluate(js) hay = names(rows, key) for marker, should_fire in expectations: verdict(label, marker, should_fire, hay) b.close() # ── 判据 ⑰(不吃页面、不触发 HMR):classaudit 第 2 闸的静态反向验证 # 这条闸读的是一份**源文件**,页面上种不出反例,只能喂临时目录: # 真登记表必须全程静音(否则它就是恒红),三种绕过 decorative() 的写法必须逐条点名 # (否则「upload 导入脚本」这类字形名外泄可以大摇大摆重新进来)。 shapes = gate2_static() verdict("classaudit.GATE2-bad", "图标走了 export {UploadOutlined}", True, shapes["bad"]) verdict("classaudit.GATE2-bad", "IconUpload 的出口不是", True, shapes["bad"]) verdict("classaudit.GATE2-bad", "IconChevronDown 的出口不是", True, shapes["bad"]) verdict("classaudit.GATE2-bad", "StarOutlined", True, shapes["bad"]) verdict("classaudit.GATE2-good", "ICON", False, shapes["good"]) if fails: print("GATEPROBE_FAIL", " ".join(fails)) print("→ 闸门本身出问题:不是漏检(豁免写宽了)就是误报(豁免没生效),先修闸门") return 1 print(f"GATEPROBE_OK {len(checks) + 1}/{len(checks) + 1} 闸门坏了会响、好了不响") return 0 if __name__ == "__main__": sys.exit(main())