Commit Graph

3 Commits (98ea70d74f571f7f66c656aee69c9fbfb22bbf49)

Author SHA1 Message Date
mula.liu 357942ba2e NEX 阶段 8.5·第4项:第 9 闸升级为语义与行为检查(semanticcheck 1062 行)+ 咬出的 4 类真缺陷就地修复
为什么要新闸:此前所有检查(含 classaudit 的 9 道子闸)量的是**源码字符串**——
aria-label 写没写、tabIndex 写没写。字符串会骗人:`aria-label=" "`、指向不存在 id 的
aria-labelledby、常年写着的 `aria-expanded="true"`、给了 `role=button` 却没 tabIndex、
被 CSS `outline:none` 吃掉的焦点环——源码看着齐全,辅助技术什么都读不到。
批准书 §4 要求「优先用实际浏览器行为与辅助技术语义验证」,所以全部换成真东西:
CDP `Accessibility.getFullAXTree` 读 AT 实际拿到的角色与名称、`getComputedStyle` 读算出来的
焦点环、真按 Tab / Space / Escape 看键盘走到哪儿。

七条判据(退出码 = offender 条数):NAME(AT 可读名称,硬/软两档)· HOTSPOT(pointer 可点
但键盘到不了)· TAB(走位与焦点掉出文档)· FOCUS(焦点环可见性,聚焦前后实测对比)·
ARIA(声明的状态与运行时一致)· LIVE(状态通知)· STATES(空/错误/加载六态)。
旋钮:NEX_WIDTH / NEX_THEME / NEX_ROUTES / NEX_TABS / NEX_NAMESTRICT / NEX_HOTSPOTSTRICT /
NEX_FOCUS_DWELL。软档默认不进退出码(当前 20 颗/主题属「补一句 aria-label 就干净」的历史欠账,
登记为 S-1,按路由分批转硬),不为了让灯变绿而调口径。

它第一天咬到的 4 类 58 条真缺陷,全部就地修好:
· AudioPlay 进度条:可点可拖却键盘到不了、role=slider 没有值 → 补 `tabIndex` +
  `valuemin/max/text` + ←→↑↓ 5% / Shift 20% / Home / End,并 stopPropagation(不抢页面滚动)
· MediaLightbox 只读进度:假 slider 是 ARIA 谎报 → 改 `role=progressbar`
· AssetLibrary 三处图标按钮无 AT 名称 → 补 aria-label(选择素材 / 母版)
· `input.nex-file-input` 焦点环被全局 `:where(...):focus-visible{outline:none}` 吃掉
  → `app.css` 唯一一处 +11 行,把环画在**看得见的按钮**上
  (`.ant-btn:has(> .nex-file-input:focus-visible)`)——这是本轮唯一动 CSS 的地方

反向验证:`gateprobe` 加 3 条语义判据的反例(人造坏控件必须红、撤掉必须复绿),
常驻出口从 11/11 升到 `GATEPROBE_OK 14/14`;闸登记进 `nex.config.yaml → ui_gates`
(13 → 14 条命令),并把 authority 注释里写死的「12 道探针」改成「§15 探针清单」,
免得规范与代码又对不上一次。

验证:HEAD `semanticcheck` 1440 与 430 均 **EXIT=58**(NAME 20 / HOTSPOT 16 / TAB 16 /
FOCUS 6)→ 工作树两档均 **EXIT=0**;账号侧四条 chromeless 路由另跑 EXIT=0(硬档 0);
最终代码 14:25→14:36 干净复跑 430 档 0 条违规。规范落点 docs/UI规范.md §15.13、§16 第 9 步。
2026-11-08 14:50:07 +08:00
mula.liu 9614b2d225 v 0.1.1 2026-11-05 16:53:24 +08:00
mula.liu 7e784b5303 规范补到十七条并把探针升到「六道 + 一道反向验证」:行高、栅格、纵向节奏、标签底色全部有闸
症状:这一轮改的每一类毛病里,有四类靠人眼复查根本守不住——表格行被内容撑高(实测最高
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 20:21:39 +08:00