nex_animation/scripts/ui/visualcheck.py

620 lines
37 KiB
Python
Raw Normal View History

UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档 docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14): - §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部, Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记; §10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下; - §15 两道闸的判定口径写死,退出码都必须为 0。 scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> / 浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。 scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事—— :root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、 display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、 控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、 4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。 新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。 旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。 README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。 本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 / visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮) console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 04:42:28 +00:00
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""视觉体检:登录 → 逐路由 × 逐档宽度 × 明暗两色截图,同时校验尺子是否真的接上了 antd。
为什么需要它:改完 CSS 只跑 tsc 和 build 是不够的——变量名写错、token 没铺到
:root、选中态被 antd 默认样式盖掉,这些都是「编译通过但页面是坏的」。
所以除了截图,这里还会读一遍浏览器里的计算样式,把五件事钉死:
1) applyRootVars 有没有把 --ant-* 铺到 :root(app.css 全靠它);
2) 文字行高没塌成 px(无单位倍数被误写 px 时肉眼很容易漏);
3) 侧栏选中态跟着路由走(selectedKeys 没断);
4) 这一档宽度下没有元素横向捅出视口、没有被 overflow:hidden 切掉的字;
闸门跟着 antd 布局层重新校准:三处检查不再说假话 症状:布局层搬进 antd(Flex / Drawer actions / Tag)之后,四道闸里冒出一批 「查的是老口径」的误报,逼得人想给闸门加豁免——那是要把闸门关掉的前兆。 ① visualcheck 侧栏探针只认 .ant-menu-item-selected,可菜单折叠时高亮的是 父级 SubMenu 标题,antd 给它的是透明底 + colorPrimary(正确长相), 拿选中项的 controlItemBgActive 去比就必然红:430 档 projects/13/{delivery,dispatch,timeline} 三页连续报假故障。 ② 同一支脚本把「行高为 0」当塌陷,而 antd 的图标复位本来就把 .anticon 写成 line-height:0(盒子由 font-size 撑开),图标一旦带上 text-* 就中枪。 ③ classaudit 第 4 条用 \b(actions|footer)=\{ 找浮层底部动作条, PageHead actions(页头视图开关)和 Toolbar actions(勾选后的批量条) 名字撞车被一起吞进来,「最后一颗必须是主行动」判到了不该管的地方。 ④ Tailwind 词表没有 Flex 的 wrap / space-between 与 cursor 的 not-allowed, 这三个 props 值天天出现,逐行切词分不清引号内外,只能点名放行。 做法:①探针多输出一个 kind(item / submenu),Python 侧只在 kind=item 时比色板, submenu 交给原有的浮层复核分支;②行高断言排除 .anticon; ③先定位 prop 挂在哪个元素上,只有 Drawer / Modal(含 kit 转发的 AntDrawer / AntModal)才算底部动作条——实测全站 25 处里受管 12 处,另 12 处归 §7 控件栏; ④三个词进白名单,并在注释里写清「当类名写出来仍是笔误」; 顺带删掉临时探针 nexprobe.cjs / nexprobe.tsx(能力已并进 visualcheck), 新增 scripts/ui/helpshots.py:手册的 12 张插图是静态 PNG,不参与构建, UI 每换一次皮肤就整批过期,拍摄口径(视口/dpr/主题/主角项目/先收概况)写进脚本头。 为什么:闸门报一次假,人就多写一次豁免;豁免写满,真故障就混在里面没人看。 所以这一轮修的是检查本身的口径,而不是给页面加特例。
2026-11-03 09:02:03 +00:00
分段控件 / 页签 / 按钮 / 下拉当前值的文字必须整颗放得下(省略号也算截断);
桌面档(>=1024)里每颗 <ActionGroup> 必须待在同一行——同一概念的几颗按钮
被劈成两排就是没分组(`stack` 的竖排等宽除外)。
UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档 docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14): - §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部, Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记; §10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下; - §15 两道闸的判定口径写死,退出码都必须为 0。 scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> / 浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。 scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事—— :root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、 display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、 控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、 4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。 新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。 旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。 README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。 本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 / visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮) console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 04:42:28 +00:00
5) 请求没有 4xx/5xx——按 URL 分诊:素材文件在开发库里本来就没落盘是数据问题,
其余(接口 404、chunk 加载失败)一律算故障。
用法:
NEX_ROUTES="/,/assets" NEX_WIDTHS=1440,768 NEX_THEMES=dark,light \\
.venv/bin/python scripts/ui/visualcheck.py
产出:<NEX_SHOTS>/shots/*.png + 控制台报告。
"""
import os
import pathlib
import sys
from playwright.sync_api import sync_playwright
BASE = os.environ.get("NEX_BASE", "http://127.0.0.1:5173")
OUT = pathlib.Path(os.environ.get("NEX_SHOTS", "/tmp/nex_ui"))
SHOTS = OUT / "shots"
SHOTS.mkdir(parents=True, exist_ok=True)
WIDTHS = [int(x) for x in os.environ.get("NEX_WIDTHS", "1440").split(",")]
THEMES = os.environ.get("NEX_THEMES", "dark,light").split(",")
# 404 探针地址:路由表里不存在这一条,走的正是 `path: '*'` 那一支。
# 阶段 4 之前它是「静默跳回首页」,量不到任何新表面;现在它是一页真的兜底页,
# 有页头、有说明、有三个出口,所以进了默认名单(名单 14 → 15 条)。
NOT_FOUND_ROUTE = "/not-a-page"
UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档 docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14): - §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部, Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记; §10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下; - §15 两道闸的判定口径写死,退出码都必须为 0。 scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> / 浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。 scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事—— :root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、 display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、 控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、 4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。 新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。 旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。 README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。 本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 / visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮) console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 04:42:28 +00:00
ROUTES = [r for r in os.environ.get(
"NEX_ROUTES",
"/,/assets,/models,/projects/{id}/overview,/projects/{id}/library,"
"/projects/{id}/storyboard,/projects/{id}/dispatch,/projects/{id}/review,"
"/projects/{id}/timeline,/projects/{id}/delivery,"
"/account,/users,/help,/login," + NOT_FOUND_ROUTE).split(",") if r]
# 侧栏导航覆盖到的路由:这些必须有选中项,否则 selectedKeys 断了。
# 登录页不在导航里(chromeless),主循环也不跑它——见下面登录前的专用一趟。
# 404 也不算:地址压根不在菜单里,侧栏没有选中项才是对的。
NAV_ROUTES = [r for r in ROUTES
if not any(x in r for x in ("/account", "/users", "/help", "/login", NOT_FOUND_ROUTE))]
NEX 阶段 8·D17/N7:<768 导航改左抽屉,同一屏只剩一个导航入口,顶栏胶囊溢出归零 用户批准「移动端导航采用抽屉式 Drawer」。改前三条实测决定了必须怎么改: ① Sider 的 breakpoint="md" 把侧栏自动收成 64px 图标轨,而汉堡同时还在, label 写着「展开导航菜单」——点它只把图标轨撑回 224,随即又被 breakpoint 收回, 同一屏两个导航入口且行为自相矛盾(NEX 04 §8.2 明令消掉的状态); ② 那 64px 是真金白银的正文宽度:430 实测正文盒 366(可用 342)、576 实测 512; ③ D17 那 33–38px 溢出正是被它逼出来的:流水线台那颗 Button 内容居中, 装不下就两端一起往外溢——430 胶囊盒子 x=100 w=172、内容 sw 203, 项目名从 x=63 起画(比胶囊左沿还偏左 37px),箭头画到 x=305(胶囊右沿 272)。 实现: - kit Drawer 加 placement(默认 right,站内既有 10 处调用点一个都不传,行为逐字不变) 与 flushBody。flushBody 只能是 prop:.ant-drawer-body 的 padding 是 antd CSS-in-JS 的 未层声明,页面写 p-0 在 @layer utilities 里,层外压层内(同 §1.1.1 的 .nex-tag 实测)。 左右默认宽分档(左 min(288px,100vw−48px) / 右 DRAWER_WIDE):抽屉宽度取决于它是 「替换主内容的位置」还是「压在主内容上的一块面板」。 - AppSider 拆三导出:AppNavMenu(菜单本体)/ AppSider(≥768 常驻,撤 breakpoint)/ AppNavDrawer(<768 左抽屉,宽 = SIDER_WIDTH 224 + flushBody)。抽屉宽不取 antd 默认 378: 里面是同一份菜单,宽度一换折行、缩进、选中底色宽度全都换,等于凭空多出第二个导航形态。 - App 测一次 narrow(Grid.useBreakpoint().md === false,undefined 当桌面否则 1440 会闪一帧 「没侧栏只有汉堡」)往下传:侧栏在不在、汉堡点哪儿,两处必须同一个答案。navOpen 换页自动关。 - 同一颗汉堡换语义:≥768 折叠侧栏(原文案),<768 开合抽屉(打开/关闭导航菜单), aria-expanded 只在抽屉形态给(折叠侧栏是布局尺寸,不是被展开的面板);图标改按 「导航现在露没露」选,≥768 时 navShown === !collapsed 与改前逐字同值,<768 抽屉关着时 画的正是改前那颗 Expand → 顶栏像素没动。 - PipelineConsole 的项目名只在 <768 恢复收缩权(max-md:min-w-0 max-md:flex-[0_1_auto])。 第十三轮给的 flex-none 是为了「名字不许被散文吃掉」,那条在 ≥768 依然成立;手机档没有 散文可吃(cur <lg 隐、rail <xl 隐、status <md 隐),只剩「名字 vs 百分比+箭头」一道减法, 折出来的是省略号 + tooltip(§15.2 第 7 条:省略号可以,残字不行)。 探针:visualcheck 补 probe.sider;菜单断言先问侧栏在不在,<768 真点一下汉堡,量 .ant-drawer-content-wrapper(外层 .ant-drawer 是 inset:0 的遮罩容器,宽恒等视口,拿它比 224 会全线误报)并断言左贴边 / 宽 224 / 选中态底色等于桌面同一份 token / Esc 必须关。 顺手修掉一处从阶段 0 就存在的失配:menu_required 用 `path in NAV_ROUTES` 比的是**模板** (/projects/{id}/overview),主循环早已换成真实 id,七条项目路由从没进过菜单断言—— 新增 in_nav() 后覆盖 3 → 10 条路由。 未做(授权 §六):卡片没扩大、栅格没改、56/224/64 与控件三档一字未动、430 的表格仍横向 滚动而没有顺手改堆叠单栏。 验证:typecheck 通过 · build 通过(仅既有 chunk>1200kB 告警)· classaudit 九道全 0 exit 0 · visualcheck 120 状态(15 路由 × 4 视口 × 明暗)0 断言 / 0 HTTP / 0 console · 常驻 11 道探针 EXIT=0 ×11(GATEPROBE_OK 11/11)· 第 9 闸反证 BP_PROBE_OK 10/10 · navprobe 几何 FAIL 4/10 → PASS 0/10(430 溢出 33→0、正文 366→430)· drawercheck 行为账 after PASS 0 条,对 HEAD 反证 FAIL 10 条 · tableaudit 逐视口前后:1440 两态 0 违规、768 两态逐字相同、576 溢出量各 −64、430 违规 9→6 · ≥768 像素疑点定性为 Noto Sans SC 异步 swap 竞态 + 活动角标漂移:document.fonts.ready 后 before/after 顶栏强差 0(1440 与 768),1440 两态 DOM 几何逐字相同。 证据 reports/ui_evidence/nex-p8/d17/。 规范同步:UI规范 §6 外壳表补 AppNavMenu/AppNavDrawer 两行并写清撤 breakpoint 的理由、 §15 第 3 条改抽屉口径 + 登记 NAV_ROUTES 事故、§4 insp-sm 同步复核结论; NEX-对照与例外 §2.4 <768 DEFERRED → ADOPTED、§5 N7 → 已采纳、§6 D17 → 已修、§7 变更记录; nex.config.yaml shell 段加 sidebar_narrow: drawer 并校正四条尺寸的实现行号。
2026-11-07 15:36:48 +00:00
def in_nav(path: str, pid: str) -> bool:
"""这条已解析的路径在不在侧栏导航里(= 必须有选中项)。
原来写的是 `path in NAV_ROUTES`,而名单里存的是 `/projects/{id}/overview` 这种**模板**:
主循环早就把 {id} 换成真实项目 id 了,两边永远对不上,七条项目路由从阶段 0 起
就没进过菜单断言(只有 / 、/assets、/models 三条在测)。
阶段 8·N7 之后窄屏的导航整个搬进抽屉,量不到项目路由就等于没验——先把口径修对。
"""
return any(path == (r.replace("{id}", str(pid)) if "{id}" in r else r) for r in NAV_ROUTES)
UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档 docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14): - §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部, Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记; §10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下; - §15 两道闸的判定口径写死,退出码都必须为 0。 scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> / 浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。 scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事—— :root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、 display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、 控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、 4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。 新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。 旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。 README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。 本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 / visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮) console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 04:42:28 +00:00
USER = os.environ.get("NEX_USER", "admin")
规范补到十七条并把探针升到「六道 + 一道反向验证」:行高、栅格、纵向节奏、标签底色全部有闸 症状:这一轮改的每一类毛病里,有四类靠人眼复查根本守不住——表格行被内容撑高(实测最高 255px)、该用栅格的地方用自然排列(窄屏两种坏画面:一行右边缘参差不齐、折行点随内容 漂移)、纵向节奏断(底边不齐 / 收缩错位)、标签自带彩色底纹(§2.1 要求中性底);而卡头 `right` 长起来把标题压成竖排(430 档标题 291×145)也没有任何闸门会报。更麻烦的是 rhythmcheck 的判据原先读像素,豁免写宽一格就永远安静地返回 0——14 条命中里混着探针 自己的假警报,没人敢信它的红。 做法:①`docs/UI规范.md` 新增 R17 表格行高纪律(§13.2)与 R16 信息块三件套的落地口径 (§13.1),§9.3 补卡头折行那条(含「折行样式要挂在 `.ant-card-head-wrapper` 而不是 `.ant-card-head`」这个陷阱与 430/1440 的实测数据),§15 扩成 15.1–15.7 六道常驻探针 加一道反向验证,§16 提交清单插入第 9 步「动过布局跑三张像素闸、改过判据跑 gateprobe」; ②新增 `tableaudit.py`(逐表报容器宽/可视宽/行数/最高行/列宽,超行高点名)、 `gridcheck.py`、`rhythmcheck.py`(GAP + RAG,四条写法级豁免逐条写明为什么豁免)、 `tagcheck.py`(扫标签 tinted 底);③`gateprobe.py` 用「坏 fixture 必须被点名、合法形态 必须被放行」两组用例反向验证三张像素闸,共 4/4 全对,不碰源码不触发 HMR; ④`rhythmcheck.py` 的判据改成只读写法不读像素(`isPin` 认 mt-auto / inline margin-top / justify-content;RAG 侧放行子块自带 max-width、align-self 与整行居中的胶囊组), `classaudit.mjs` 把 `<Flex align="flex-start">` 的取值加进 PROSE 白名单(它天天作为 props 值出现,逐行切词分不清引号内外);⑤`visualcheck.py` 的项目子页改成量「镜头最多」 的项目并支持 NEX_PROJECT_ID 覆盖——列表第一个常是空项目,空态下溢出与截断两类断言等于 没测;⑥README 的规范条目数同步到十七条(只提这一行,其余内容归并行的后端改动)。 为什么:这类毛病全是「看起来挺整齐、量一下才知道差 200px」,只有把它们变成退出码才能 防止下一轮又漏回去;而像素闸一旦可能悄悄失灵,就必须配一道反向验证——先证明闸门坏了 会响,它的绿才有意义。
2026-11-03 12:21:39 +00:00
FORCED_PID = os.environ.get("NEX_PROJECT_ID", "")
UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档 docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14): - §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部, Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记; §10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下; - §15 两道闸的判定口径写死,退出码都必须为 0。 scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> / 浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。 scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事—— :root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、 display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、 控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、 4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。 新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。 旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。 README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。 本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 / visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮) console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 04:42:28 +00:00
PWD = os.environ.get("NEX_PASS", "admin1234")
规范补到十七条并把探针升到「六道 + 一道反向验证」:行高、栅格、纵向节奏、标签底色全部有闸 症状:这一轮改的每一类毛病里,有四类靠人眼复查根本守不住——表格行被内容撑高(实测最高 255px)、该用栅格的地方用自然排列(窄屏两种坏画面:一行右边缘参差不齐、折行点随内容 漂移)、纵向节奏断(底边不齐 / 收缩错位)、标签自带彩色底纹(§2.1 要求中性底);而卡头 `right` 长起来把标题压成竖排(430 档标题 291×145)也没有任何闸门会报。更麻烦的是 rhythmcheck 的判据原先读像素,豁免写宽一格就永远安静地返回 0——14 条命中里混着探针 自己的假警报,没人敢信它的红。 做法:①`docs/UI规范.md` 新增 R17 表格行高纪律(§13.2)与 R16 信息块三件套的落地口径 (§13.1),§9.3 补卡头折行那条(含「折行样式要挂在 `.ant-card-head-wrapper` 而不是 `.ant-card-head`」这个陷阱与 430/1440 的实测数据),§15 扩成 15.1–15.7 六道常驻探针 加一道反向验证,§16 提交清单插入第 9 步「动过布局跑三张像素闸、改过判据跑 gateprobe」; ②新增 `tableaudit.py`(逐表报容器宽/可视宽/行数/最高行/列宽,超行高点名)、 `gridcheck.py`、`rhythmcheck.py`(GAP + RAG,四条写法级豁免逐条写明为什么豁免)、 `tagcheck.py`(扫标签 tinted 底);③`gateprobe.py` 用「坏 fixture 必须被点名、合法形态 必须被放行」两组用例反向验证三张像素闸,共 4/4 全对,不碰源码不触发 HMR; ④`rhythmcheck.py` 的判据改成只读写法不读像素(`isPin` 认 mt-auto / inline margin-top / justify-content;RAG 侧放行子块自带 max-width、align-self 与整行居中的胶囊组), `classaudit.mjs` 把 `<Flex align="flex-start">` 的取值加进 PROSE 白名单(它天天作为 props 值出现,逐行切词分不清引号内外);⑤`visualcheck.py` 的项目子页改成量「镜头最多」 的项目并支持 NEX_PROJECT_ID 覆盖——列表第一个常是空项目,空态下溢出与截断两类断言等于 没测;⑥README 的规范条目数同步到十七条(只提这一行,其余内容归并行的后端改动)。 为什么:这类毛病全是「看起来挺整齐、量一下才知道差 200px」,只有把它们变成退出码才能 防止下一轮又漏回去;而像素闸一旦可能悄悄失灵,就必须配一道反向验证——先证明闸门坏了 会响,它的绿才有意义。
2026-11-03 12:21:39 +00:00
# 项目子页一律量「镜头最多」的那个项目:列表第一个往往是刚建的空项目,
# 空项目的分镜墙 / 调度清单 / 审核表全是空态,溢出与截断这两类断言等于没测。
# 需要指定项目时用 NEX_PROJECT_ID。
PROJECT_JS = r"""async () => {
const t = localStorage.getItem('nex-auth');
const tok = t ? (JSON.parse(t)?.state?.token || JSON.parse(t)?.token) : '';
const h = {headers: {Authorization: 'Bearer ' + tok}};
const j = await (await fetch('/api/projects', h)).json();
const list = j.projects || j.items || j.data || (Array.isArray(j) ? j : []);
let best = ''; let n = -1;
for (const p of list) {
const s = await (await fetch(`/api/projects/${p.id}/shots`, h)).json();
const c = s.count ?? (s.shots || []).length;
if (c > n) { n = c; best = p.id; }
}
return best || list[0]?.id || '';
}"""
UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档 docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14): - §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部, Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记; §10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下; - §15 两道闸的判定口径写死,退出码都必须为 0。 scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> / 浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。 scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事—— :root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、 display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、 控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、 4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。 新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。 旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。 README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。 本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 / visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮) console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 04:42:28 +00:00
# rc-resize-observer 在 React 18 下的已知告警,antd 内部依赖,与应用代码无关
IGNORE = ("findDOMNode is deprecated", "Support for React will be removed")
# ── 颜色闸(2026-11 撤掉自造的柠檬绿品牌之后常驻)────────────────────────────
# 1) 主色必须等于 antd 各自 algorithm 的出厂蓝。这个数非量不可:
# darkAlgorithm 会把喂进来的 seed 再走一遍色板生成器取第 5 档,
# 「把出厂值 #1668dc 填回 SEED.colorPrimary」量到的是 #165bbe(差一档),
# 截图上肉眼看不出来,只有读 --ant-color-primary 才发现覆盖回来了。
# 2) 侧栏选中态必须是 antd 自己那一组:浅色 = controlItemBgActive + colorPrimary
# (#e6f4ff / #1677ff,4.4:1,antd 官网同款);深色由 theme/antd.ts 补 antd
# dark 菜单的默认对(实心主色 + 白字,6.4:1)。深色要是删掉这两条,
# light 菜单的 #15325b 底 + #1668dc 字只有 2.2:1,选中项比未选中还淡。
# 3) 全站不许再出现旧品牌那一族(antd lime-1..10:#a0d911 / #5b8c00 是它的 6/8 档)。
ANTD_PRIMARY = {"light": "#1677ff", "dark": "#1668dc"}
NEX 阶段 8·D17/N7:<768 导航改左抽屉,同一屏只剩一个导航入口,顶栏胶囊溢出归零 用户批准「移动端导航采用抽屉式 Drawer」。改前三条实测决定了必须怎么改: ① Sider 的 breakpoint="md" 把侧栏自动收成 64px 图标轨,而汉堡同时还在, label 写着「展开导航菜单」——点它只把图标轨撑回 224,随即又被 breakpoint 收回, 同一屏两个导航入口且行为自相矛盾(NEX 04 §8.2 明令消掉的状态); ② 那 64px 是真金白银的正文宽度:430 实测正文盒 366(可用 342)、576 实测 512; ③ D17 那 33–38px 溢出正是被它逼出来的:流水线台那颗 Button 内容居中, 装不下就两端一起往外溢——430 胶囊盒子 x=100 w=172、内容 sw 203, 项目名从 x=63 起画(比胶囊左沿还偏左 37px),箭头画到 x=305(胶囊右沿 272)。 实现: - kit Drawer 加 placement(默认 right,站内既有 10 处调用点一个都不传,行为逐字不变) 与 flushBody。flushBody 只能是 prop:.ant-drawer-body 的 padding 是 antd CSS-in-JS 的 未层声明,页面写 p-0 在 @layer utilities 里,层外压层内(同 §1.1.1 的 .nex-tag 实测)。 左右默认宽分档(左 min(288px,100vw−48px) / 右 DRAWER_WIDE):抽屉宽度取决于它是 「替换主内容的位置」还是「压在主内容上的一块面板」。 - AppSider 拆三导出:AppNavMenu(菜单本体)/ AppSider(≥768 常驻,撤 breakpoint)/ AppNavDrawer(<768 左抽屉,宽 = SIDER_WIDTH 224 + flushBody)。抽屉宽不取 antd 默认 378: 里面是同一份菜单,宽度一换折行、缩进、选中底色宽度全都换,等于凭空多出第二个导航形态。 - App 测一次 narrow(Grid.useBreakpoint().md === false,undefined 当桌面否则 1440 会闪一帧 「没侧栏只有汉堡」)往下传:侧栏在不在、汉堡点哪儿,两处必须同一个答案。navOpen 换页自动关。 - 同一颗汉堡换语义:≥768 折叠侧栏(原文案),<768 开合抽屉(打开/关闭导航菜单), aria-expanded 只在抽屉形态给(折叠侧栏是布局尺寸,不是被展开的面板);图标改按 「导航现在露没露」选,≥768 时 navShown === !collapsed 与改前逐字同值,<768 抽屉关着时 画的正是改前那颗 Expand → 顶栏像素没动。 - PipelineConsole 的项目名只在 <768 恢复收缩权(max-md:min-w-0 max-md:flex-[0_1_auto])。 第十三轮给的 flex-none 是为了「名字不许被散文吃掉」,那条在 ≥768 依然成立;手机档没有 散文可吃(cur <lg 隐、rail <xl 隐、status <md 隐),只剩「名字 vs 百分比+箭头」一道减法, 折出来的是省略号 + tooltip(§15.2 第 7 条:省略号可以,残字不行)。 探针:visualcheck 补 probe.sider;菜单断言先问侧栏在不在,<768 真点一下汉堡,量 .ant-drawer-content-wrapper(外层 .ant-drawer 是 inset:0 的遮罩容器,宽恒等视口,拿它比 224 会全线误报)并断言左贴边 / 宽 224 / 选中态底色等于桌面同一份 token / Esc 必须关。 顺手修掉一处从阶段 0 就存在的失配:menu_required 用 `path in NAV_ROUTES` 比的是**模板** (/projects/{id}/overview),主循环早已换成真实 id,七条项目路由从没进过菜单断言—— 新增 in_nav() 后覆盖 3 → 10 条路由。 未做(授权 §六):卡片没扩大、栅格没改、56/224/64 与控件三档一字未动、430 的表格仍横向 滚动而没有顺手改堆叠单栏。 验证:typecheck 通过 · build 通过(仅既有 chunk>1200kB 告警)· classaudit 九道全 0 exit 0 · visualcheck 120 状态(15 路由 × 4 视口 × 明暗)0 断言 / 0 HTTP / 0 console · 常驻 11 道探针 EXIT=0 ×11(GATEPROBE_OK 11/11)· 第 9 闸反证 BP_PROBE_OK 10/10 · navprobe 几何 FAIL 4/10 → PASS 0/10(430 溢出 33→0、正文 366→430)· drawercheck 行为账 after PASS 0 条,对 HEAD 反证 FAIL 10 条 · tableaudit 逐视口前后:1440 两态 0 违规、768 两态逐字相同、576 溢出量各 −64、430 违规 9→6 · ≥768 像素疑点定性为 Noto Sans SC 异步 swap 竞态 + 活动角标漂移:document.fonts.ready 后 before/after 顶栏强差 0(1440 与 768),1440 两态 DOM 几何逐字相同。 证据 reports/ui_evidence/nex-p8/d17/。 规范同步:UI规范 §6 外壳表补 AppNavMenu/AppNavDrawer 两行并写清撤 breakpoint 的理由、 §15 第 3 条改抽屉口径 + 登记 NAV_ROUTES 事故、§4 insp-sm 同步复核结论; NEX-对照与例外 §2.4 <768 DEFERRED → ADOPTED、§5 N7 → 已采纳、§6 D17 → 已修、§7 变更记录; nex.config.yaml shell 段加 sidebar_narrow: drawer 并校正四条尺寸的实现行号。
2026-11-07 15:36:48 +00:00
# 导航抽屉的宽度:必须与常驻侧栏同一个数(AppSider.tsx 的 SIDER_WIDTH)。
# 抽屉里那份菜单和侧栏里那份是同一个组件,宽度换了就等于凭空多出一个导航形态。
NAV_DRAWER_WIDTH = 224
MENU_SELECTED = {
"light": ("rgb(230, 244, 255)", "rgb(22, 119, 255)"),
"dark": ("rgb(22, 104, 220)", "rgb(255, 255, 255)"),
}
# lime 族的色相窗口:实测 antd lime-1..10 落在 71°~83°,而 green 族(语义 success
# 用的那一族,含 darkAlgorithm 重映射出来的 #82c058 / #3b512c)落在 88°~102°。
# 取 62~88 当窗口:黄橙(warning 一族 45°~55°)和状态绿都进不来。
COLORSCAN = r"""() => {
const props = ['color', 'backgroundColor', 'borderTopColor', 'borderLeftColor', 'outlineColor', 'fill', 'stroke'];
const hit = {};
const parse = (s) => {
if (!s || s === 'transparent' || s === 'none') return null;
let m = s.match(/^rgba?\(([^)]]+)\)$/i);
if (m) { const p = m[1].split(/[,\s/]+/).filter(Boolean).map(Number);
return {r: p[0], g: p[1], b: p[2], a: p.length > 3 ? p[3] : 1}; }
m = s.match(/^#([0-9a-f]{6})$/i);
if (m) { const v = parseInt(m[1], 16); return {r: v >> 16 & 255, g: v >> 8 & 255, b: v & 255, a: 1}; }
return null;
};
for (const el of document.querySelectorAll('body *')) {
const cs = getComputedStyle(el);
if (cs.display === 'none') continue;
for (const p of props) {
const c = parse(cs[p]);
if (!c || c.a < 0.05) continue;
const mx = Math.max(c.r, c.g, c.b), mn = Math.min(c.r, c.g, c.b);
if (mx === mn) continue;
const h = mx === c.r ? 60 * (((c.g - c.b) / (mx - mn)) % 6)
: mx === c.g ? 60 * ((c.b - c.r) / (mx - mn) + 2)
: 60 * ((c.r - c.g) / (mx - mn) + 4);
const hue = h < 0 ? h + 360 : h;
if (!(hue >= 62 && hue <= 88 && (mx - mn) / mx > 0.12)) continue;
const key = '#' + [c.r, c.g, c.b].map((n) => n.toString(16).padStart(2, '0')).join('');
const rec = hit[key] || (hit[key] = {n: 0, e: ''});
rec.n++;
if (!rec.e) rec.e = el.tagName.toLowerCase() + '.' +
((typeof el.className === 'string' ? el.className : '').trim().slice(0, 48) || '-') + ' {' + p + '}';
}
}
return hit;
}"""
UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档 docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14): - §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部, Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记; §10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下; - §15 两道闸的判定口径写死,退出码都必须为 0。 scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> / 浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。 scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事—— :root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、 display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、 控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、 4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。 新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。 旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。 README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。 本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 / visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮) console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 04:42:28 +00:00
PROBE = """() => {
const cs = getComputedStyle(document.documentElement);
const v = (n) => (cs.getPropertyValue(n) || '').trim();
// 窄屏侧栏是折叠的(Sider breakpoint=md),二级项不在 DOM 里而在 hover 浮层里,
// 此时 antd 把选中态打在父级 .ant-menu-submenu-selected 上 —— 这不是选中态断了。
// collapsed 一并报出去,让 Python 那边决定要不要再展开浮层复核。
闸门跟着 antd 布局层重新校准:三处检查不再说假话 症状:布局层搬进 antd(Flex / Drawer actions / Tag)之后,四道闸里冒出一批 「查的是老口径」的误报,逼得人想给闸门加豁免——那是要把闸门关掉的前兆。 ① visualcheck 侧栏探针只认 .ant-menu-item-selected,可菜单折叠时高亮的是 父级 SubMenu 标题,antd 给它的是透明底 + colorPrimary(正确长相), 拿选中项的 controlItemBgActive 去比就必然红:430 档 projects/13/{delivery,dispatch,timeline} 三页连续报假故障。 ② 同一支脚本把「行高为 0」当塌陷,而 antd 的图标复位本来就把 .anticon 写成 line-height:0(盒子由 font-size 撑开),图标一旦带上 text-* 就中枪。 ③ classaudit 第 4 条用 \b(actions|footer)=\{ 找浮层底部动作条, PageHead actions(页头视图开关)和 Toolbar actions(勾选后的批量条) 名字撞车被一起吞进来,「最后一颗必须是主行动」判到了不该管的地方。 ④ Tailwind 词表没有 Flex 的 wrap / space-between 与 cursor 的 not-allowed, 这三个 props 值天天出现,逐行切词分不清引号内外,只能点名放行。 做法:①探针多输出一个 kind(item / submenu),Python 侧只在 kind=item 时比色板, submenu 交给原有的浮层复核分支;②行高断言排除 .anticon; ③先定位 prop 挂在哪个元素上,只有 Drawer / Modal(含 kit 转发的 AntDrawer / AntModal)才算底部动作条——实测全站 25 处里受管 12 处,另 12 处归 §7 控件栏; ④三个词进白名单,并在注释里写清「当类名写出来仍是笔误」; 顺带删掉临时探针 nexprobe.cjs / nexprobe.tsx(能力已并进 visualcheck), 新增 scripts/ui/helpshots.py:手册的 12 张插图是静态 PNG,不参与构建, UI 每换一次皮肤就整批过期,拍摄口径(视口/dpr/主题/主角项目/先收概况)写进脚本头。 为什么:闸门报一次假,人就多写一次豁免;豁免写满,真故障就混在里面没人看。 所以这一轮修的是检查本身的口径,而不是给页面加特例。
2026-11-03 09:02:03 +00:00
const item = document.querySelector('.ant-menu-item-selected');
const sel = item
UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档 docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14): - §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部, Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记; §10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下; - §15 两道闸的判定口径写死,退出码都必须为 0。 scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> / 浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。 scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事—— :root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、 display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、 控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、 4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。 新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。 旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。 README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。 本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 / visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮) console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 04:42:28 +00:00
|| document.querySelector('.ant-menu-submenu-selected > .ant-menu-submenu-title');
const sc = sel ? getComputedStyle(sel) : null;
const bar = document.querySelector('.ant-layout-header') || document.querySelector('[class*=nex-header]');
return {
root: {
primary: v('--ant-color-primary'),
bg: v('--ant-color-bg-layout'),
bar: v('--nex-bar'),
marginXs: v('--ant-margin-xs'),
fontWeightStrong: v('--ant-font-weight-strong'),
fontSize: v('--ant-font-size'),
controlHeight: v('--ant-control-height'),
borderRadius: v('--ant-border-radius'),
},
闸门跟着 antd 布局层重新校准:三处检查不再说假话 症状:布局层搬进 antd(Flex / Drawer actions / Tag)之后,四道闸里冒出一批 「查的是老口径」的误报,逼得人想给闸门加豁免——那是要把闸门关掉的前兆。 ① visualcheck 侧栏探针只认 .ant-menu-item-selected,可菜单折叠时高亮的是 父级 SubMenu 标题,antd 给它的是透明底 + colorPrimary(正确长相), 拿选中项的 controlItemBgActive 去比就必然红:430 档 projects/13/{delivery,dispatch,timeline} 三页连续报假故障。 ② 同一支脚本把「行高为 0」当塌陷,而 antd 的图标复位本来就把 .anticon 写成 line-height:0(盒子由 font-size 撑开),图标一旦带上 text-* 就中枪。 ③ classaudit 第 4 条用 \b(actions|footer)=\{ 找浮层底部动作条, PageHead actions(页头视图开关)和 Toolbar actions(勾选后的批量条) 名字撞车被一起吞进来,「最后一颗必须是主行动」判到了不该管的地方。 ④ Tailwind 词表没有 Flex 的 wrap / space-between 与 cursor 的 not-allowed, 这三个 props 值天天出现,逐行切词分不清引号内外,只能点名放行。 做法:①探针多输出一个 kind(item / submenu),Python 侧只在 kind=item 时比色板, submenu 交给原有的浮层复核分支;②行高断言排除 .anticon; ③先定位 prop 挂在哪个元素上,只有 Drawer / Modal(含 kit 转发的 AntDrawer / AntModal)才算底部动作条——实测全站 25 处里受管 12 处,另 12 处归 §7 控件栏; ④三个词进白名单,并在注释里写清「当类名写出来仍是笔误」; 顺带删掉临时探针 nexprobe.cjs / nexprobe.tsx(能力已并进 visualcheck), 新增 scripts/ui/helpshots.py:手册的 12 张插图是静态 PNG,不参与构建, UI 每换一次皮肤就整批过期,拍摄口径(视口/dpr/主题/主角项目/先收概况)写进脚本头。 为什么:闸门报一次假,人就多写一次豁免;豁免写满,真故障就混在里面没人看。 所以这一轮修的是检查本身的口径,而不是给页面加特例。
2026-11-03 09:02:03 +00:00
// kind=item 才是真正被选中的菜单项,能吃 antd 的 controlItemBgActive;
// kind=submenu 只是折叠态下高亮的父级标题,antd 给它的是透明底 + colorPrimary 文字,
// 这是折叠态的正确长相,拿选中项的色板去比必然误报。
menu: sel ? {bg: sc.backgroundColor, color: sc.color, text: sel.textContent.trim().slice(0, 12),
kind: item ? 'item' : 'submenu'} : null,
UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档 docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14): - §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部, Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记; §10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下; - §15 两道闸的判定口径写死,退出码都必须为 0。 scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> / 浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。 scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事—— :root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、 display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、 控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、 4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。 新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。 旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。 README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。 本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 / visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮) console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 04:42:28 +00:00
header: bar ? {h: Math.round(bar.getBoundingClientRect().height),
bg: getComputedStyle(bar).backgroundColor} : null,
theme: document.documentElement.dataset.theme,
NEX 阶段 8·D17/N7:<768 导航改左抽屉,同一屏只剩一个导航入口,顶栏胶囊溢出归零 用户批准「移动端导航采用抽屉式 Drawer」。改前三条实测决定了必须怎么改: ① Sider 的 breakpoint="md" 把侧栏自动收成 64px 图标轨,而汉堡同时还在, label 写着「展开导航菜单」——点它只把图标轨撑回 224,随即又被 breakpoint 收回, 同一屏两个导航入口且行为自相矛盾(NEX 04 §8.2 明令消掉的状态); ② 那 64px 是真金白银的正文宽度:430 实测正文盒 366(可用 342)、576 实测 512; ③ D17 那 33–38px 溢出正是被它逼出来的:流水线台那颗 Button 内容居中, 装不下就两端一起往外溢——430 胶囊盒子 x=100 w=172、内容 sw 203, 项目名从 x=63 起画(比胶囊左沿还偏左 37px),箭头画到 x=305(胶囊右沿 272)。 实现: - kit Drawer 加 placement(默认 right,站内既有 10 处调用点一个都不传,行为逐字不变) 与 flushBody。flushBody 只能是 prop:.ant-drawer-body 的 padding 是 antd CSS-in-JS 的 未层声明,页面写 p-0 在 @layer utilities 里,层外压层内(同 §1.1.1 的 .nex-tag 实测)。 左右默认宽分档(左 min(288px,100vw−48px) / 右 DRAWER_WIDE):抽屉宽度取决于它是 「替换主内容的位置」还是「压在主内容上的一块面板」。 - AppSider 拆三导出:AppNavMenu(菜单本体)/ AppSider(≥768 常驻,撤 breakpoint)/ AppNavDrawer(<768 左抽屉,宽 = SIDER_WIDTH 224 + flushBody)。抽屉宽不取 antd 默认 378: 里面是同一份菜单,宽度一换折行、缩进、选中底色宽度全都换,等于凭空多出第二个导航形态。 - App 测一次 narrow(Grid.useBreakpoint().md === false,undefined 当桌面否则 1440 会闪一帧 「没侧栏只有汉堡」)往下传:侧栏在不在、汉堡点哪儿,两处必须同一个答案。navOpen 换页自动关。 - 同一颗汉堡换语义:≥768 折叠侧栏(原文案),<768 开合抽屉(打开/关闭导航菜单), aria-expanded 只在抽屉形态给(折叠侧栏是布局尺寸,不是被展开的面板);图标改按 「导航现在露没露」选,≥768 时 navShown === !collapsed 与改前逐字同值,<768 抽屉关着时 画的正是改前那颗 Expand → 顶栏像素没动。 - PipelineConsole 的项目名只在 <768 恢复收缩权(max-md:min-w-0 max-md:flex-[0_1_auto])。 第十三轮给的 flex-none 是为了「名字不许被散文吃掉」,那条在 ≥768 依然成立;手机档没有 散文可吃(cur <lg 隐、rail <xl 隐、status <md 隐),只剩「名字 vs 百分比+箭头」一道减法, 折出来的是省略号 + tooltip(§15.2 第 7 条:省略号可以,残字不行)。 探针:visualcheck 补 probe.sider;菜单断言先问侧栏在不在,<768 真点一下汉堡,量 .ant-drawer-content-wrapper(外层 .ant-drawer 是 inset:0 的遮罩容器,宽恒等视口,拿它比 224 会全线误报)并断言左贴边 / 宽 224 / 选中态底色等于桌面同一份 token / Esc 必须关。 顺手修掉一处从阶段 0 就存在的失配:menu_required 用 `path in NAV_ROUTES` 比的是**模板** (/projects/{id}/overview),主循环早已换成真实 id,七条项目路由从没进过菜单断言—— 新增 in_nav() 后覆盖 3 → 10 条路由。 未做(授权 §六):卡片没扩大、栅格没改、56/224/64 与控件三档一字未动、430 的表格仍横向 滚动而没有顺手改堆叠单栏。 验证:typecheck 通过 · build 通过(仅既有 chunk>1200kB 告警)· classaudit 九道全 0 exit 0 · visualcheck 120 状态(15 路由 × 4 视口 × 明暗)0 断言 / 0 HTTP / 0 console · 常驻 11 道探针 EXIT=0 ×11(GATEPROBE_OK 11/11)· 第 9 闸反证 BP_PROBE_OK 10/10 · navprobe 几何 FAIL 4/10 → PASS 0/10(430 溢出 33→0、正文 366→430)· drawercheck 行为账 after PASS 0 条,对 HEAD 反证 FAIL 10 条 · tableaudit 逐视口前后:1440 两态 0 违规、768 两态逐字相同、576 溢出量各 −64、430 违规 9→6 · ≥768 像素疑点定性为 Noto Sans SC 异步 swap 竞态 + 活动角标漂移:document.fonts.ready 后 before/after 顶栏强差 0(1440 与 768),1440 两态 DOM 几何逐字相同。 证据 reports/ui_evidence/nex-p8/d17/。 规范同步:UI规范 §6 外壳表补 AppNavMenu/AppNavDrawer 两行并写清撤 breakpoint 的理由、 §15 第 3 条改抽屉口径 + 登记 NAV_ROUTES 事故、§4 insp-sm 同步复核结论; NEX-对照与例外 §2.4 <768 DEFERRED → ADOPTED、§5 N7 → 已采纳、§6 D17 → 已修、§7 变更记录; nex.config.yaml shell 段加 sidebar_narrow: drawer 并校正四条尺寸的实现行号。
2026-11-07 15:36:48 +00:00
// 常驻侧栏在不在。阶段 8·N7 之后 <768 这一档**不渲染** Sider(导航改左抽屉),
// 菜单断言必须先问这一句,否则 576/430 两档会全线假失败「菜单没有选中项」。
sider: !!document.querySelector('.ant-layout-sider'),
UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档 docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14): - §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部, Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记; §10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下; - §15 两道闸的判定口径写死,退出码都必须为 0。 scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> / 浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。 scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事—— :root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、 display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、 控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、 4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。 新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。 旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。 README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。 本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 / visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮) console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 04:42:28 +00:00
collapsed: !!document.querySelector('.ant-layout-sider-collapsed'),
subSelected: !!document.querySelector('.ant-menu-submenu-selected'),
// 行高是无单位倍数:一旦 --ant-line-height-* 被写成 px,每一行文字都会塌成 1px 高
闸门跟着 antd 布局层重新校准:三处检查不再说假话 症状:布局层搬进 antd(Flex / Drawer actions / Tag)之后,四道闸里冒出一批 「查的是老口径」的误报,逼得人想给闸门加豁免——那是要把闸门关掉的前兆。 ① visualcheck 侧栏探针只认 .ant-menu-item-selected,可菜单折叠时高亮的是 父级 SubMenu 标题,antd 给它的是透明底 + colorPrimary(正确长相), 拿选中项的 controlItemBgActive 去比就必然红:430 档 projects/13/{delivery,dispatch,timeline} 三页连续报假故障。 ② 同一支脚本把「行高为 0」当塌陷,而 antd 的图标复位本来就把 .anticon 写成 line-height:0(盒子由 font-size 撑开),图标一旦带上 text-* 就中枪。 ③ classaudit 第 4 条用 \b(actions|footer)=\{ 找浮层底部动作条, PageHead actions(页头视图开关)和 Toolbar actions(勾选后的批量条) 名字撞车被一起吞进来,「最后一颗必须是主行动」判到了不该管的地方。 ④ Tailwind 词表没有 Flex 的 wrap / space-between 与 cursor 的 not-allowed, 这三个 props 值天天出现,逐行切词分不清引号内外,只能点名放行。 做法:①探针多输出一个 kind(item / submenu),Python 侧只在 kind=item 时比色板, submenu 交给原有的浮层复核分支;②行高断言排除 .anticon; ③先定位 prop 挂在哪个元素上,只有 Drawer / Modal(含 kit 转发的 AntDrawer / AntModal)才算底部动作条——实测全站 25 处里受管 12 处,另 12 处归 §7 控件栏; ④三个词进白名单,并在注释里写清「当类名写出来仍是笔误」; 顺带删掉临时探针 nexprobe.cjs / nexprobe.tsx(能力已并进 visualcheck), 新增 scripts/ui/helpshots.py:手册的 12 张插图是静态 PNG,不参与构建, UI 每换一次皮肤就整批过期,拍摄口径(视口/dpr/主题/主角项目/先收概况)写进脚本头。 为什么:闸门报一次假,人就多写一次豁免;豁免写满,真故障就混在里面没人看。 所以这一轮修的是检查本身的口径,而不是给页面加特例。
2026-11-03 09:02:03 +00:00
// .anticon 除外:antd 的图标复位把所有图标写成 line-height:0(实测菜单/头部/正文图标全是 0px),
// 图标的盒子由 font-size 撑开(12px 字图标实高 12px,没塌),这条断言管的是「文字行」。
// 图标一旦同时带 Tailwind 的 text-*,按 class 选元素就会把它误报成「行高塌了」。
UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档 docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14): - §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部, Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记; §10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下; - §15 两道闸的判定口径写死,退出码都必须为 0。 scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> / 浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。 scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事—— :root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、 display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、 控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、 4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。 新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。 旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。 README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。 本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 / visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮) console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 04:42:28 +00:00
text: [...document.querySelectorAll('.text-xs, .text-sm, .text-base')].slice(0, 12)
闸门跟着 antd 布局层重新校准:三处检查不再说假话 症状:布局层搬进 antd(Flex / Drawer actions / Tag)之后,四道闸里冒出一批 「查的是老口径」的误报,逼得人想给闸门加豁免——那是要把闸门关掉的前兆。 ① visualcheck 侧栏探针只认 .ant-menu-item-selected,可菜单折叠时高亮的是 父级 SubMenu 标题,antd 给它的是透明底 + colorPrimary(正确长相), 拿选中项的 controlItemBgActive 去比就必然红:430 档 projects/13/{delivery,dispatch,timeline} 三页连续报假故障。 ② 同一支脚本把「行高为 0」当塌陷,而 antd 的图标复位本来就把 .anticon 写成 line-height:0(盒子由 font-size 撑开),图标一旦带上 text-* 就中枪。 ③ classaudit 第 4 条用 \b(actions|footer)=\{ 找浮层底部动作条, PageHead actions(页头视图开关)和 Toolbar actions(勾选后的批量条) 名字撞车被一起吞进来,「最后一颗必须是主行动」判到了不该管的地方。 ④ Tailwind 词表没有 Flex 的 wrap / space-between 与 cursor 的 not-allowed, 这三个 props 值天天出现,逐行切词分不清引号内外,只能点名放行。 做法:①探针多输出一个 kind(item / submenu),Python 侧只在 kind=item 时比色板, submenu 交给原有的浮层复核分支;②行高断言排除 .anticon; ③先定位 prop 挂在哪个元素上,只有 Drawer / Modal(含 kit 转发的 AntDrawer / AntModal)才算底部动作条——实测全站 25 处里受管 12 处,另 12 处归 §7 控件栏; ④三个词进白名单,并在注释里写清「当类名写出来仍是笔误」; 顺带删掉临时探针 nexprobe.cjs / nexprobe.tsx(能力已并进 visualcheck), 新增 scripts/ui/helpshots.py:手册的 12 张插图是静态 PNG,不参与构建, UI 每换一次皮肤就整批过期,拍摄口径(视口/dpr/主题/主角项目/先收概况)写进脚本头。 为什么:闸门报一次假,人就多写一次豁免;豁免写满,真故障就混在里面没人看。 所以这一轮修的是检查本身的口径,而不是给页面加特例。
2026-11-03 09:02:03 +00:00
.filter((el) => !el.classList.contains('anticon'))
UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档 docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14): - §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部, Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记; §10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下; - §15 两道闸的判定口径写死,退出码都必须为 0。 scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> / 浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。 scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事—— :root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、 display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、 控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、 4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。 新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。 旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。 README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。 本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 / visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮) console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 04:42:28 +00:00
.map((el) => { const c = getComputedStyle(el);
const fs = parseFloat(c.fontSize), lh = parseFloat(c.lineHeight);
return Number.isFinite(lh) && lh < fs ? `${el.className.slice(0, 40)} fs=${fs} lh=${lh}` : null; })
.filter(Boolean),
};
}"""
# 布局体检:找出「捅出视口」和「被 hidden 切掉」的东西。
# 只写 JS,不用正则,避免 Python 字符串转义把 evaluate 打挂。
LAYOUT = r"""() => {
const vw = document.documentElement.clientWidth;
const desc = (el) => {
const r = el.getBoundingClientRect();
let cls = (typeof el.className === 'string' ? el.className : '').trim().replace(/\\s+/g, ' ');
cls = cls.length > 46 ? cls.slice(0, 46) + '..' : cls;
return el.tagName.toLowerCase() + (el.id ? '#' + el.id : '') + (cls ? '.' + cls.split(' ').join('.') : '')
+ ' [' + Math.round(r.width) + 'x' + Math.round(r.height) + ' @' + Math.round(r.left) + ',' + Math.round(r.top) + ']';
};
// 「捅出视口」只有在溢出真的漏到页面上时才是 bug。祖先里只要有一个横向
// 滚动/裁切盒把它接住了,就不是溢出:auto|scroll 是能滚,hidden|clip 且
// scrollWidth > clientWidth 是「正在被程序滚动的裁切盒」——antd 的页签条
// (.ant-tabs-nav-wrap) 就是这一类,rc-tabs 用 transform 滚它,overflowX 却是 hidden。
// 被裁掉的**文字**另有 clip 那条检查兜着,不会漏。
const contained = (el) => {
for (let p = el.parentElement; p && p !== document.documentElement; p = p.parentElement) {
const c = getComputedStyle(p);
if (c.overflowX === 'auto' || c.overflowX === 'scroll') return true;
if ((c.overflowX === 'hidden' || c.overflowX === 'clip')
&& p.scrollWidth > p.clientWidth + 2) return true;
}
return false;
};
// 断点 utility 与 antd 组件样式的层叠陷阱:Tailwind 的 utility 在 @layer utilities,
// antd 若没进层就会盖掉 display —— <Flex className="max-md:hidden"> 算出来还是 flex。
const DISP = { hidden: 'none', block: 'block', flex: 'flex', 'inline-flex': 'inline-flex',
grid: 'grid', 'inline-block': 'inline-block', inline: 'inline' };
NEX 阶段 7 断点归一:五把实测尺子登记成命名断点,页面里裸 max-[...] 归零 改的是尺子的名字,不是尺子的刻度。审计字面方案(620→576、720→768、 1080/1240/1400→992/1200)逐条实测后全部不采纳,走审计自己留的出口条款 R9:登记为项目断点。 - styles/index.css:--breakpoint-* 主阶梯后面补 5 条登记档位 insp-lg=1400 / board=1240 / insp-md=1080 / insp-sm=720 / agent=620, 每条注明唯一使用者;口径写进注释(一把尺子一个使用者、名字即表面、 加档要带视口测量、删档要连带删掉唯一使用者) - Storyboard.tsx / AgentConsole.tsx:15 处 max-[Npx] 换成 max-<name>:, 并把「为什么不能并到邻居档位」的实测读数写进就地注释 (agent 并到 576:指令列 415→150、行高 71→90;board 并到 xl: 1204–1239 由 4 列 224 退回 3 列 301;insp-sm 并到 md:721–767 整屏盖住图标轨) - scripts/ui/visualcheck.py:wantDisplay 的断点表同步这 5 个名字。 归一之前凡含 [ 的类名被直接跳过,这轮起 max-board:flex / max-agent:order-5 才真的按档位算期望 display 与顺序 - docs/UI规范.md §4:断点登记表落地(档位 ↔ px ↔ 使用者 ↔ 采用理由) - docs/NEX-对照与例外.md:新增缺口 N16 —— NEX 没有「主阶梯放不下时 的命名登记出口」这一条 验证(最终代码态,全部 EXIT 0):typecheck / build 430ms / classaudit 0 死类名 4088 候选 / 11 道常驻探针 + GATEPROBE_OK 11/11 / visualcheck 120 状态(15 路由 × 4 宽度 × 明暗,新增 576 档)+ 36 张边界档 断言 0 console 0 HTTP 0 / grep -rn "max-\[" frontend/src = 0 / sbprobe 16 档与 agentprobe 10 档改前改后 JSON sha256 相同 / dist CSS 五个断点块声明体逐字节相同 / 9 对前后帧 Header 以下 0 显著差异像素、 总控台两对 PNG 逐字节相同 / 阶段 1 tagw、阶段 2 kbd(1440 与 576)、 阶段 3 zorder5 跨阶段复跑全绿 报告 reports/NEX阶段4-7实施-2026-11-07.md(§4 与 §7 为本轮)
2026-11-07 10:53:43 +00:00
// 断点表要和 styles/index.css 的 --breakpoint-* 同步(含 UI规范.md §4 登记的 5 把项目尺子):
// 少了名字,wantDisplay 会对 `max-board:flex` 这类词直接返回 null,断言静默失效。
const BPORDER = ['2xl', 'insp-lg', 'board', 'xl', 'insp-md', 'lg', 'md', 'insp-sm', 'agent', 'sm'];
const BP = { sm: 576, agent: 620, 'insp-sm': 720, md: 768, lg: 992,
'insp-md': 1080, xl: 1200, board: 1240, 'insp-lg': 1400, '2xl': 1600 };
UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档 docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14): - §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部, Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记; §10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下; - §15 两道闸的判定口径写死,退出码都必须为 0。 scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> / 浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。 scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事—— :root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、 display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、 控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、 4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。 新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。 旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。 README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。 本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 / visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮) console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 04:42:28 +00:00
const dispBad = [];
// flex / grid 容器的子项会被 CSS Display 规范「块级化」:inline-flex→flex、
// inline-block|inline→block。这是规范行为,不是 utility 被组件样式盖掉。
const BLOCKIFY = { 'inline-flex': 'flex', 'inline-block': 'block', inline: 'block' };
const flowParentDisplay = (el) => {
for (let p = el.parentElement; p; p = p.parentElement) {
const d = getComputedStyle(p).display;
if (d === 'contents') continue; // display:contents 不生成盒子,容器往上找
return d;
}
return '';
};
// 返回 {want, score}:一个元素上可能同时挂 flex 与 max-xl:grid + max-lg:flex,
// 命中哪个由 Tailwind 生成顺序决定(实测 dist 产物):同一条 utility,无变体在最前,
// 然后 max-* 按断点从大到小排(2xl→sm),最后 min-* 按断点从小到大排(sm→2xl)。
// 后写的赢 ⇒ max-* 里「断点最小的」赢,min-* 里「断点最大的」赢。取 score 最大的候选。
// BPORDER 是大→小,所以 max-* 用 +idx、min-* 用 (len-1-idx) 换算。
// max-* 与 min-* 同时命中、或带 hover/dark 之类判不准的变体 → 返回 null 跳过,宁漏不误。
const wantDisplay = (tok) => {
const parts = tok.split(':');
const base = parts[parts.length - 1];
if (!DISP[base] || tok.indexOf('[') >= 0 || tok.indexOf('/') >= 0) return null;
let maxSeen = false, minSeen = false, maxIdx = 0, minIdx = 0;
for (const v of parts.slice(0, -1)) {
if (v.startsWith('max-')) {
const key = v.slice(4);
if (BP[key] === undefined || vw >= BP[key]) return null;
const idx = BPORDER.indexOf(key);
maxIdx = maxSeen ? Math.max(maxIdx, idx) : idx; // 断点最小的 max-* 写在最后,赢
maxSeen = true;
} else if (BP[v] !== undefined) {
if (vw < BP[v]) return null;
const idx = BPORDER.indexOf(v);
minIdx = minSeen ? Math.min(minIdx, idx) : idx; // 断点最大的 min-* 写在最后,赢
minSeen = true;
} else return null; // hover / focus / dark / light 之类的变体这里判不准,跳过
}
if (maxSeen && minSeen) return null;
const score = maxSeen ? 100 + maxIdx : minSeen ? 200 + (BPORDER.length - 1 - minIdx) : 0;
return { want: DISP[base], score };
};
const out = [], clip = [];
const all = document.querySelectorAll('body *');
for (const el of all) {
const c = getComputedStyle(el);
if (c.display === 'none' || c.visibility === 'hidden' || c.opacity === '0') continue;
const r = el.getBoundingClientRect();
const cands = ((typeof el.className === 'string' ? el.className : '').trim().split(/\s+/)
.map(wantDisplay).filter((x) => x !== null));
// 多个候选取优先级最高的那一个(而不是写在最前面的那一个)
let want = null;
for (const x of cands) if (want === null || x.score > want.score) want = x;
if (want) {
const pd = flowParentDisplay(el);
if (pd === 'flex' || pd === 'inline-flex' || pd === 'grid' || pd === 'inline-grid') {
want.want = BLOCKIFY[want.want] || want.want;
}
want = want.want;
}
if (want && el.parentElement && c.display !== want) {
// display:none 的祖先里量不到,期望 flex 却读到 none 也算通过(父级自己会报)
if (!(want === 'none')) dispBad.push(desc(el) + ' want display=' + want + ' got=' + c.display);
else if (r.width > 2) dispBad.push(desc(el) + ' want display=none got=' + c.display);
}
if (r.width < 2 || r.height < 2) continue;
if (r.right > vw + 2 && !contained(el)) {
// 只要最外层那一个:父级已经报过就跳过子级
let dup = false;
for (let p = el.parentElement; p; p = p.parentElement) {
if (p.__flag) { dup = true; break; }
}
if (!dup) { el.__flag = 1; out.push(desc(el)); }
}
// line-clamp / ellipsis 是「故意截断」,不算切字
const clamp = c.webkitLineClamp && c.webkitLineClamp !== 'none';
const ox = c.overflowX;
if ((ox === 'hidden' || ox === 'clip') && !clamp && c.textOverflow !== 'ellipsis' && el.scrollWidth > el.clientWidth + 2) {
const own = [...el.childNodes].some((n) => n.nodeType === 3 && n.textContent.trim().length);
if (own && el.textContent.trim().length) clip.push(desc(el) + ' text=' + el.textContent.trim().slice(0, 24));
}
}
// 控件标签不许省略号截断。上面那条 clip 故意放过 text-overflow:ellipsis,
// 因为散文里截断是有意的;但分段控件/页签/按钮/下拉当前值的文字就是这一个选项
// **唯一**的说明,截一半等于把「全部素材」显示成「全部素」、把「按更新时间」显示成「按更…」。
// 病灶一(2026-11 实测):PanelHead 的 right 槽给 ViewSwitch 传了 block,
// antd 把三段等分成 71.3px,而「全部素材」连图标要 76px —— .ant-segmented-item-label
// 的 overflow:hidden 把最后一个字裁掉半格,tsc / build / 旧 clip 全都是绿的。
// 病灶二(同月实测,23 处):档位写的是「标签+控件」的总宽,标签列一长
// 下拉当前值就-first-被咬——「全部状态」77>70、「按更新时间」91>70、「有限思考」77>46。
// 选中值是筛选条件本身,看不见等于没筛,所以它必须在盒子里整颗放得下。
// 唯一豁免:选项名本身就是一整句话的下拉(时间线「内嵌软字幕轨(播放器可开关,画质无损 · 推荐)」、
// 交付「跟随时间线设置(默认内嵌软字幕轨)」),盒子中放不下整句是几何事实,
// antd 的 ellipsis + title + 面板折行(.nex-select-popup)才是正解,页面用
// nex-prose-value 显式标出来,不许再靠 ellipsis 静默。
// 菜单不在名单里:侧栏项目名截断是设计(省略号 + title 全文)。
const trunc = [];
const overflows = (n) => {
// 只认「自己带文字」的节点:按钮里那个隐藏的 file input 永远 scrollWidth > clientWidth,
// 但它没有文字,截不截都读得出来。
const own = [...n.childNodes].some((x) => x.nodeType === 3 && x.textContent.trim().length);
if (!own && !(n.textContent || '').trim()) return false;
const c = getComputedStyle(n);
if ((c.overflowX === 'hidden' || c.overflowX === 'clip') && n.scrollWidth > n.clientWidth + 1) {
trunc.push(desc(n) + ' ' + n.scrollWidth + '>' + n.clientWidth
+ ' text=' + (n.textContent || '').trim().slice(0, 24));
return true;
}
return false;
};
document.querySelectorAll(
'.ant-segmented-item-label, .ant-tabs-tab-btn, .ant-btn, .ant-select-selection-item'
).forEach((el) => {
const r = el.getBoundingClientRect();
if (r.width < 2 || r.height < 2) return;
if (el.closest('.nex-prose-value')) return; // 整句型选项值:见上面的豁免说明
2026-11-05 08:53:24 +00:00
// 顶栏那颗项目胶囊(.nex-console)属于**外壳**,不是页面里的控件:56px 高的 Header
// 要同时装项目名 + 状态 + 12 段轨道 + 百分比 + 「当前 · …」整句(自然宽 651px),
// 而它自己只分到 327~640px。全文三条路都在:按钮 title(《名字》流程进度 83% ·
// 已完成 10/12 · 当前节点:X)、两段文字各自的 ellipsis tooltip、点开就是「项目概况」抽屉。
// 与「菜单不在名单里:侧栏项目名截断是设计」同一条口径(见本函数末行注释)。
// 它管住的是「不许塌成 30px 的残字」——那由组件里 flex-none 的项目名保证(实测 ≥149)。
if (el.closest('.nex-console')) return;
UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档 docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14): - §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部, Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记; §10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下; - §15 两道闸的判定口径写死,退出码都必须为 0。 scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> / 浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。 scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事—— :root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、 display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、 控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、 4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。 新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。 旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。 README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。 本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 / visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮) console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 04:42:28 +00:00
if (overflows(el)) return;
[...el.querySelectorAll('*')].some(overflows);
});
NEX 阶段 0–3 落地:规范对齐、状态标签截断兜底、三处热区键盘可达、浮层层级表 阶段 0(0 行业务代码):根 nex.config.yaml 把本项目实测值写死(Header 56 / Sider 224·64 / Content 24·1680),AGENTS.md 的 NEX 路径统一加 nex_design_system/ 前缀并声明 docs/UI规范.md 为项目级权威;新增 docs/NEX-对照与例外.md 逐条判定 81 行 (COMPLIANT 49 / ADAPTED 17 / ADOPTED 13 / DEFERRED 7 / N-A 10)+ 例外 E1–E10 + 别名表(不新增 --nex-* 命名空间)+ 反向清单 N1–N15。 阶段 1:ui/Status.tsx 的 Tag 自己兜 title(flatText 取正文),分镜卡标题 min-w-0、 状态标签 flex-none,顶栏流水线台 max-md:hidden 收口;visualcheck 新增 tagtitle 断言, 「截断却没兜底」从此进闸门。修掉分镜卡标签压到 35px、顶栏胶囊塌成 7px 两处实测病灶。 阶段 2:三处非语义热区可键盘化——顶栏品牌区改真实 <Link>(头像与平台名合成一个焦点站)、 分镜卡 <article> 加 tabIndex/aria-label/aria-current + Enter/Space(不套 role=button, 免抹掉卡内勾选框与三颗按钮)、Rows::LogRow 只在真有 onClick 时进 Tab 序列。 阶段 3:lib/layers.ts 建立 9 档层级表并被 7 处浮层引用;顺带修掉两条实测遮挡—— 素材抽屉里点缩略图灯箱看不见(220 < 抽屉 1000)、声线抽屉里录音面板点不着(260), 确认框第一次拥有自己的数(1190)以免灯箱抬升后压不住。 验证:typecheck / classaudit / build 全部 EXIT 0;visualcheck 84 状态(14 路由 × 3 视口 × 2 主题)console 0 · HTTP 0 · 断言 0;11 道常驻探针 GATEPROBE_OK 11/11。 详细取证见 reports/NEX阶段0-3实施-2026-11-07.md。
2026-11-07 08:49:14 +00:00
// 标签(Tag / Status / Badge 共用 .nex-tag-text)是**允许**在内部省略的:
// 一条状态文案不能把卡片顶宽(app.css §2.1 那段 max-width:100% 就是为它写的)。
// 但省略的前提是「完整文案还有一条读得到的路」——title 或 aria-label。
// 病灶(2026-11 阶段 1 · 审计报告 D1):分镜卡右上角的状态标签窄卡上只剩
// 「待生…」,Status.tsx 没往 Tag 传 title,悬停/读屏都取不到全文,
// 而它恰恰是这一镜**唯一**的状态说明。上面那条 trunc 名单不含标签,
// 所以这个破口 tsc / build / 旧 visualcheck 全是绿的。
// 口径:控件标签(按钮/页签/分段/下拉当前值)不许截断;信息标签可以截断,但必须有兜底。
const tagtitle = [];
document.querySelectorAll('.nex-tag-text').forEach((el) => {
const r = el.getBoundingClientRect();
if (r.width < 2 || r.height < 2) return;
if (el.scrollWidth <= el.clientWidth + 1) return; // 没截断
const host = el.closest('.ant-tag');
const hint = host && (host.getAttribute('title') || host.getAttribute('aria-label') || '');
if (hint.trim()) return; // 已有兜底
tagtitle.push(desc(el) + ' ' + el.scrollWidth + '>' + el.clientWidth
+ ' text=' + (el.textContent || '').trim().slice(0, 24));
});
闸门跟着 antd 布局层重新校准:三处检查不再说假话 症状:布局层搬进 antd(Flex / Drawer actions / Tag)之后,四道闸里冒出一批 「查的是老口径」的误报,逼得人想给闸门加豁免——那是要把闸门关掉的前兆。 ① visualcheck 侧栏探针只认 .ant-menu-item-selected,可菜单折叠时高亮的是 父级 SubMenu 标题,antd 给它的是透明底 + colorPrimary(正确长相), 拿选中项的 controlItemBgActive 去比就必然红:430 档 projects/13/{delivery,dispatch,timeline} 三页连续报假故障。 ② 同一支脚本把「行高为 0」当塌陷,而 antd 的图标复位本来就把 .anticon 写成 line-height:0(盒子由 font-size 撑开),图标一旦带上 text-* 就中枪。 ③ classaudit 第 4 条用 \b(actions|footer)=\{ 找浮层底部动作条, PageHead actions(页头视图开关)和 Toolbar actions(勾选后的批量条) 名字撞车被一起吞进来,「最后一颗必须是主行动」判到了不该管的地方。 ④ Tailwind 词表没有 Flex 的 wrap / space-between 与 cursor 的 not-allowed, 这三个 props 值天天出现,逐行切词分不清引号内外,只能点名放行。 做法:①探针多输出一个 kind(item / submenu),Python 侧只在 kind=item 时比色板, submenu 交给原有的浮层复核分支;②行高断言排除 .anticon; ③先定位 prop 挂在哪个元素上,只有 Drawer / Modal(含 kit 转发的 AntDrawer / AntModal)才算底部动作条——实测全站 25 处里受管 12 处,另 12 处归 §7 控件栏; ④三个词进白名单,并在注释里写清「当类名写出来仍是笔误」; 顺带删掉临时探针 nexprobe.cjs / nexprobe.tsx(能力已并进 visualcheck), 新增 scripts/ui/helpshots.py:手册的 12 张插图是静态 PNG,不参与构建, UI 每换一次皮肤就整批过期,拍摄口径(视口/dpr/主题/主角项目/先收概况)写进脚本头。 为什么:闸门报一次假,人就多写一次豁免;豁免写满,真故障就混在里面没人看。 所以这一轮修的是检查本身的口径,而不是给页面加特例。
2026-11-03 09:02:03 +00:00
// 「同一概念的按钮组不许乱跨行」(docs/UI规范.md §7):ActionGroup 是一组按钮的**原子单位**,
// 要挪整组一起挪。这里量的是渲染结果而不是 class:同一容器里子项的垂直中心落在两条
// 水平线上 = 这组被折成两排。stack(antd 给 ant-flex-vertical)是刻意的竖排等宽,跳过;
// 只在主宽度及以上做(窄屏工具条折行是设计,桌面档折行是没分组)。
const wrap = [];
if (vw >= 1024) {
for (const el of document.querySelectorAll('.nex-action-group')) {
if ((typeof el.className === 'string' ? el.className : '').indexOf('ant-flex-vertical') >= 0) continue;
const kids = [...el.children].filter((k) => k.getBoundingClientRect().width > 0);
if (kids.length < 2) continue;
const rows = [];
for (const k of kids) {
const r = k.getBoundingClientRect();
const y = r.top + r.height / 2;
if (!rows.some((v) => Math.abs(v - y) < 8)) rows.push(y);
}
if (rows.length > 1) {
wrap.push(desc(el) + ' rows=' + rows.length + ' '
+ kids.map((k) => (k.innerText || k.tagName).trim().slice(0, 8)).join('|'));
}
}
}
UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档 docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14): - §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部, Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记; §10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下; - §15 两道闸的判定口径写死,退出码都必须为 0。 scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> / 浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。 scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事—— :root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、 display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、 控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、 4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。 新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。 旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。 README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。 本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 / visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮) console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 04:42:28 +00:00
return {vw, page: document.documentElement.scrollWidth, out: out.slice(0, 8),
闸门跟着 antd 布局层重新校准:三处检查不再说假话 症状:布局层搬进 antd(Flex / Drawer actions / Tag)之后,四道闸里冒出一批 「查的是老口径」的误报,逼得人想给闸门加豁免——那是要把闸门关掉的前兆。 ① visualcheck 侧栏探针只认 .ant-menu-item-selected,可菜单折叠时高亮的是 父级 SubMenu 标题,antd 给它的是透明底 + colorPrimary(正确长相), 拿选中项的 controlItemBgActive 去比就必然红:430 档 projects/13/{delivery,dispatch,timeline} 三页连续报假故障。 ② 同一支脚本把「行高为 0」当塌陷,而 antd 的图标复位本来就把 .anticon 写成 line-height:0(盒子由 font-size 撑开),图标一旦带上 text-* 就中枪。 ③ classaudit 第 4 条用 \b(actions|footer)=\{ 找浮层底部动作条, PageHead actions(页头视图开关)和 Toolbar actions(勾选后的批量条) 名字撞车被一起吞进来,「最后一颗必须是主行动」判到了不该管的地方。 ④ Tailwind 词表没有 Flex 的 wrap / space-between 与 cursor 的 not-allowed, 这三个 props 值天天出现,逐行切词分不清引号内外,只能点名放行。 做法:①探针多输出一个 kind(item / submenu),Python 侧只在 kind=item 时比色板, submenu 交给原有的浮层复核分支;②行高断言排除 .anticon; ③先定位 prop 挂在哪个元素上,只有 Drawer / Modal(含 kit 转发的 AntDrawer / AntModal)才算底部动作条——实测全站 25 处里受管 12 处,另 12 处归 §7 控件栏; ④三个词进白名单,并在注释里写清「当类名写出来仍是笔误」; 顺带删掉临时探针 nexprobe.cjs / nexprobe.tsx(能力已并进 visualcheck), 新增 scripts/ui/helpshots.py:手册的 12 张插图是静态 PNG,不参与构建, UI 每换一次皮肤就整批过期,拍摄口径(视口/dpr/主题/主角项目/先收概况)写进脚本头。 为什么:闸门报一次假,人就多写一次豁免;豁免写满,真故障就混在里面没人看。 所以这一轮修的是检查本身的口径,而不是给页面加特例。
2026-11-03 09:02:03 +00:00
clip: clip.slice(0, 8), disp: dispBad.slice(0, 8), trunc: trunc.slice(0, 8),
NEX 阶段 0–3 落地:规范对齐、状态标签截断兜底、三处热区键盘可达、浮层层级表 阶段 0(0 行业务代码):根 nex.config.yaml 把本项目实测值写死(Header 56 / Sider 224·64 / Content 24·1680),AGENTS.md 的 NEX 路径统一加 nex_design_system/ 前缀并声明 docs/UI规范.md 为项目级权威;新增 docs/NEX-对照与例外.md 逐条判定 81 行 (COMPLIANT 49 / ADAPTED 17 / ADOPTED 13 / DEFERRED 7 / N-A 10)+ 例外 E1–E10 + 别名表(不新增 --nex-* 命名空间)+ 反向清单 N1–N15。 阶段 1:ui/Status.tsx 的 Tag 自己兜 title(flatText 取正文),分镜卡标题 min-w-0、 状态标签 flex-none,顶栏流水线台 max-md:hidden 收口;visualcheck 新增 tagtitle 断言, 「截断却没兜底」从此进闸门。修掉分镜卡标签压到 35px、顶栏胶囊塌成 7px 两处实测病灶。 阶段 2:三处非语义热区可键盘化——顶栏品牌区改真实 <Link>(头像与平台名合成一个焦点站)、 分镜卡 <article> 加 tabIndex/aria-label/aria-current + Enter/Space(不套 role=button, 免抹掉卡内勾选框与三颗按钮)、Rows::LogRow 只在真有 onClick 时进 Tab 序列。 阶段 3:lib/layers.ts 建立 9 档层级表并被 7 处浮层引用;顺带修掉两条实测遮挡—— 素材抽屉里点缩略图灯箱看不见(220 < 抽屉 1000)、声线抽屉里录音面板点不着(260), 确认框第一次拥有自己的数(1190)以免灯箱抬升后压不住。 验证:typecheck / classaudit / build 全部 EXIT 0;visualcheck 84 状态(14 路由 × 3 视口 × 2 主题)console 0 · HTTP 0 · 断言 0;11 道常驻探针 GATEPROBE_OK 11/11。 详细取证见 reports/NEX阶段0-3实施-2026-11-07.md。
2026-11-07 08:49:14 +00:00
tagtitle: tagtitle.slice(0, 8), wrap: wrap.slice(0, 6)};
UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档 docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14): - §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部, Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记; §10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下; - §15 两道闸的判定口径写死,退出码都必须为 0。 scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> / 浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。 scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事—— :root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、 display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、 控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、 4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。 新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。 旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。 README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。 本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 / visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮) console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 04:42:28 +00:00
}"""
def audit(page, route: str, width: int, theme: str, problems: list[str], *,
menu_required: bool = False, shot_prefix: bool = True) -> None:
"""量一把渲染结果并截图:登录页与业务页共用同一份尺子,不允许两套口径。
`menu_required` 只由调用方按「这一条在不在侧栏导航里」给:账号 / 用户管理 /
手册 / 登录页没有选中项是正常的,业务路由没有就是 selectedKeys 断了。
"""
probe = page.evaluate(PROBE)
lay = page.evaluate(LAYOUT)
for o in lay["out"]:
problems.append(f"{width}/{theme}{route}: 捅出视口 {o}")
for o in lay["clip"]:
problems.append(f"{width}/{theme}{route}: 文字被切 {o}")
for o in lay["disp"]:
problems.append(f"{width}/{theme}{route}: display utility 被组件样式盖掉 {o}")
for o in lay["trunc"]:
problems.append(f"{width}/{theme}{route}: 控件标签被省略号截断 {o}")
NEX 阶段 0–3 落地:规范对齐、状态标签截断兜底、三处热区键盘可达、浮层层级表 阶段 0(0 行业务代码):根 nex.config.yaml 把本项目实测值写死(Header 56 / Sider 224·64 / Content 24·1680),AGENTS.md 的 NEX 路径统一加 nex_design_system/ 前缀并声明 docs/UI规范.md 为项目级权威;新增 docs/NEX-对照与例外.md 逐条判定 81 行 (COMPLIANT 49 / ADAPTED 17 / ADOPTED 13 / DEFERRED 7 / N-A 10)+ 例外 E1–E10 + 别名表(不新增 --nex-* 命名空间)+ 反向清单 N1–N15。 阶段 1:ui/Status.tsx 的 Tag 自己兜 title(flatText 取正文),分镜卡标题 min-w-0、 状态标签 flex-none,顶栏流水线台 max-md:hidden 收口;visualcheck 新增 tagtitle 断言, 「截断却没兜底」从此进闸门。修掉分镜卡标签压到 35px、顶栏胶囊塌成 7px 两处实测病灶。 阶段 2:三处非语义热区可键盘化——顶栏品牌区改真实 <Link>(头像与平台名合成一个焦点站)、 分镜卡 <article> 加 tabIndex/aria-label/aria-current + Enter/Space(不套 role=button, 免抹掉卡内勾选框与三颗按钮)、Rows::LogRow 只在真有 onClick 时进 Tab 序列。 阶段 3:lib/layers.ts 建立 9 档层级表并被 7 处浮层引用;顺带修掉两条实测遮挡—— 素材抽屉里点缩略图灯箱看不见(220 < 抽屉 1000)、声线抽屉里录音面板点不着(260), 确认框第一次拥有自己的数(1190)以免灯箱抬升后压不住。 验证:typecheck / classaudit / build 全部 EXIT 0;visualcheck 84 状态(14 路由 × 3 视口 × 2 主题)console 0 · HTTP 0 · 断言 0;11 道常驻探针 GATEPROBE_OK 11/11。 详细取证见 reports/NEX阶段0-3实施-2026-11-07.md。
2026-11-07 08:49:14 +00:00
for o in lay["tagtitle"]:
problems.append(f"{width}/{theme}{route}: 标签被省略号截断且没有 title/aria-label 兜底 {o}")
闸门跟着 antd 布局层重新校准:三处检查不再说假话 症状:布局层搬进 antd(Flex / Drawer actions / Tag)之后,四道闸里冒出一批 「查的是老口径」的误报,逼得人想给闸门加豁免——那是要把闸门关掉的前兆。 ① visualcheck 侧栏探针只认 .ant-menu-item-selected,可菜单折叠时高亮的是 父级 SubMenu 标题,antd 给它的是透明底 + colorPrimary(正确长相), 拿选中项的 controlItemBgActive 去比就必然红:430 档 projects/13/{delivery,dispatch,timeline} 三页连续报假故障。 ② 同一支脚本把「行高为 0」当塌陷,而 antd 的图标复位本来就把 .anticon 写成 line-height:0(盒子由 font-size 撑开),图标一旦带上 text-* 就中枪。 ③ classaudit 第 4 条用 \b(actions|footer)=\{ 找浮层底部动作条, PageHead actions(页头视图开关)和 Toolbar actions(勾选后的批量条) 名字撞车被一起吞进来,「最后一颗必须是主行动」判到了不该管的地方。 ④ Tailwind 词表没有 Flex 的 wrap / space-between 与 cursor 的 not-allowed, 这三个 props 值天天出现,逐行切词分不清引号内外,只能点名放行。 做法:①探针多输出一个 kind(item / submenu),Python 侧只在 kind=item 时比色板, submenu 交给原有的浮层复核分支;②行高断言排除 .anticon; ③先定位 prop 挂在哪个元素上,只有 Drawer / Modal(含 kit 转发的 AntDrawer / AntModal)才算底部动作条——实测全站 25 处里受管 12 处,另 12 处归 §7 控件栏; ④三个词进白名单,并在注释里写清「当类名写出来仍是笔误」; 顺带删掉临时探针 nexprobe.cjs / nexprobe.tsx(能力已并进 visualcheck), 新增 scripts/ui/helpshots.py:手册的 12 张插图是静态 PNG,不参与构建, UI 每换一次皮肤就整批过期,拍摄口径(视口/dpr/主题/主角项目/先收概况)写进脚本头。 为什么:闸门报一次假,人就多写一次豁免;豁免写满,真故障就混在里面没人看。 所以这一轮修的是检查本身的口径,而不是给页面加特例。
2026-11-03 09:02:03 +00:00
for o in lay["wrap"]:
problems.append(f"{width}/{theme}{route}: 同一概念的按钮组被拆成两排 {o}")
if probe["theme"] != theme:
problems.append(f"{width}/{theme}{route}: data-theme={probe['theme']}")
for k, val in probe["root"].items():
if not val:
problems.append(f"{width}/{theme}{route}: :root 缺 --{k}")
want = ANTD_PRIMARY[theme]
got = probe["root"]["primary"].lower()
if got != want:
problems.append(f"{width}/{theme}{route}: 主色 {got} ≠ antd 出厂蓝 {want}"
f"(站内不覆盖 colorPrimary,见 theme/antd.ts)")
# 逐元素扫颜色只在主宽度做:换色不看宽度,四个宽度重复扫只是多花一倍时间
if width == WIDTHS[0]:
for hexv, rec in page.evaluate(COLORSCAN).items():
problems.append(f"{width}/{theme}{route}: 残留旧品牌lime族 {hexv} ×{rec['n']} e.g. {rec['e']}")
for bad in probe["text"]:
problems.append(f"{width}/{theme}{route}: 行高塌了 {bad}")
NEX 阶段 8·D17/N7:<768 导航改左抽屉,同一屏只剩一个导航入口,顶栏胶囊溢出归零 用户批准「移动端导航采用抽屉式 Drawer」。改前三条实测决定了必须怎么改: ① Sider 的 breakpoint="md" 把侧栏自动收成 64px 图标轨,而汉堡同时还在, label 写着「展开导航菜单」——点它只把图标轨撑回 224,随即又被 breakpoint 收回, 同一屏两个导航入口且行为自相矛盾(NEX 04 §8.2 明令消掉的状态); ② 那 64px 是真金白银的正文宽度:430 实测正文盒 366(可用 342)、576 实测 512; ③ D17 那 33–38px 溢出正是被它逼出来的:流水线台那颗 Button 内容居中, 装不下就两端一起往外溢——430 胶囊盒子 x=100 w=172、内容 sw 203, 项目名从 x=63 起画(比胶囊左沿还偏左 37px),箭头画到 x=305(胶囊右沿 272)。 实现: - kit Drawer 加 placement(默认 right,站内既有 10 处调用点一个都不传,行为逐字不变) 与 flushBody。flushBody 只能是 prop:.ant-drawer-body 的 padding 是 antd CSS-in-JS 的 未层声明,页面写 p-0 在 @layer utilities 里,层外压层内(同 §1.1.1 的 .nex-tag 实测)。 左右默认宽分档(左 min(288px,100vw−48px) / 右 DRAWER_WIDE):抽屉宽度取决于它是 「替换主内容的位置」还是「压在主内容上的一块面板」。 - AppSider 拆三导出:AppNavMenu(菜单本体)/ AppSider(≥768 常驻,撤 breakpoint)/ AppNavDrawer(<768 左抽屉,宽 = SIDER_WIDTH 224 + flushBody)。抽屉宽不取 antd 默认 378: 里面是同一份菜单,宽度一换折行、缩进、选中底色宽度全都换,等于凭空多出第二个导航形态。 - App 测一次 narrow(Grid.useBreakpoint().md === false,undefined 当桌面否则 1440 会闪一帧 「没侧栏只有汉堡」)往下传:侧栏在不在、汉堡点哪儿,两处必须同一个答案。navOpen 换页自动关。 - 同一颗汉堡换语义:≥768 折叠侧栏(原文案),<768 开合抽屉(打开/关闭导航菜单), aria-expanded 只在抽屉形态给(折叠侧栏是布局尺寸,不是被展开的面板);图标改按 「导航现在露没露」选,≥768 时 navShown === !collapsed 与改前逐字同值,<768 抽屉关着时 画的正是改前那颗 Expand → 顶栏像素没动。 - PipelineConsole 的项目名只在 <768 恢复收缩权(max-md:min-w-0 max-md:flex-[0_1_auto])。 第十三轮给的 flex-none 是为了「名字不许被散文吃掉」,那条在 ≥768 依然成立;手机档没有 散文可吃(cur <lg 隐、rail <xl 隐、status <md 隐),只剩「名字 vs 百分比+箭头」一道减法, 折出来的是省略号 + tooltip(§15.2 第 7 条:省略号可以,残字不行)。 探针:visualcheck 补 probe.sider;菜单断言先问侧栏在不在,<768 真点一下汉堡,量 .ant-drawer-content-wrapper(外层 .ant-drawer 是 inset:0 的遮罩容器,宽恒等视口,拿它比 224 会全线误报)并断言左贴边 / 宽 224 / 选中态底色等于桌面同一份 token / Esc 必须关。 顺手修掉一处从阶段 0 就存在的失配:menu_required 用 `path in NAV_ROUTES` 比的是**模板** (/projects/{id}/overview),主循环早已换成真实 id,七条项目路由从没进过菜单断言—— 新增 in_nav() 后覆盖 3 → 10 条路由。 未做(授权 §六):卡片没扩大、栅格没改、56/224/64 与控件三档一字未动、430 的表格仍横向 滚动而没有顺手改堆叠单栏。 验证:typecheck 通过 · build 通过(仅既有 chunk>1200kB 告警)· classaudit 九道全 0 exit 0 · visualcheck 120 状态(15 路由 × 4 视口 × 明暗)0 断言 / 0 HTTP / 0 console · 常驻 11 道探针 EXIT=0 ×11(GATEPROBE_OK 11/11)· 第 9 闸反证 BP_PROBE_OK 10/10 · navprobe 几何 FAIL 4/10 → PASS 0/10(430 溢出 33→0、正文 366→430)· drawercheck 行为账 after PASS 0 条,对 HEAD 反证 FAIL 10 条 · tableaudit 逐视口前后:1440 两态 0 违规、768 两态逐字相同、576 溢出量各 −64、430 违规 9→6 · ≥768 像素疑点定性为 Noto Sans SC 异步 swap 竞态 + 活动角标漂移:document.fonts.ready 后 before/after 顶栏强差 0(1440 与 768),1440 两态 DOM 几何逐字相同。 证据 reports/ui_evidence/nex-p8/d17/。 规范同步:UI规范 §6 外壳表补 AppNavMenu/AppNavDrawer 两行并写清撤 breakpoint 的理由、 §15 第 3 条改抽屉口径 + 登记 NAV_ROUTES 事故、§4 insp-sm 同步复核结论; NEX-对照与例外 §2.4 <768 DEFERRED → ADOPTED、§5 N7 → 已采纳、§6 D17 → 已修、§7 变更记录; nex.config.yaml shell 段加 sidebar_narrow: drawer 并校正四条尺寸的实现行号。
2026-11-07 15:36:48 +00:00
if menu_required and not probe.get("sider"):
# <768(阶段 8·N7):导航不在页面里,在顶栏汉堡后面的左抽屉里。
# 抽屉没开时它那份菜单可能压根不在 DOM(antd Drawer 首次打开前不渲染),
# 所以这里不能读探针,必须真的点一下:点开 → 量选中态 → Esc 关掉。
# 量的是和桌面档同一个数(同一份 token 的选中底色/前景色),
# 这条断言顺带看住了两件不该变的事:抽屉确实是左抽屉宽 224、Esc 确实能关。
btn = page.locator('button[aria-label="打开导航菜单"]')
if not btn.count():
problems.append(f"{width}/{theme}{route}: 窄屏没有常驻侧栏,也没有「打开导航菜单」按钮(导航没有入口)")
else:
try:
btn.first.click()
page.wait_for_selector(".ant-drawer-open", timeout=5000)
page.wait_for_timeout(450)
got = page.evaluate(r"""() => {
const d = document.querySelector('.ant-drawer-open');
if (!d) return null;
/* 量的必须是 .ant-drawer-content-wrapper:外层 .ant-drawer 是
position:fixed; inset:0 的那层遮罩容器,宽度恒等于视口,
拿它比 224 会全线误报(实测 430 档它报 430)。 */
const panel = d.querySelector('.ant-drawer-content-wrapper') || d;
const b = panel.getBoundingClientRect();
const it = d.querySelector('.ant-menu-item-selected');
const cs = it ? getComputedStyle(it) : null;
return {x: Math.round(b.x), w: Math.round(b.width),
placement: d.className.includes('ant-drawer-left') ? 'left' : 'other',
items: d.querySelectorAll('.ant-menu-item').length,
menu: it ? {bg: cs.backgroundColor, color: cs.color,
text: it.textContent.trim().slice(0, 12)} : null};
}""")
if not got:
problems.append(f"{width}/{theme}{route}: 点了「打开导航菜单」抽屉没开")
else:
want_bg, want_fg = MENU_SELECTED[theme]
if got["placement"] != "left" or got["x"] != 0:
problems.append(f"{width}/{theme}{route}: 导航抽屉不在左边 x={got['x']}")
if got["w"] != NAV_DRAWER_WIDTH:
problems.append(f"{width}/{theme}{route}: 导航抽屉宽 {got['w']},应为侧栏同宽 {NAV_DRAWER_WIDTH}")
if not got["menu"]:
problems.append(f"{width}/{theme}{route}: 导航抽屉里没有选中项")
elif got["menu"]["bg"] != want_bg or got["menu"]["color"] != want_fg:
problems.append(f"{width}/{theme}{route}: 导航抽屉选中态 {got['menu']['bg']}"
f"/{got['menu']['color']},应为 {want_bg}/{want_fg}")
page.keyboard.press("Escape")
page.wait_for_timeout(500)
if page.locator(".ant-drawer-open").count():
problems.append(f"{width}/{theme}{route}: Esc 没有关掉导航抽屉(会挡住截图与后续操作)")
except Exception as exc: # 点开/关掉任一环节抛错都不能把整轮 120 次跑挂
problems.append(f"{width}/{theme}{route}: 导航抽屉检查异常 {exc}")
elif menu_required:
if not probe["menu"]:
problems.append(f"{width}/{theme}{route}: 菜单没有选中项")
闸门跟着 antd 布局层重新校准:三处检查不再说假话 症状:布局层搬进 antd(Flex / Drawer actions / Tag)之后,四道闸里冒出一批 「查的是老口径」的误报,逼得人想给闸门加豁免——那是要把闸门关掉的前兆。 ① visualcheck 侧栏探针只认 .ant-menu-item-selected,可菜单折叠时高亮的是 父级 SubMenu 标题,antd 给它的是透明底 + colorPrimary(正确长相), 拿选中项的 controlItemBgActive 去比就必然红:430 档 projects/13/{delivery,dispatch,timeline} 三页连续报假故障。 ② 同一支脚本把「行高为 0」当塌陷,而 antd 的图标复位本来就把 .anticon 写成 line-height:0(盒子由 font-size 撑开),图标一旦带上 text-* 就中枪。 ③ classaudit 第 4 条用 \b(actions|footer)=\{ 找浮层底部动作条, PageHead actions(页头视图开关)和 Toolbar actions(勾选后的批量条) 名字撞车被一起吞进来,「最后一颗必须是主行动」判到了不该管的地方。 ④ Tailwind 词表没有 Flex 的 wrap / space-between 与 cursor 的 not-allowed, 这三个 props 值天天出现,逐行切词分不清引号内外,只能点名放行。 做法:①探针多输出一个 kind(item / submenu),Python 侧只在 kind=item 时比色板, submenu 交给原有的浮层复核分支;②行高断言排除 .anticon; ③先定位 prop 挂在哪个元素上,只有 Drawer / Modal(含 kit 转发的 AntDrawer / AntModal)才算底部动作条——实测全站 25 处里受管 12 处,另 12 处归 §7 控件栏; ④三个词进白名单,并在注释里写清「当类名写出来仍是笔误」; 顺带删掉临时探针 nexprobe.cjs / nexprobe.tsx(能力已并进 visualcheck), 新增 scripts/ui/helpshots.py:手册的 12 张插图是静态 PNG,不参与构建, UI 每换一次皮肤就整批过期,拍摄口径(视口/dpr/主题/主角项目/先收概况)写进脚本头。 为什么:闸门报一次假,人就多写一次豁免;豁免写满,真故障就混在里面没人看。 所以这一轮修的是检查本身的口径,而不是给页面加特例。
2026-11-03 09:02:03 +00:00
elif probe["menu"].get("kind") != "item":
pass # 折叠态:父级标题只证明 selectedKeys 指对了分支,色板比不了,交给下面浮层复核
else:
want_bg, want_fg = MENU_SELECTED[theme]
if probe["menu"]["bg"] != want_bg or probe["menu"]["color"] != want_fg:
problems.append(f"{width}/{theme}{route}: 侧栏选中态 {probe['menu']['bg']}"
f"/{probe['menu']['color']},应为 {want_bg}/{want_fg}")
闸门跟着 antd 布局层重新校准:三处检查不再说假话 症状:布局层搬进 antd(Flex / Drawer actions / Tag)之后,四道闸里冒出一批 「查的是老口径」的误报,逼得人想给闸门加豁免——那是要把闸门关掉的前兆。 ① visualcheck 侧栏探针只认 .ant-menu-item-selected,可菜单折叠时高亮的是 父级 SubMenu 标题,antd 给它的是透明底 + colorPrimary(正确长相), 拿选中项的 controlItemBgActive 去比就必然红:430 档 projects/13/{delivery,dispatch,timeline} 三页连续报假故障。 ② 同一支脚本把「行高为 0」当塌陷,而 antd 的图标复位本来就把 .anticon 写成 line-height:0(盒子由 font-size 撑开),图标一旦带上 text-* 就中枪。 ③ classaudit 第 4 条用 \b(actions|footer)=\{ 找浮层底部动作条, PageHead actions(页头视图开关)和 Toolbar actions(勾选后的批量条) 名字撞车被一起吞进来,「最后一颗必须是主行动」判到了不该管的地方。 ④ Tailwind 词表没有 Flex 的 wrap / space-between 与 cursor 的 not-allowed, 这三个 props 值天天出现,逐行切词分不清引号内外,只能点名放行。 做法:①探针多输出一个 kind(item / submenu),Python 侧只在 kind=item 时比色板, submenu 交给原有的浮层复核分支;②行高断言排除 .anticon; ③先定位 prop 挂在哪个元素上,只有 Drawer / Modal(含 kit 转发的 AntDrawer / AntModal)才算底部动作条——实测全站 25 处里受管 12 处,另 12 处归 §7 控件栏; ④三个词进白名单,并在注释里写清「当类名写出来仍是笔误」; 顺带删掉临时探针 nexprobe.cjs / nexprobe.tsx(能力已并进 visualcheck), 新增 scripts/ui/helpshots.py:手册的 12 张插图是静态 PNG,不参与构建, UI 每换一次皮肤就整批过期,拍摄口径(视口/dpr/主题/主角项目/先收概况)写进脚本头。 为什么:闸门报一次假,人就多写一次豁免;豁免写满,真故障就混在里面没人看。 所以这一轮修的是检查本身的口径,而不是给页面加特例。
2026-11-03 09:02:03 +00:00
if probe["menu"] and probe["menu"].get("kind") == "submenu":
# 折叠态下只验到父级还不够:selectedKeys 传错时父级照样会亮。
# 展开浮层,确认这一条路由对应的二级项真的在里面被选中。
try:
page.hover(".ant-menu-submenu-selected > .ant-menu-submenu-title")
page.wait_for_timeout(450)
hit = page.evaluate(
"() => { const p = document.querySelector('.ant-menu-submenu-popup');"
" const s = p && p.querySelector('.ant-menu-item-selected');"
" return s ? s.textContent.trim().slice(0, 12) : null; }")
if not hit:
problems.append(f"{width}/{theme}{route}: 折叠态浮层里没有选中的二级项")
finally:
page.mouse.move(5, 5)
page.wait_for_timeout(150)
slug = route.strip("/").replace("/", "-") or "home"
name = f"{width}-{theme}-{slug}.png"
page.screenshot(path=str(SHOTS / name))
if shot_prefix and width == WIDTHS[0]:
print(f"shot {name:38} menu={probe['menu']} header={probe['header']}")
UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档 docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14): - §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部, Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记; §10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下; - §15 两道闸的判定口径写死,退出码都必须为 0。 scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> / 浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。 scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事—— :root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、 display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、 控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、 4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。 新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。 旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。 README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。 本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 / visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮) console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 04:42:28 +00:00
def main() -> int:
problems: list[str] = []
errors: list[str] = []
http_bad: list[str] = [] # 非素材接口的 4xx/5xx:真故障
media_missing: set[str] = set() # /media/file/ 404:库里有记录、磁盘上没文件
with sync_playwright() as pw:
browser = pw.chromium.launch()
ctx = browser.new_context(viewport={"width": 1440, "height": 900}, device_scale_factor=1)
page = ctx.new_page()
page.on("console", lambda m: errors.append(f"[{m.type}] {m.text}")
if m.type in ("error", "warning") else None)
page.on("pageerror", lambda e: errors.append(f"[pageerror] {e}"))
def on_response(res) -> None:
# 浏览器对失败请求只打一句不带 URL 的 "Failed to load resource",
# 120 次素材 404 和 1 次接口 404 在 console 里长得一模一样,必须自己按 URL 分诊。
url, status = res.url, res.status
if status < 400 or url.startswith(("ws:", "wss:")) or "/@vite" in url or "/@fs/" in url:
return
url = url.split("?")[0]
if "/media/file/" in url:
media_missing.add(url)
else:
# 带上是哪一页发出的:同一句 404 可能只在某一档宽度 / 某个页面出现
http_bad.append(f"{page.url.replace(BASE, '') or '/'} → {status} {url}")
page.on("response", on_response)
# 登录页专用的一趟(必须在登录之前跑):它没有 Header/Sider,
# 而且登录之后再访问 /login 会被守卫回落首页——URL 比对就成了假故障。
# 先落地一个同源页面:about:blank 上没有 localStorage 可写。
page.goto(BASE + "/login", wait_until="domcontentloaded")
for width in WIDTHS:
page.set_viewport_size({"width": width, "height": 900})
for theme in THEMES:
page.evaluate("(t) => localStorage.setItem('nex-the', t)", theme)
page.goto(BASE + "/login", wait_until="networkidle")
page.wait_for_timeout(500)
if not page.locator("#login-user").count():
problems.append(f"{width}/{theme}/login: 登录表单没渲染(#login-user 不在)")
continue
audit(page, "/login", width, theme, problems)
UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档 docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14): - §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部, Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记; §10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下; - §15 两道闸的判定口径写死,退出码都必须为 0。 scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> / 浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。 scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事—— :root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、 display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、 控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、 4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。 新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。 旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。 README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。 本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 / visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮) console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 04:42:28 +00:00
page.goto(BASE + "/login", wait_until="networkidle")
if page.locator("#login-user").count():
page.fill("#login-user", USER)
page.fill("#login-pass", PWD)
page.click("button[type=submit]")
page.wait_for_timeout(1500)
if page.locator("#login-pass").count():
print("LOGIN FAILED:", page.locator("body").inner_text()[:400])
return 2
pid = ""
for width in WIDTHS:
page.set_viewport_size({"width": width, "height": 900})
for theme in THEMES:
page.evaluate("(t) => localStorage.setItem('nex-the', t)", theme)
for route in ROUTES:
r = route
if r == "/login":
continue # 登录前那一趟量过了,这里再访问只会撞守卫
UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档 docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14): - §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部, Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记; §10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下; - §15 两道闸的判定口径写死,退出码都必须为 0。 scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> / 浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。 scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事—— :root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、 display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、 控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、 4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。 新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。 旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。 README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。 本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 / visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮) console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 04:42:28 +00:00
if "{id}" in r:
规范补到十七条并把探针升到「六道 + 一道反向验证」:行高、栅格、纵向节奏、标签底色全部有闸 症状:这一轮改的每一类毛病里,有四类靠人眼复查根本守不住——表格行被内容撑高(实测最高 255px)、该用栅格的地方用自然排列(窄屏两种坏画面:一行右边缘参差不齐、折行点随内容 漂移)、纵向节奏断(底边不齐 / 收缩错位)、标签自带彩色底纹(§2.1 要求中性底);而卡头 `right` 长起来把标题压成竖排(430 档标题 291×145)也没有任何闸门会报。更麻烦的是 rhythmcheck 的判据原先读像素,豁免写宽一格就永远安静地返回 0——14 条命中里混着探针 自己的假警报,没人敢信它的红。 做法:①`docs/UI规范.md` 新增 R17 表格行高纪律(§13.2)与 R16 信息块三件套的落地口径 (§13.1),§9.3 补卡头折行那条(含「折行样式要挂在 `.ant-card-head-wrapper` 而不是 `.ant-card-head`」这个陷阱与 430/1440 的实测数据),§15 扩成 15.1–15.7 六道常驻探针 加一道反向验证,§16 提交清单插入第 9 步「动过布局跑三张像素闸、改过判据跑 gateprobe」; ②新增 `tableaudit.py`(逐表报容器宽/可视宽/行数/最高行/列宽,超行高点名)、 `gridcheck.py`、`rhythmcheck.py`(GAP + RAG,四条写法级豁免逐条写明为什么豁免)、 `tagcheck.py`(扫标签 tinted 底);③`gateprobe.py` 用「坏 fixture 必须被点名、合法形态 必须被放行」两组用例反向验证三张像素闸,共 4/4 全对,不碰源码不触发 HMR; ④`rhythmcheck.py` 的判据改成只读写法不读像素(`isPin` 认 mt-auto / inline margin-top / justify-content;RAG 侧放行子块自带 max-width、align-self 与整行居中的胶囊组), `classaudit.mjs` 把 `<Flex align="flex-start">` 的取值加进 PROSE 白名单(它天天作为 props 值出现,逐行切词分不清引号内外);⑤`visualcheck.py` 的项目子页改成量「镜头最多」 的项目并支持 NEX_PROJECT_ID 覆盖——列表第一个常是空项目,空态下溢出与截断两类断言等于 没测;⑥README 的规范条目数同步到十七条(只提这一行,其余内容归并行的后端改动)。 为什么:这类毛病全是「看起来挺整齐、量一下才知道差 200px」,只有把它们变成退出码才能 防止下一轮又漏回去;而像素闸一旦可能悄悄失灵,就必须配一道反向验证——先证明闸门坏了 会响,它的绿才有意义。
2026-11-03 12:21:39 +00:00
pid = pid or FORCED_PID
UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档 docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14): - §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部, Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记; §10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下; - §15 两道闸的判定口径写死,退出码都必须为 0。 scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> / 浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。 scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事—— :root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、 display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、 控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、 4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。 新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。 旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。 README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。 本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 / visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮) console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 04:42:28 +00:00
if not pid:
规范补到十七条并把探针升到「六道 + 一道反向验证」:行高、栅格、纵向节奏、标签底色全部有闸 症状:这一轮改的每一类毛病里,有四类靠人眼复查根本守不住——表格行被内容撑高(实测最高 255px)、该用栅格的地方用自然排列(窄屏两种坏画面:一行右边缘参差不齐、折行点随内容 漂移)、纵向节奏断(底边不齐 / 收缩错位)、标签自带彩色底纹(§2.1 要求中性底);而卡头 `right` 长起来把标题压成竖排(430 档标题 291×145)也没有任何闸门会报。更麻烦的是 rhythmcheck 的判据原先读像素,豁免写宽一格就永远安静地返回 0——14 条命中里混着探针 自己的假警报,没人敢信它的红。 做法:①`docs/UI规范.md` 新增 R17 表格行高纪律(§13.2)与 R16 信息块三件套的落地口径 (§13.1),§9.3 补卡头折行那条(含「折行样式要挂在 `.ant-card-head-wrapper` 而不是 `.ant-card-head`」这个陷阱与 430/1440 的实测数据),§15 扩成 15.1–15.7 六道常驻探针 加一道反向验证,§16 提交清单插入第 9 步「动过布局跑三张像素闸、改过判据跑 gateprobe」; ②新增 `tableaudit.py`(逐表报容器宽/可视宽/行数/最高行/列宽,超行高点名)、 `gridcheck.py`、`rhythmcheck.py`(GAP + RAG,四条写法级豁免逐条写明为什么豁免)、 `tagcheck.py`(扫标签 tinted 底);③`gateprobe.py` 用「坏 fixture 必须被点名、合法形态 必须被放行」两组用例反向验证三张像素闸,共 4/4 全对,不碰源码不触发 HMR; ④`rhythmcheck.py` 的判据改成只读写法不读像素(`isPin` 认 mt-auto / inline margin-top / justify-content;RAG 侧放行子块自带 max-width、align-self 与整行居中的胶囊组), `classaudit.mjs` 把 `<Flex align="flex-start">` 的取值加进 PROSE 白名单(它天天作为 props 值出现,逐行切词分不清引号内外);⑤`visualcheck.py` 的项目子页改成量「镜头最多」 的项目并支持 NEX_PROJECT_ID 覆盖——列表第一个常是空项目,空态下溢出与截断两类断言等于 没测;⑥README 的规范条目数同步到十七条(只提这一行,其余内容归并行的后端改动)。 为什么:这类毛病全是「看起来挺整齐、量一下才知道差 200px」,只有把它们变成退出码才能 防止下一轮又漏回去;而像素闸一旦可能悄悄失灵,就必须配一道反向验证——先证明闸门坏了 会响,它的绿才有意义。
2026-11-03 12:21:39 +00:00
pid = page.evaluate(PROJECT_JS)
UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档 docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14): - §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部, Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记; §10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下; - §15 两道闸的判定口径写死,退出码都必须为 0。 scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> / 浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。 scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事—— :root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、 display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、 控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、 4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。 新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。 旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。 README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。 本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 / visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮) console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 04:42:28 +00:00
if not pid:
print("!! 拿不到项目 id,跳过", r)
continue
r = r.replace("{id}", str(pid))
page.goto(BASE + r, wait_until="networkidle")
page.wait_for_timeout(600)
# 比对 URL:页面自己乱跳(含回潮成「静默重定向回首页」)时别白测一页
UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档 docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14): - §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部, Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记; §10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下; - §15 两道闸的判定口径写死,退出码都必须为 0。 scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> / 浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。 scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事—— :root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、 display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、 控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、 4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。 新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。 旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。 README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。 本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 / visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮) console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 04:42:28 +00:00
if not page.url.rstrip("/").endswith(r.rstrip("/")):
problems.append(f"{width}/{theme}{r}: 路由不存在,实际落在 {page.url}")
continue
if r == NOT_FOUND_ROUTE and not page.get_by_text("页面不存在").count():
# 兜底页必须真的说话:只剩空壳或换回跳首页,都算这条兜底没了
problems.append(f"{width}/{theme}{r}: 404 页没有给出「页面不存在」说明")
NEX 阶段 8·D17/N7:<768 导航改左抽屉,同一屏只剩一个导航入口,顶栏胶囊溢出归零 用户批准「移动端导航采用抽屉式 Drawer」。改前三条实测决定了必须怎么改: ① Sider 的 breakpoint="md" 把侧栏自动收成 64px 图标轨,而汉堡同时还在, label 写着「展开导航菜单」——点它只把图标轨撑回 224,随即又被 breakpoint 收回, 同一屏两个导航入口且行为自相矛盾(NEX 04 §8.2 明令消掉的状态); ② 那 64px 是真金白银的正文宽度:430 实测正文盒 366(可用 342)、576 实测 512; ③ D17 那 33–38px 溢出正是被它逼出来的:流水线台那颗 Button 内容居中, 装不下就两端一起往外溢——430 胶囊盒子 x=100 w=172、内容 sw 203, 项目名从 x=63 起画(比胶囊左沿还偏左 37px),箭头画到 x=305(胶囊右沿 272)。 实现: - kit Drawer 加 placement(默认 right,站内既有 10 处调用点一个都不传,行为逐字不变) 与 flushBody。flushBody 只能是 prop:.ant-drawer-body 的 padding 是 antd CSS-in-JS 的 未层声明,页面写 p-0 在 @layer utilities 里,层外压层内(同 §1.1.1 的 .nex-tag 实测)。 左右默认宽分档(左 min(288px,100vw−48px) / 右 DRAWER_WIDE):抽屉宽度取决于它是 「替换主内容的位置」还是「压在主内容上的一块面板」。 - AppSider 拆三导出:AppNavMenu(菜单本体)/ AppSider(≥768 常驻,撤 breakpoint)/ AppNavDrawer(<768 左抽屉,宽 = SIDER_WIDTH 224 + flushBody)。抽屉宽不取 antd 默认 378: 里面是同一份菜单,宽度一换折行、缩进、选中底色宽度全都换,等于凭空多出第二个导航形态。 - App 测一次 narrow(Grid.useBreakpoint().md === false,undefined 当桌面否则 1440 会闪一帧 「没侧栏只有汉堡」)往下传:侧栏在不在、汉堡点哪儿,两处必须同一个答案。navOpen 换页自动关。 - 同一颗汉堡换语义:≥768 折叠侧栏(原文案),<768 开合抽屉(打开/关闭导航菜单), aria-expanded 只在抽屉形态给(折叠侧栏是布局尺寸,不是被展开的面板);图标改按 「导航现在露没露」选,≥768 时 navShown === !collapsed 与改前逐字同值,<768 抽屉关着时 画的正是改前那颗 Expand → 顶栏像素没动。 - PipelineConsole 的项目名只在 <768 恢复收缩权(max-md:min-w-0 max-md:flex-[0_1_auto])。 第十三轮给的 flex-none 是为了「名字不许被散文吃掉」,那条在 ≥768 依然成立;手机档没有 散文可吃(cur <lg 隐、rail <xl 隐、status <md 隐),只剩「名字 vs 百分比+箭头」一道减法, 折出来的是省略号 + tooltip(§15.2 第 7 条:省略号可以,残字不行)。 探针:visualcheck 补 probe.sider;菜单断言先问侧栏在不在,<768 真点一下汉堡,量 .ant-drawer-content-wrapper(外层 .ant-drawer 是 inset:0 的遮罩容器,宽恒等视口,拿它比 224 会全线误报)并断言左贴边 / 宽 224 / 选中态底色等于桌面同一份 token / Esc 必须关。 顺手修掉一处从阶段 0 就存在的失配:menu_required 用 `path in NAV_ROUTES` 比的是**模板** (/projects/{id}/overview),主循环早已换成真实 id,七条项目路由从没进过菜单断言—— 新增 in_nav() 后覆盖 3 → 10 条路由。 未做(授权 §六):卡片没扩大、栅格没改、56/224/64 与控件三档一字未动、430 的表格仍横向 滚动而没有顺手改堆叠单栏。 验证:typecheck 通过 · build 通过(仅既有 chunk>1200kB 告警)· classaudit 九道全 0 exit 0 · visualcheck 120 状态(15 路由 × 4 视口 × 明暗)0 断言 / 0 HTTP / 0 console · 常驻 11 道探针 EXIT=0 ×11(GATEPROBE_OK 11/11)· 第 9 闸反证 BP_PROBE_OK 10/10 · navprobe 几何 FAIL 4/10 → PASS 0/10(430 溢出 33→0、正文 366→430)· drawercheck 行为账 after PASS 0 条,对 HEAD 反证 FAIL 10 条 · tableaudit 逐视口前后:1440 两态 0 违规、768 两态逐字相同、576 溢出量各 −64、430 违规 9→6 · ≥768 像素疑点定性为 Noto Sans SC 异步 swap 竞态 + 活动角标漂移:document.fonts.ready 后 before/after 顶栏强差 0(1440 与 768),1440 两态 DOM 几何逐字相同。 证据 reports/ui_evidence/nex-p8/d17/。 规范同步:UI规范 §6 外壳表补 AppNavMenu/AppNavDrawer 两行并写清撤 breakpoint 的理由、 §15 第 3 条改抽屉口径 + 登记 NAV_ROUTES 事故、§4 insp-sm 同步复核结论; NEX-对照与例外 §2.4 <768 DEFERRED → ADOPTED、§5 N7 → 已采纳、§6 D17 → 已修、§7 变更记录; nex.config.yaml shell 段加 sidebar_narrow: drawer 并校正四条尺寸的实现行号。
2026-11-07 15:36:48 +00:00
audit(page, r, width, theme, problems, menu_required=in_nav(r, pid))
UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档 docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14): - §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部, Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记; §10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下; - §15 两道闸的判定口径写死,退出码都必须为 0。 scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> / 浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。 scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事—— :root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、 display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、 控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、 4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。 新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。 旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。 README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。 本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 / visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮) console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 04:42:28 +00:00
browser.close()
print("\n=== :root 尺子 ===")
print("(见上方逐行 menu/header)")
# 「Failed to load resource」不带 URL,是素材还是接口上面已经分诊过了,这里不再重复计数
real = [e for e in dict.fromkeys(errors)
if not any(g in e for g in IGNORE) and "Failed to load resource" not in e]
print(f"\n=== console({len(real)} 条,已豁免 {len(errors) - len(set(errors))} 条重复)===")
for e in real:
print(e[:300])
print(f"\n=== HTTP 失败({len(set(http_bad))} 条)===")
for e in list(dict.fromkeys(http_bad))[:10]:
print(e[:200])
if media_missing:
print(f"(另有 {len(media_missing)} 个素材 404:开发库里有记录、磁盘上没这个文件。"
f"UI 侧 MediaThumb 的 onError 会兜成「文件缺失」占位,不计入故障)")
print(f"\n=== 断言({len(problems)} 条)===")
for p in list(dict.fromkeys(problems))[:40]:
print(p)
return 0 if not real and not problems and not http_bad else 1
if __name__ == "__main__":
sys.exit(main())