#!/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 收在容器内
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 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())