#!/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 收在容器内
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 图标
我们的页签
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())