docs(规范): 图标语义三档口径入册 + 阶段 8.5.1 实施报告
- docs/UI规范.md §5.1.1:AT-1 从「在册待办」改成成文口径——图标默认是装饰,语义由 它所在的控件说;三档(默认装饰 / 显式具名 / 显式放行)与两头禁止(不许批量 aria-hidden,也不许批量具名);antd 内部自绘图形的处理边界与两类不动的理由写清。 §15.12 十四条 → 十七条判据 + 「对偶断言」规矩;§15.13 补 GLYPH 第 8 条判据与四档读数; §16 第 9 步把两道新闸纳入改动流程。 - docs/NEX-对照与例外.md §2.8:S-2 标 COMPLIANT + 验收手段;§6 记一条 InputNumber 英文 aria-label 漂移(P2,改它要动 antd 内部 DOM 或全站 locale);§7 变更记录。 - nex.config.yaml:ui_gates 注释与代码对齐(出口形状 ICONA / GLYPH / 17 条判据), census-icons.py 登记为只读普查、不进串行。 - 阶段 8.5.1 报告:S-2 现状量级(字形名可见 900 → 80、唯一语义 42 → 0、AX 名称含 字形码 261 → 1)、改法、防复发、120 状态像素回归与噪声对照、真机 VoiceOver 实录、 未解决与 MANUAL QA 边界逐条附证据路径。 不复制规范:只在与代码口径冲突处改既有章节,未新建重复文档。main
parent
05434ade8d
commit
418fb6bc5a
|
|
@ -143,8 +143,9 @@ NEX 与本项目差异用「项目适配」解决,**不得反向修改本项
|
|||
| NEX 条款 | 状态 | 本项目出处 | 理由 |
|
||||
|---|---|---|---|
|
||||
| §1 语义化交互(不用 `div + onClick`) | **ADOPTED(原则)**;3 处热区 **本轮阶段 2 修** | `Storyboard.tsx:1915`(`<article onClick>`)、`ui/Rows.tsx:11`(`<div onClick>`)、`AppHeader.tsx:60,70`(`Avatar`/`Text` 当链接)——**行号为阶段 0 记录值**;阶段 2 之后三处已分别变为 `Storyboard.tsx:1915+`(带 `tabIndex`/`onKeyDown`)、`ui/Rows.tsx:27`(`clickable` 分支)、`AppHeader.tsx:70`(已是真 `<Link>`) | 原则完全接受;存量违规仅这 3 处(已核实:`MediaThumb.tsx:106`、`AudioPlay.tsx:68`、`MediaLightbox.tsx:186` 均已带 role/tabIndex/aria-modal,**不是**问题) |
|
||||
| §1/§2 控件的可读名称必须是自然语言——装饰图形的**字形码不得混入**(`upload 导入脚本`) | **COMPLIANT(阶段 8.5.1 · S-2 修)**;antd 内部图形的英文宿主名称另记 §6 一条漂移 | `components/icons/index.ts`(全站唯一图标出口,79 条一律 `decorative(Glyph,'IconX')`,**三档口径**:默认 `aria-hidden` / 显式 `aria-label` 走具名 / 显式 `aria-hidden={false}` 尊重调用方)、`ui/Input.tsx`(搜索按钮「搜索」+ 清空键「清空搜索」)、`ui/Ctlbar.tsx::Pager`(`itemRender` → 上一页/下一页)、`ui/Tabs.tsx`(溢出「更多页签」)、`forms/SecretInput.tsx`(「显示/隐藏密码」两态);两道机器闸:`classaudit` 第 2 闸 `ICONA`(源码侧出口形状)+ `semanticcheck` 第 8 条 `GLYPH`(DOM 侧字形码),`gateprobe` 配静态反例 | NEX 08 说「名称要能读」但没说什么算泄漏。本项目的口径是**两头都不许一刀切**:既不许批量 `aria-hidden`(那会把 42 处「图标是宿主唯一语义」变成没有名字),也不许给图标补 `aria-label={字形名}`(那正是缺陷本身)。改前 1 072 条图标读数里 **900 只**把字形码念出去、**42 只**是宿主唯一名称来源 → 改后 **80 / 0**;4 处调用点原本就写着 `aria-hidden` 的照旧尊重(不是批量加的) |
|
||||
| §2 焦点与键盘 | COMPLIANT(阶段 2 三处热区可键盘化 + **阶段 8 补排序键盘替代 N14**) | `app.css` 全站 `:focus-visible` 兜底;`ui/Table.tsx`、`MediaThumb.tsx`、`AgentConsole.tsx` 键盘处理;`lib/layers.ts::floatingLayerOpen` 分层 Esc;`Storyboard.tsx::moveByKey` + `ShotCard` 的 `aria-keyshortcuts` / `aria-describedby` | 拖拽排序的键盘替代 NEX 原本未覆盖 → **N14**,阶段 2 只做授权内的 3 处热区,**阶段 8 用户批准后落地**(`⌥↑` / `⌥↓`,实测见 `reports/ui_evidence/nex-p8/n14/`),并反向提交给 NEX `08` §2(子仓库提交) |
|
||||
| §2/§3/§5 的**验收手段**(可访问名称 / 焦点可见 / 状态播报 / 空错载 是否真成立) | **COMPLIANT(阶段 8.5 起有机器证据)**;软档 20 颗/主题待 P2 | `scripts/ui/semanticcheck.py`(第 13 道常驻探针,七条判据 NAME/HOTSPOT/TAB/FOCUS/ARIA/LIVE/STATES,全部走 CDP 的 AX 树与真按键,不读源码字符串)、`UI规范.md` **§15.13**、本轮两处真缺陷修复 `pages/AssetLibrary.tsx:1217/1274/1359`(三颗裸 `Checkbox` 补 `aria-label`)、`styles/app.css:519`(`:has()` 补回被全局复位吃掉的上传按钮焦点环) | NEX 08 只列要求、没给「怎么证明」,此前本项目也只在源码里数 `aria-*` 字符串——实测这种数法**两个真缺陷一个都抓不到**(D-A 旁边有文字、D-B 病灶在 CSS)。HEAD `5a10bfb` 同尺对照:改前硬档 **58 条**(NAME 20 / HOTSPOT 16 / TAB 16 / FOCUS 6,1440 与 430 两档读数相同)→ 工作树改后硬档 0;那 40 条 NAME 软档(20 每主题)不计退出码;剩下的软档 19 类同一根因:`ui/Fields.tsx::Field` 孤立使用 antd `Form.Item`(外层无 `<Form>`)⇒ `<label for>` 为空,属 P2 批量整改,默认不进退出码(`NEX_NAMESTRICT=1` 可升硬) |
|
||||
| §2/§3/§5 的**验收手段**(可访问名称 / 焦点可见 / 状态播报 / 空错载 是否真成立) | **COMPLIANT(阶段 8.5 起有机器证据 · 阶段 8.5.1 加第 8 条 GLYPH)**;软档 20 颗/主题待 P2 | `scripts/ui/semanticcheck.py`(第 13 道常驻探针,八条判据 NAME/HOTSPOT/TAB/FOCUS/ARIA/LIVE/STATES/**GLYPH**,全部走 CDP 的 AX 树与真按键,不读源码字符串)、`UI规范.md` **§15.13**、本轮两处真缺陷修复 `pages/AssetLibrary.tsx:1217/1274/1359`(三颗裸 `Checkbox` 补 `aria-label`)、`styles/app.css:519`(`:has()` 补回被全局复位吃掉的上传按钮焦点环)、`scripts/ui/census-icons.py`(立项前只读普查,恒返回 0,不进串行) | NEX 08 只列要求、没给「怎么证明」,此前本项目也只在源码里数 `aria-*` 字符串——实测这种数法**两个真缺陷一个都抓不到**(D-A 旁边有文字、D-B 病灶在 CSS)。HEAD `5a10bfb` 同尺对照:改前硬档 **58 条**(NAME 20 / HOTSPOT 16 / TAB 16 / FOCUS 6,1440 与 430 两档读数相同)→ 工作树改后硬档 0;那 40 条 NAME 软档(20 每主题)不计退出码;剩下的软档 19 类同一根因:`ui/Fields.tsx::Field` 孤立使用 antd `Form.Item`(外层无 `<Form>`)⇒ `<label for>` 为空,属 P2 批量整改,默认不进退出码(`NEX_NAMESTRICT=1` 可升硬) |
|
||||
| §3 对比度 / 状态不只靠颜色 | COMPLIANT | `UI规范.md` §2.1(标签=点+文字,非仅颜色)、`Status` 文案来自 `lib/format.ts::statusLabel` | 状态一律「点 + 文字」双通道 |
|
||||
| §4 响应式(明确滚动容器) | COMPLIANT;侧栏 <768 **ADOPTED(阶段 8 · N7,见上 §8 行)** | `UI规范.md` §0 R13/R15、§6 外壳表;`LogBox`/`Drawer` 滚动容器在组件内 | 导航抽屉的滚动与焦点行为走 kit `Drawer`,页面侧没有新滚动容器 |
|
||||
| §5 内容与长文本(截断须给完整文案) | COMPLIANT(标签一处破口 **本轮阶段 1 修**) | `ui/Table.tsx::Clamp`、`min-w-0` 约定、`app.css:425-430`(`.nex-tag-text` 省略)| 分镜卡状态标签截断后**取不到完整文案**(缺 `title`)→ D1,阶段 1 修并补探针 |
|
||||
|
|
@ -283,6 +284,7 @@ cd frontend/src && grep -roh -- '--nex-[a-z0-9-]*' . | sort | uniq -c | sort -rn
|
|||
|
||||
| # | 漂移 | 现状 | 建议 |
|
||||
|---|---|---|---|
|
||||
| antd `InputNumber` 步进键念**英文**(`Increase Value`/`Decrease Value`,内部图标字形 `up`/`down`) | 全站 76 条读数(38/主题);宿主自带英文 `aria-label` ⇒ 念的是英文,**不是**字形码,所以不在 S-2 缺陷集内 | **不动**(阶段 8.5.1 · S-2 决策):要改得走 antd `ConfigProvider locale`,会连带换掉 `Pagination`/`Table`/`Empty`/`DatePicker` 的可见文字,代价远超 S-2 范畴 → 登记为 P2 独立任务 |
|
||||
| ~~R8 文档白名单口径~~ | ✅ **阶段 6 已解决(采纳 ①)** | 文档与探针原本各说各话:`UI规范.md` R8 只放行到 `app/layout/`,第 5 闸实际放行整个 `app/`(`app/App.tsx:21` 裸用 `Button/Layout`、`app/ErrorBoundary.tsx:17` 裸用 `Result/Typography`) | R8 改写为「`theme/` · **`app/` 整个外壳层** · `components/{ui,forms}`」并与 §15.1 同一口径。理由:外壳只此一份、不往 `pages/` 扩散,包一层只会多一个名字;真正要拦的是**页面** import 组件库。② 收紧探针被否——那会把 `App.tsx` 的首屏骨架与错误边界再包一层空壳 |
|
||||
| **CSS Layer 迁移(`.nex-*` 自绘表面)** | 未分层的 `.nex-*` 自绘皮肤与 `@layer` 壳并存,**形式上**不统一(同族组件有的走 utility、有的走皮肤类) | **DEFERRED(阶段 8.5 · 第 1 项决策)**:全站样式组织现状与层叠优先级设计已梳理并写进 `UI规范.md` **§1.1.2**(五层层叠 `index.css:50-57` + 未分层 `.nex-*` 皮肤 + `@theme` 令牌转发的既有次序),`app.css` 实测 839 行 / 189 条分支。**没有可复现缺陷**,只有「形式上不统一」 | 等出现第三例「utility 点不亮皮肤属性」类的真实冲突再迁;届时按 §1.1.2 记录的组织关系整族搬,不做半迁移(半迁移会让同族组件分居两层) |
|
||||
| kit 里两个 0 调用但**故意保留**的名字 | `ui/Page.tsx::Breadcrumb`(antd `Breadcrumb` 的薄封装)与 `ui/Controls.tsx`→`ui/Ctlbar.tsx::RadioGroup`(antd `Radio.Group` 封装)当前 0 处调用 | 阶段 6 决策:**不删**。`Breadcrumb` 是 NEX 04 §7 详情/层级导航的唯一落点,删了下次做层级页就得重造;`RadioGroup` 是 R19/§9 里「互斥选项」的唯一名字(分段切换用 `Segmented`,二选一互斥表单用 `RadioGroup`)。复核口径:下一个用到它的页面必须同时删掉本行;若连续两轮仍未被使用,转删除 |
|
||||
|
|
@ -311,6 +313,7 @@ cd frontend/src && grep -roh -- '--nex-[a-z0-9-]*' . | sort | uniq -c | sort -rn
|
|||
| 2026-11-07 | 阶段 5 定反馈预算(N10):`UI规范.md` §13.3 新增 ⑤「一次操作的反馈预算」(实测三页 notify 计数 + 每操作链颗数、两条预算、判据「吐司说成了,页面说成什么样」);`pages/ModelCenter.tsx` 的 `patchRow` 补一颗结果吐司(启用/停用/设为默认此前零反馈),`save`/`remove` 的页头 `Notice` 改 `notify({title,desc})` 并删除 `notice` state(页内 `Notice` 只留 `error` 与故障注入两处持续状态);`pages/project/Library.tsx` 5 处裸 `confirm()` → `await confirmAction({title,desc,tone,confirmIcon})`,`onRecord` / `recordGenerationReference` 经新增的 `speak`/`joinLines` 合成一颗;`lib/versions.ts::keepOrRestoreCurrent` 新增第三形参 `sink`(默认 `notify`,平台资产库两个调用点未改);`scripts/ui/classaudit.mjs` 第 6 闸正则从只匹配 `window.confirm(` 放宽为 `/(?<![\w.$])(?:window\.)?(?:confirm|alert)\s*\(/` 并写入十一例自查(阶段 5 曾把可选前缀写在 lookbehind 之前,导致 `window.confirm(` 反向漏检);`pages/Dashboard.tsx` 统计卡 `steps={[{at:'lg',cols:2}]}` 只改 xs 一档 | Codex(阶段 5) |
|
||||
| 2026-11-07 | 阶段 3 建立层级表:新增 `lib/layers.ts::LAYER`(header 20 / toolbar 40 / scrim 55 / sheet 60 / antd 1000 / preview 1020 / recorder 1030 / confirm 1190 / toast 1200),7 处浮层改为引用 `LAYER.*`(AppHeader 顶栏 / Page 粘性工具条 / Overlay 遮罩 / Storyboard 检查器 / MediaLightbox 灯箱 / RecordAudio 录音面板 / Confirm 确认框,`Overlay::Modal` 并新增可选 `zIndex` 形参),另有 2 条必须贴在 antd 节点上的 CSS 值(`app.css` 1100 / 1200)保持原数并加注释指回层级表;修掉两条**实测存在**的遮挡(抽屉里点开灯箱看不见、声线抽屉里录音面板点不着),并给确认框第一次显式层级以免灯箱抬升后压不住;`UI规范.md` §10 重写(层级表 + 修正过时的「挂载点」口径 + 两条「不进表」例外) | Codex(阶段 3) |
|
||||
| 2026-11-08 | 阶段 8.5 响应式 UX 与质量收口(七项):**①** CSS Layer 判 DEFERRED,只写 §1.1.2 的组织现状,不动代码;**②** 顶栏项目名补键盘通道(`app/layout/PipelineConsole.tsx` 受控 `Tooltip` + `:focus-visible`,改前缺的不是省略号而是「Tab 停上去读不到全名」);**③** 窄屏表格**九张**逐表改造(`components/ui/Table.tsx::useNarrowTable` + 各页窄档 `columns`,`tableaudit` 四档 EXIT=6 → 0,宽档 1440 输出逐字节相同);**④** 新增第 13 道常驻探针 `scripts/ui/semanticcheck.py`(语义与行为,七条判据)并修掉它查出的两处真缺陷(`AssetLibrary` 三颗裸 `Checkbox`、`app.css:519` 上传按钮焦点环),`gateprobe.py` 同步加 1 缺陷 + 2 合法夹具;**⑤** 导航两态判「保持分离」,理由写进 `UI规范.md` **§6.2.1**(`nex.sider.collapsed` 持久化 / `navOpen` 不持久化,两者是宽窄与开合两根正交轴);**⑥** UI chunk 只做分析与三变体实量,**业务代码零改动**(kit 深引 +0.02kB、Dashboard 深引字节完全相同 ⇒ rolldown 对 `export *` 桶引零成本;改 lazy 才省 2.3% 但要动已验证首屏);**⑦** N14 真读屏仍 **MANUAL QA REQUIRED**(见 §6 与 `UI规范.md` §G3)。NEX 侧本轮**未**改规范正文,新增待采纳项 **N17**(窄屏表格换列定义)登记在本表 §5 | Codex(阶段 8.5) |
|
||||
| 2026-11-08 | 阶段 8.5.1(**S-2 图标可访问名称**):`components/icons/index.ts` 79 条出口全部改走 `decorative(Glyph,'IconX')` 三档口径并新增 `IconClear`;4 处「图标是宿主唯一语义」显式具名(`ui/Input.tsx` 搜索 + 清空、`ui/Ctlbar.tsx::Pager` 上一页/下一页、`ui/Tabs.tsx` 更多页签、`forms/SecretInput.tsx` 显示/隐藏密码两态);`styles/app.css` 补 antd 搜索组合框 hover 的 `z-index`(加清空键后贴边才暴露);自动化:`classaudit` 第 2 闸加 `ICONA` 出口形状判据、`semanticcheck` 加第 8 条 `GLYPH`(+配对偶采集断言 `GLYPH-seen`)、`gateprobe` 加静态反例 `classaudit.GATE2-bad/good`(16 → **17 条判据**)、新增只读普查 `scripts/ui/census-icons.py`;`UI规范.md` §5.1.1 / §15.12 / §15.13 同步。读数:改前 900 只字形码对 AT 可见 / 42 只是宿主唯一语义 → 改后 **80 / 0**;120 张像素回归 38 张非零,逐条落在「同一份代码连跑两次」的噪声带内(10 张 ≤4 级抗锯齿抖动;其余为顶栏进度点 / 在线脉冲点 / 账号-用户页动态数据,噪声对照同帧同区域同样非零),S-2 未引入可见变化——证据 `reports/ui_evidence/nex-s2/PIXDIFF-120.txt` + `PIXDIFF-CLASSIFY.txt` | Codex(阶段 8.5.1) |
|
||||
| 2026-11-07 | 阶段 8·N16 断点治理:`classaudit.mjs` 新增**第 9 闸 BP**——以 `styles/index.css` 的 `--breakpoint-*` 为唯一真相,向「页面用词 / `UI规范.md` §4 登记表 / `visualcheck.py` 的 `BP`·`BPORDER` / `.css` 里的 `@media` 像素」四处对账(五条判据,含「登记尺子必须只有一个使用者」「探针表缺名会静默跳过断言」两条隐性失配);闸本身按 §15.1 口径反证过 10 例(`reports/ui_evidence/nex-p8/n16/scripts/gate_bp_proof.py`:写坏→红且点名→还原复绿);NEX 侧 `04-layout-system.md` 新增 §8.1 命名断点登记出口 / §8.2 专业工作区窄屏降级范式(子仓库提交,见实施报告 §2);`UI规范.md` §4 复核口径从「grep 必须为 0」改为机器闸、§15.1 闸表 8→9;`nex.config.yaml` 补 `breakpoints_registered` 与 9 道子闸注释 | Codex(阶段 8·N16) |
|
||||
| 2026-11-07 | 阶段 8·D16 修 `Tag` 吞 className:`components/ui/Status.tsx` 把 `className` 并进 `cn()` 末位(此前 10 处站点空转);顺带查实「utility 大面积失效」的两半真相——`index.css:55` 未层 `@import` 使 `.nex-tag.ant-tag` 独占 13 族属性 + `.ant-tag` 的 `transition: all .2s` 让改类后首帧读到起始值;`ModelCenter.tsx:973` 皮肤类改 `font-bold`、`Review.tsx:363` 改 `tone="mono"`、`Storyboard.tsx` 撤 flex-none wrapper、`PipelineConsole.tsx` wrapper 保留并注明只服务 display 族;`UI规范.md` 新增 §1.1.1(能力矩阵 + 200ms 坑);`classaudit.mjs` 新增第 8 闸 TAGSKIN;932 颗标签逐站点 diff,46 处差异全落在预期站点 | Codex(阶段 8·D16) |
|
||||
| 2026-11-07 | 阶段 8·N14 分镜排序的键盘替代:`pages/project/Storyboard.tsx` 的 `move()` 改为回传`Promise<boolean>`(越界 `false`,三个 `void move(...)` 调用点一字未改),新增 `moveByKey()` —— 越界时报「已经在第 N 位,无法继续前移/后移」、成功时报「已后移到第 M 位」并把焦点还给同一张卡(`refocusShotCard()`:rAF 最多 8 帧找回 `[data-shot-card]`,拿不到就不抢焦点,否则第二下按键没有落点);`ShotCard` 的 `onKeyDown` 先接 `Alt+↑/↓`(`preventDefault + stopPropagation`,卡片就在 window 那条「方向键切镜」监听的冒泡路径上,不拦会一次按键既移镜又切镜),window 侧同步加 `if (ev.altKey && Arrow) return` 兜底;可达性用 `aria-keyshortcuts="Alt+ArrowUp Alt+ArrowDown"` + 全站一份 `sr-only` 说明(`aria-describedby` 指过去),**不新增卡脚按钮**(224 档实测会劈行);`pages/Help.tsx` 快捷键清单与分镜步骤同步 `⌥↑` / `⌥↓`。口径落 `UI规范.md` §13.3 ⑤ 第 3 条(键盘路径必须播报、拖拽路径不播报的不对称)与 G3(热区不是按钮时快捷键挂在哪);NEX 侧 `08-accessibility-responsive.md` §2 新增「可排序列表必须提供键盘移动方式」(子仓库提交)。专项探针 `reports/ui_evidence/nex-p8/n14/scripts/sortcheck.py`:Light/Dark 各跑「顺序变了 / 焦点没丢 / 有播报 / 边界会说话 / 不 Alt 的方向键行为不变 / Enter 仍打开检查器」,PASS 0 条;对 HEAD 反证 FAIL 14 条 | Codex(阶段 8·N14) |
|
||||
|
|
|
|||
88
docs/UI规范.md
88
docs/UI规范.md
|
|
@ -496,14 +496,37 @@ antd 三档(24/32/40)套不进去的,才是自定义表面,允许裸元
|
|||
图标不写尺寸、不写颜色,继承按钮的 `font-size` / `color`。
|
||||
- 这条有闸:`/tmp` 侧的 inv 探针列出「Button 无 icon」清单,
|
||||
剩下的每一处都必须是**刻意**的文字链(`TextLink`)或分段开关项。
|
||||
- **在册待办(阶段 8.5 真机读屏发现 · AT-1)**:图标自己会报名字。`@ant-design/icons`
|
||||
每个图标渲染成 `<span role=img aria-label=字形名>`,于是 VoiceOver 读出来的是
|
||||
- **图标不许替控件报名字(AT-1 → S-2 已修,2026-11-08 单独一轮)**:`@ant-design/icons`
|
||||
每只字形渲染成 `<span role=img aria-label=字形名>`,于是 VoiceOver 念出来的是
|
||||
「upload 导入脚本」「down 导出」「appstore 看板」「ordered-list 分镜表」「book 手册」——
|
||||
按钮文字已经在外面,等于**同一个控件被报两遍**,前半截还是英文码。
|
||||
控件已有可读名称时图标是纯装饰,正解是 `aria-hidden`(`components/icons/index.ts` 一处收口)。
|
||||
这条会同时改动 14 条路由的可读名称,**必须单独一轮 + 单独 AT 复测**,
|
||||
不许塞进任何视觉轮次里顺手做。取证:
|
||||
`reports/ui_evidence/nex-p8f/07-screen-reader/voiceover-announcements-2026-11-08.txt`。
|
||||
按钮文字已经在外面,等于**同一个控件被报两遍**,前半截还是用户从没见过的英文码。
|
||||
改法只有一处:**登记表 79 条出口全部套 `decorative()`**(`components/icons/index.ts`)。
|
||||
一句话口径——**图标默认是装饰,语义由它所在的控件说**,三档:
|
||||
① 默认 `aria-hidden="true"` 且不写名(79 条出口的默认行为);
|
||||
② 调用方显式给非空 `aria-label` → 这只图标**自己承担语义**(它后面没有文字),
|
||||
保留 `role=img` 用给定的名字,不隐藏;③ 显式写 `aria-hidden={false}` → 尊重调用方。
|
||||
两头都不许一刀切:**批量 `aria-hidden`** 会把第 ② 档那四处(页签溢出的「更多页签」、搜索框的
|
||||
「清空搜索」、密码框的「显示 / 隐藏密码」两态)藏成无名控件;**批量具名**则在宿主已有名字时
|
||||
又报一遍。第 ② 档全站就这四只出口,其余一律第 ① 档。改动只碰 aria 属性:DOM 结构、类名、尺寸、
|
||||
颜色、`.anticon` 选择器(`app.css:564`)一字不变,**R15 不受影响**——那颗闸看的是源码里
|
||||
有没有 `icon={<IconXxx />}` 这个槽,包一层不改判据。两道闸钉住它:
|
||||
`classaudit` 第 2 闸逐行核对出口形状(裸 re-export / 直接赋值 / 换名再导出 三种绕法都红),
|
||||
`semanticcheck` 第 8 条 `GLYPH` 在 DOM 上认「`aria-label` 等于自己的类名后缀 `anticon-<码>`」;
|
||||
两条的反例都由 `gateprobe` 注入(§15.12)。
|
||||
- **antd 在内部自绘的图形绕不过登记表**,但只处理「**图标就是宿主唯一的名称来源**」那几只,
|
||||
各给一句自然中文,全部在 kit 一处收口、页面 0 改动:`Tabs` 的 `more={{icon}}` → 更多页签、
|
||||
`Input.Password` 的 `iconRender` → 显示 / 隐藏密码(复用旁边那句三态 hint,
|
||||
和 `Tabs` 那处同理:`MoreProps` 只有 `icon`、密码眼睛是 antd 自己的 `<span>`,
|
||||
**宿主不是我们的元素,名字只能挂在图标上**——这两处的 `aria-label` 删掉,控件就又没名字了)、
|
||||
`Pagination` 的 `itemRender` → 上一页 / 下一页、`Input.Search` 的 `allowClear.clearIcon`
|
||||
+ `enterButton` → 清空搜索 / 搜索。剩下两类 antd 内部图形**不动**,理由不一样:
|
||||
`Select` / `Dropdown` / `Collapse` 的下拉箭头本来就被 antd 包在 `aria-hidden="true"` 里
|
||||
(实测 68 只,辅助技术根本看不见,无需处理);`InputNumber` 上下键的宿主自带 antd 硬编码的
|
||||
英文 `aria-label`(`Increase Value` / `Decrease Value`,zh_CN locale 也没翻),字形名进不了
|
||||
可读名称、但会念英文——真要改得动 antd 内部 DOM 或全站 locale(locale 会连 Pagination /
|
||||
Table / Empty 的可见文字一起改),为几个英文码不值,已记 `docs/NEX-对照与例外.md` §6 一条
|
||||
漂移(P2)。分页箭头的字形节点也还在(被「上一页 / 下一页」遮蔽),同属这一类。
|
||||
逐处取证与前后对照:`reports/NEX阶段8.5.1-S-2图标可访问名称-2026-11-08.md`。
|
||||
|
||||
### 5.1.2 关键动作才有重点色
|
||||
|
||||
|
|
@ -2396,18 +2419,21 @@ provider 漏渲染、store 被引成第二份实例,都会让 `notify()` 静
|
|||
道理和 `btnrowcheck` 的 `GROUPS 413 / TOTAL 0` 是同一条:**覆盖面是分子非零的前提,违规是判据**。
|
||||
反向验证见 §15.12 的 `pb-cluster`(260 内宽三颗 120px → 2+1 必须响)/ `pg-cluster`(三颗满宽换行必须静)。
|
||||
|
||||
### 15.12 `.venv/bin/python scripts/ui/gateprobe.py` —— 反向验证八张闸门的十四条判据(七张像素闸 + 语义三条)
|
||||
### 15.12 `.venv/bin/python scripts/ui/gateprobe.py` —— 反向验证九张闸门的十七条判据(七张像素闸 + 语义五条 + 静态一条)
|
||||
|
||||
第 30 轮立项、第 14 轮补齐到 **6/6**、第 16 轮补 `tagcheck.SPILL` 到 **7/7**、
|
||||
第 17 轮补 `btnrowcheck.HEAD` 到 **8/8**、
|
||||
第 17 轮(续)补 `btnrowcheck.exempt` 到 **9/9**、补 `footercheck` 到 **10/10**、
|
||||
补 `btnclustercheck` 到 **11/11**、
|
||||
第 8.5 轮(2026-11-08)把语义那一族一次补到 **14/14**(`HOTSPOT` 候选 / `HOTSPOT-hard` 分档 / `TABTARGET` 走位清单):
|
||||
第 8.5 轮(2026-11-08)把语义那一族补到 **14/14**(`HOTSPOT` 候选 / `HOTSPOT-hard` 分档 / `TABTARGET` 走位清单)、
|
||||
第 8.5.1 轮(同日 · S-2)再补三条到 **17/17**(`GLYPH` 外泄清单 / `GLYPH-seen` 采集面 / `classaudit.GATE2-*` 静态出口形状):
|
||||
`gridcheck` / `rhythmcheck` / `tagcheck` / `btnrowcheck` / `footercheck` / `btnclustercheck` /
|
||||
`tableaudit` 判的是像素,`semanticcheck` 判的是辅助技术读得到的语义——
|
||||
**它们自己也需要被体检**:豁免写宽一格,闸门就会永远安静地返回 0。
|
||||
它不碰源码、不触发 HMR,直接在 `/assets` 上种成对的 fixture:`pb-*`(坏)必须被对应闸门点名,
|
||||
`pg-*`(好)必须放行。十四个判据条目、44 条断言(每条至少一坏一好,合法形态可以多块):
|
||||
`pg-*`(好)必须放行。十七个判据条目、57 条断言(每条至少一坏一好,合法形态可以多块)。
|
||||
最后一条 `classaudit.GATE2-*` 是**静态**的:页面是活的、临时源码树是死的,所以它不吃 fixture
|
||||
(§15.12 末尾那段)。十六条页面判据、52 条断言,加静态一条 / 5 条断言:
|
||||
|
||||
| 闸门条目 | `pb-*`:必须响 | `pg-*` / 其他必须放行 |
|
||||
|---|---|---|
|
||||
|
|
@ -2425,9 +2451,12 @@ provider 漏渲染、store 被引成第二份实例,都会让 `notify()` 静
|
|||
| `semanticcheck.HOTSPOT` | `div[role=button]` + `cursor:pointer`、**没给 `tabindex`**(`pb-sema`)与带 `data-clickable` 却没键盘路径的可点行(`pb-semb`)——正是阶段 2 修掉的那三类鼠标热区的形状 | 补了 `tabindex="0"` 的自定义控件(`pg-sema`)、原生 `<button>`(`pg-semb`)、热区里那颗 pointer 图标(`pg-semc`)、行里已有按钮的可点行(`pg-semd`)、antd v5 的图标根节点 `span.anticon.anticon-*`(`pg-simg`,**连候选都不该进**)——证明这条不是「见 `div` 就咬」,也不会把 antd 自己的 DOM 当成我们的契约 |
|
||||
| `semanticcheck.HOTSPOT-hard` | 同一对 `pb-sema` / `pb-semb`:它们是「我们自己承诺过键盘可达」的那一档,必须落在**硬档**(进退出码) | 自绘的 `role=img`(`pg-semf`):HOTSPOT 的承诺只对**交互角色**成立,`img` 只是语义标注,要求它自己有 Tab 序列是判据越界(实测每主题 5 条纯噪声)——它该进候选,但不该进硬档 |
|
||||
| `semanticcheck.TABTARGET` | 我们自己写的 `role=tab`(`pb-semt`)必须出现在走位清单里,否则 TAB 判据永远查不到它(判据瞎) | antd 自己的页签 `.ant-tabs-tab-btn`(`pg-semt`)必须**不在**清单里:那是 rc-tabs 的 DOM,`tabindex` 归 antd 管(实测每主题 3 条假阳性) |
|
||||
| `semanticcheck.GLYPH` | 一颗 `<button>` 里只装了 `aria-label=upload` 的图标(`pb-glyph`)——**图标是宿主唯一的名称来源**,读屏念的就是那串英文码,正是 S-2 修的那一族 | ① 同一只图标、宿主自己写了 `aria-label`(`pg-glyph`):名称被接管,字形码进不去;② `aria-hidden=true`(`pg-glyph2`,登记表的默认修法);③ 图标自己拿中文名「清空搜索」(`pg-glyph3`,第 ② 档)——后两种**连候选都不许进** |
|
||||
| `semanticcheck.GLYPH-seen` | 同上:`pb-glyph` 必须被采到 | `pg-glyph` 也必须**被采到**(判为「遮蔽」不等于没看见)。没有这一条,上面那条的「`pg-glyph` 必须放行」是空转——没采到与采到但遮蔽,在串里长得一模一样 |
|
||||
| `classaudit.GATE2-*`(静态) | 把真登记表抄进临时目录、改出三种绕过 `decorative()` 的写法(裸 `export {UploadOutlined}` / 直接赋值 / `decorative()` 别名与出口名不符),再加一处绕过登记表 import 字形:四条必须**逐条点名** | 真登记表必须**全程静音**(否则这条闸恒红,改不动任何图标)。锚点在登记表里找不到时脚本直接停——不许悄悄退化成恒真 |
|
||||
|
||||
任一条对不上退出码 1(“闸门瞎了或过敏,先修闸门再谈页面”),最后一行必须打出
|
||||
`GATEPROBE_OK 14/14`(14 = 判据条目数,既不是断言数也不是 fixture 种数——同一块夹具会被几条判据分别评)。
|
||||
`GATEPROBE_OK 17/17`(17 = 判据条目数,既不是断言数也不是 fixture 种数——同一块夹具会被几条判据分别评)。
|
||||
**改动这些闸的判据或豁免时必须跑它**:
|
||||
`ctl` 与 `spill` 两条就是靠 `pb-ctl` / `pb-tspill` 证明「坏了会响」之后才当退出条件用的;
|
||||
反过来 `pg-ctl` / `pg-tspill` 挡的是另一种失败——判据太敏感,把合法布局也报成缺陷。
|
||||
|
|
@ -2463,7 +2492,10 @@ antd 的页签混进来 = 每次都误报。
|
|||
`COLLECT` 三遍——第二遍每个热区都被自己上一遍盖的章吃掉,硬档清单恒为空。
|
||||
**教训:反向验证的夹具会被重复评,所以采集必须是可重入的**;
|
||||
现在 `COLLECT` 进来先把上一轮的 `data-nex-hotspot` 摘干净。
|
||||
2026-11-03 实测 **`GATEPROBE_OK 11/11`**、2026-11-08 补语义三条之后 **`GATEPROBE_OK 14/14`**(见 §15.13)。
|
||||
2026-11-03 实测 **`GATEPROBE_OK 11/11`**、2026-11-08 补语义三条之后 **`GATEPROBE_OK 14/14`**、
|
||||
同日 S-2 再补字形名三条之后 **`GATEPROBE_OK 17/17`**(见 §15.13)。
|
||||
`GLYPH-seen` 那条是这一轮新学的一课:一条「必须放行」的断言,如果采集面本身瞎了,它也永远绿——
|
||||
所以凡是「闸门不报」型的期望,都要配一条「同一个夹具必须被采到」的对偶断言。
|
||||
|
||||
### 15.13 `.venv/bin/python scripts/ui/semanticcheck.py` —— 用语义与行为量「说不出口」的缺陷
|
||||
|
||||
|
|
@ -2475,8 +2507,12 @@ antd 的页签混进来 = 每次都误报。
|
|||
|
||||
**它读的是浏览器真给 AT 的那份数据**:CDP `Accessibility.getFullAXTree`(角色 + 计算后的
|
||||
可访问名称,不是 JSX 属性)、`getComputedStyle`(焦点环),加真键盘(Tab / Space / Escape)
|
||||
与真鼠标(hover 唤出懒挂载的描述)。七条判据 `NAME / HOTSPOT / TAB / FOCUS / ARIA / LIVE / STATES`
|
||||
口径逐条写在脚本 docstring,退出码 = offender 条数。默认 12 条路由(含 `/403` 与一条不存在的
|
||||
与真鼠标(hover 唤出懒挂载的描述)。八条判据 `NAME / HOTSPOT / TAB / FOCUS / ARIA / LIVE / GLYPH / STATES`
|
||||
口径逐条写在脚本 docstring,退出码 = offender 条数。`GLYPH`(S-2 · 2026-11-08)查的是
|
||||
**NAME 查不出来的那一种**:可访问名称**非空**,只是空话——图标自带的英文字形码
|
||||
(`aria-label` 等于自己的类名后缀 `anticon-<码>`)拼进了控件名称。三档:宿主自己带名 = 遮蔽(只计数)、
|
||||
宿主靠 contents 算名 = 立案、控件之外的独立语义位(标签图标 / 状态点)只打印位置;
|
||||
另有一条只打印的交叉核对:拿 CDP AX 树里 AT 真读到的名称去撞登记表解析出的 78 个字形码。默认 12 条路由(含 `/403` 与一条不存在的
|
||||
路由)× 明暗两色 × 1440;`NEX_WIDTH=430` 再跑一遍——汉堡按钮 `aria-expanded` 随抽屉翻转、
|
||||
Esc 关得掉,这条只有窄屏才走得到。
|
||||
|
||||
|
|
@ -2502,7 +2538,24 @@ Tab 走位时在基线快照之后才长出来的元素(浮层里的)记为
|
|||
于是这条一定被当成噪音关掉;反过来 CSS 里一句 `outline:none` 吃环,源码里根本找不到那行。
|
||||
|
||||
用法与其余口径见 `scripts/ui/semanticcheck.py` docstring。反向验证在 §15.12 的
|
||||
`semanticcheck.HOTSPOT` / `HOTSPOT-hard` / `TABTARGET` 三条。
|
||||
`semanticcheck.HOTSPOT` / `HOTSPOT-hard` / `TABTARGET` / `GLYPH` / `GLYPH-seen` 五条
|
||||
(外加静态的 `classaudit.GATE2-*` 一条,钉的是登记表出口形状)。
|
||||
**GLYPH 立项前先量了一次全站现状**(脚本 `census-icons`,1 072 只图标读数 × 明暗两色):
|
||||
改前 **900 只**图标把自己的字形码念给辅助技术,其中 **584 只**所在宿主连一句显式
|
||||
`aria-label` 都没有、**42 只**是宿主唯一的名称来源(16 清空键 + 16 搜索按钮 + 6 页签溢出 + 4 分页箭头)——
|
||||
「upload 导入脚本」不是个别按钮的毛病,是全站默认行为。
|
||||
> 那 6 只「页签溢出」要打个星号:普查脚本原来只量包围盒,而 rc-tabs 在不溢出的时候是用
|
||||
> `visibility:hidden` 藏那颗「…」的,**包围盒有值、读屏念不到**。按 AT 可读口径重数 = 36 只。
|
||||
> 真正的溢出只出现在窄视口:`/models` 600 与 430、`/projects/13/library` 430 三处
|
||||
> (`reports/ui_evidence/nex-s2/PROBE3.txt`:`pw可见=True`、CDP AX `更多页签=1`,
|
||||
> Enter 与鼠标点击都打得开菜单)。所以「更多页签」这个名字不是纯防御性的,窄屏真的会念到。
|
||||
> 脚本已补 `vis` 字段,两条口径分开打印;常驻闸 `semanticcheck` 从第一条判据起就用
|
||||
> `visibility` 判可见(`semanticcheck.py:227`),没中过这个招。
|
||||
改后剩 **80 只**可见(包围盒与 AT 可读两条口径同为 80:这 80 只都在真正可见的位置)、
|
||||
「图标是宿主唯一语义」**0 只**:剩下 80 只全是 antd 内部图形(`InputNumber` 上下键 76 + `Pagination` 箭头 4),
|
||||
宿主自己带名称,念不到字形码;`InputNumber` 宿主念英文(`Increase Value`)另记一条漂移。
|
||||
取证:`reports/ui_evidence/nex-s2/CENSUS-FINAL.txt` / `CENSUS-FINAL2.txt` / `CENSUS-FINAL3.txt`(收口复跑)
|
||||
/ `CENSUS-FINAL4.txt`(补 `vis` 之后复跑:80 / 80 / B 组 0,与前面三条一致)。
|
||||
|
||||
**新增判据的准入条件**(本轮血的教训换来的规矩):一条判据「读数全 0」有两种可能——页面真的干净,
|
||||
或者**候选集是空的**,这两种在输出里长得一模一样。所以任何一条判据要进常驻串行,必须先在
|
||||
|
|
@ -2601,10 +2654,11 @@ Esc 关得掉,两个主题 × 12 条路由全部为 0 条违规。
|
|||
按路线扫页面的那几张探针结构上覆盖不到它(§15.10);
|
||||
`btnclustercheck` 抛开类名,直接量**任何**父元素下相邻兄弟按钮的垂直中心(§15.11)——
|
||||
页面自己 `flex flex-wrap` 摆两颗按钮、忘了套 `ActionGroup` 这一族,前两道按钮闸都看不见它。
|
||||
改过这**八道**闸的任何一条判据或豁免(含 `tableaudit` 的 `spill`),必须跑 `scripts/ui/gateprobe.py`(§15.12)——
|
||||
改过这**九道**闸(八道 + 静态的 `classaudit` 第 2 闸)的任何一条判据或豁免(含 `tableaudit` 的 `spill`),
|
||||
必须跑 `scripts/ui/gateprobe.py`(§15.12)——
|
||||
豁免写宽一格,闸门就永远安静地返回 0;判据太敏感,合法布局会被整片误报;
|
||||
判据压根扫不到那一族 DOM,则全绿只是沉默(`pb-footer` 钉的就是这一种)。
|
||||
(`gateprobe` 当前覆盖七张像素闸 + `semanticcheck` 的三条语义判据共十四条(末行 `GATEPROBE_OK 14/14` 数的就是判据条数,不是 fixture 数);`aligncheck` / `symmetrycheck` 那几把尺的反向验证按 §15.8 的做法各自手工做一次。)
|
||||
(`gateprobe` 当前覆盖七张像素闸 + `semanticcheck` 的五条语义判据 + `classaudit` 的一条静态判据共十七条(末行 `GATEPROBE_OK 17/17` 数的就是判据条数,不是 fixture 数);`aligncheck` / `symmetrycheck` 那几把尺的反向验证按 §15.8 的做法各自手工做一次。)
|
||||
**动过可点击元素的语义、焦点或 aria 声明**(补 `tabIndex`、改 `role`、写 `aria-expanded` /
|
||||
`aria-describedby` / `aria-controls`、给省略号加 `title`)另跑 `scripts/ui/semanticcheck.py`(§15.13)
|
||||
明暗两色 + 1440 与 430 各一遍:它量的那一层——辅助技术实际读到的名称、Tab 实际能不能停住、
|
||||
|
|
|
|||
|
|
@ -100,7 +100,7 @@ frontend:
|
|||
verification:
|
||||
npm_scripts: [dev, build, typecheck, preview]
|
||||
ui_gates:
|
||||
- node scripts/ui/classaudit.mjs # 静态:9 道子闸(死类名/图标/裸 button/浮层底部/antd import/反馈表面/标题图形/标签皮肤/断点对账)
|
||||
- node scripts/ui/classaudit.mjs # 静态:9 道子闸(死类名/图标 import + 出口形状 ICONA/裸 button/浮层底部/antd import/反馈表面/标题图形/标签皮肤/断点对账)
|
||||
- .venv/bin/python scripts/ui/visualcheck.py
|
||||
- .venv/bin/python scripts/ui/tableaudit.py
|
||||
- .venv/bin/python scripts/ui/gridcheck.py
|
||||
|
|
@ -112,8 +112,9 @@ frontend:
|
|||
- .venv/bin/python scripts/ui/footercheck.py
|
||||
- .venv/bin/python scripts/ui/btnclustercheck.py
|
||||
- .venv/bin/python scripts/ui/feedbackcheck.py
|
||||
- .venv/bin/python scripts/ui/semanticcheck.py # 阶段 8.5 第 4 项:辅助技术语义与行为(AX 名称/热区/Tab/焦点环/ARIA/live/六态)
|
||||
- .venv/bin/python scripts/ui/gateprobe.py # 反向验证:证明闸门真的会红
|
||||
- .venv/bin/python scripts/ui/semanticcheck.py # 阶段 8.5 第 4 项:辅助技术语义与行为(AX 名称/热区/Tab/焦点环/ARIA/live/六态/字形名外泄 GLYPH)
|
||||
- .venv/bin/python scripts/ui/gateprobe.py # 反向验证:证明闸门真的会红(17 条判据 = 16 页面 + 1 静态)
|
||||
# 只读普查,不进串行、无退出码:scripts/ui/census-icons.py(图标字形名现状量级,S-2 立项与收口对账用)
|
||||
baseline: 14 路由 × {1440,768,430} × {light,dark} = 84 个状态
|
||||
flow: docs/UI规范.md §16(十二步改动流程,改尺子必须全量回归含 430/576)
|
||||
dev_base_url: http://127.0.0.1:5199 # :5173 是陈旧实例;:8000 被别的项目占用
|
||||
|
|
|
|||
|
|
@ -0,0 +1,522 @@
|
|||
# NEX Design System · 阶段 8.5.1 实施报告(S-2 · 图标可访问名称)
|
||||
|
||||
- 仓库:`/Users/jiliu/工作/projects/nex_animation` 分支 `main` 基线提交 `5a10bfb`(上一轮收口在 `bc68081`)
|
||||
- 授权范围:**只做 S-2**(阶段 8.5 未解决清单里那一行 / AT-1 缺陷),完成后暂停,不自动开始 S-3、T-1、Bundle 优化
|
||||
- 被测代码:工作树(dev `http://127.0.0.1:5199`);最终产物 `dist`(preview `:4173`)
|
||||
- 日期:2026-11-08
|
||||
|
||||
---
|
||||
|
||||
## 0. 结论摘要
|
||||
|
||||
**做了一件事**:把「图标自己替控件报名字」这条全站默认行为关掉。`@ant-design/icons` 的每只字形都自带
|
||||
`role=img` + `aria-label=<英文字形码>`,它挂在已经有文字的按钮里,VoiceOver 就念成
|
||||
`upload 导入脚本`、`down 导出`、`appstore 看板`、`search 图像`——同一个控件被报两遍,前半截还是用户从没见过的码。
|
||||
|
||||
| 口径 | 改前 | 改后 | 量法 |
|
||||
|---|---|---|---|
|
||||
| 字形码对辅助技术可见的图标 ※ | **900** 只 | **80** 只 | `scripts/ui/census-icons.py`,15 路由 × 明暗 = 1 072 条图标读数 |
|
||||
| 其中「图标是宿主**唯一**名称来源」 ※ | **42** 只 | **0** 只 | 同上 B 组(宿主既无 `aria-label` 也无 `title`、又无文字) |
|
||||
| 宿主完全没有显式 `aria-label` | **584** 只 | 0 | 同上 |
|
||||
| CDP AX 树里名称含字形码的节点 | **261** 条 | **1** 条(假阳性:`/api/meta` 这条链接正文里真写着 `api`) | `Accessibility.getFullAXTree`(656 节点)× 明暗 × 1440/430;那 1 条节点里没有 `.anticon`,见 §4.4 |
|
||||
| `semanticcheck.GLYPH` 外泄(常驻第 8 条) | —— | **0**(遮蔽 72 / 无宿主 0) | 12 路由 × 明暗 × 1440 与 430 |
|
||||
| VoiceOver + Safari 18.3 实听 | `upload 导入脚本` 等 6 处 | 见 §7 | 系统日志实录 |
|
||||
|
||||
> ※ 这两个数是 census 的**包围盒口径**。同一批数据按「AT 可读」口径(再排除计算后 `visibility:hidden`)是 **894 / 36**——
|
||||
> 差的就是那 6 只在 1440 下隐藏的页签「…」`ellipsis`(3 条路由 × 明暗),它们同时从 A 组扣 6、从 B 组扣 6 条 / 3 种。
|
||||
> `census-icons.BEFORE.json` 生成时还没有 `vis` 字段,894 / 36 是按 `PROBE3` 的 36 组可见性扫描另算的,不是重跑这份 JSON 得来的。
|
||||
> 引用时必须带口径,详见 §4.4 与 §6-U5。
|
||||
|
||||
- **剩下的 80 只全是 antd 在内部自绘的图形**(`InputNumber` 上下键 76 + `Pagination` 箭头 4),
|
||||
它们的宿主自己带名,字形名进不了可读名称;要连节点名一起消掉得改 antd 内部 DOM,记为漂移不处理(§6)。
|
||||
- **没有批量 `aria-hidden`**:三档口径(默认装饰 / 显式具名 / 显式放行),第 ② 档全站只有 4 处,
|
||||
原本就写着 `aria-hidden` 的 4 处调用点照旧尊重。
|
||||
- **零视觉改动**:120 张像素回归逐张比对,38 张非零——**同一份代码连跑两次的噪声对照里非零 33 张**,
|
||||
38 张里 10 张是 ≤4 级抗锯齿抖动、其余差异框与噪声同帧同区域,只有 2 张需要看图定性
|
||||
(顶栏阶段进度点与「在线」脉冲点,两块在噪声对照里同样非零)——见 §5.2。DOM 结构、类名、尺寸、颜色一字不变,
|
||||
唯一一处 CSS(搜索框悬停 `z-index`)是补回 antd 因传 `enterButton` 元素而降掉的层级,像素与改前一致。
|
||||
- **防复发**:两道闸 + 一份反向验证——`classaudit` 第 2 闸钉死「出口必须走 `decorative()`」
|
||||
(源码侧)、`semanticcheck.GLYPH` 在 DOM 上认字形码外泄(行为侧)、`gateprobe` 注入反例证明两条都会红。
|
||||
`GATEPROBE_OK 17/17`。
|
||||
|
||||
- **读屏验收的边界(先说在前)**:VoiceOver + Safari 18.3 真机实听只覆盖到 **8 处修复 + 10 组对照**,
|
||||
分页两颗 / 清空键 / 密码眼睛 / 窄视口「更多页签」这 4 处以及 **NVDA + Chrome 全家未执行**——
|
||||
**MANUAL QA REQUIRED,S-2 的读屏验收不能标记为完全通过**(§7、§6-U6)。
|
||||
|
||||
---
|
||||
|
||||
## 1. S-2 到底是什么问题:名称从哪儿来的
|
||||
|
||||
一个控件的可读名称按「作者给的 → 内容算出来的」顺序计算。antd 的图标是
|
||||
`<span role="img" class="anticon anticon-upload" aria-label="upload">`,于是:
|
||||
|
||||
| 宿主情形 | 名称怎么算 | 结果 |
|
||||
|---|---|---|
|
||||
| `<Button icon={<IconUpload/>}>导入脚本</Button>` | 作者没给名 → contents = 图标名 + 文字 | `upload 导入脚本` ❌ |
|
||||
| `<Segmented options={[{icon,label:'看板'}]}/>` | 同上 | `appstore 看板` ❌ |
|
||||
| `<Input.Search enterButton>`(antd 内部自绘那颗按钮) | 只有图标 → contents = 图标名 | `search` ❌ |
|
||||
| `<InputNumber>` 上下键 | antd 给宿主写了 `aria-label="Increase Value"` | 名称对,图标节点多一个 `up` ⚠ |
|
||||
| `<Select>` 下拉箭头 | antd 把箭头包在 `aria-hidden="true"` 里 | AT 看不见 ✅ |
|
||||
|
||||
所以缺陷**不在**「图标有名」,而在**「宿主靠 contents 算名时,图标抢着报名字」**。
|
||||
这决定了改法不能一刀切:
|
||||
|
||||
- 批量 `aria-hidden` → 上面第 3 行那 42 处「图标是宿主唯一名称来源」会变成**没有名字的控件**(更糟);
|
||||
- 批量具名 → 第 1、2 行变成「导入脚本 导入脚本」(同一个控件报两遍)。
|
||||
|
||||
`semanticcheck` 原来的 `NAME` 判据看不见这种缺陷:名称**非空**,只是空话。上一轮是**真机 VoiceOver** 才发现的
|
||||
(`reports/ui_evidence/nex-p8f/07-screen-reader/README.md` V7/V8/V11)。
|
||||
|
||||
---
|
||||
|
||||
## 2. 改法:一处收口 + 三档口径
|
||||
|
||||
### 2.1 登记表出口全部套 `decorative()`(`frontend/src/components/icons/index.ts`)
|
||||
|
||||
全站图标只有这一个出口(`classaudit` 第 2 闸的 `ICON` 条本来就禁止别处 `import '@ant-design/icons'`),
|
||||
所以 79 条出口改成 `export const IconX = decorative(Glyph, 'IconX')` 就覆盖了整站:
|
||||
|
||||
```ts
|
||||
function decorative(Glyph: ComponentType<IconProps>, alias: string) {
|
||||
const Icon = forwardRef<HTMLSpanElement, IconProps>(function IconDecorative(props, ref) {
|
||||
const { 'aria-hidden': ariaHidden, 'aria-label': ariaLabel, ...rest } = props
|
||||
const named = typeof ariaLabel === 'string' && ariaLabel.trim() !== ''
|
||||
return createElement(Glyph, { ...rest, ref,
|
||||
'aria-label': named ? ariaLabel : undefined,
|
||||
'aria-hidden': named ? (ariaHidden ?? false) : (ariaHidden ?? true) })
|
||||
})
|
||||
Icon.displayName = alias
|
||||
return Icon
|
||||
}
|
||||
```
|
||||
|
||||
三档口径(登记表顶部新增为**规则 5**,写进 `docs/UI规范.md` §5.1.1):
|
||||
|
||||
| 档 | 触发 | 行为 | 用了几处 |
|
||||
|---|---|---|---|
|
||||
| ① 默认 | 调用方不写 aria | `aria-hidden="true"`,不写名 → 纯装饰,语义由控件说 | 75 条出口的全部默认调用点 |
|
||||
| ② 具名 | 调用方显式给非空 `aria-label` | 保留 `role=img` 用给定的名字,不隐藏 | **全站 4 处**(§2.2) |
|
||||
| ③ 放行 | 调用方显式 `aria-hidden={false}` | 完全尊重调用方 | 0 处调用点写,4 处调用点自己写了 `aria-hidden="true"`(照旧生效) |
|
||||
|
||||
**为什么不会改变视觉**:`decorative()` 只是转发 props,渲染出来的还是同一只 `span.anticon` 加同一份 svg,
|
||||
没有多包一层元素。`visualcheck` / `semanticcheck` 按 `.anticon` 类名判别(`visualcheck.py:178-182`、
|
||||
`semanticcheck.py:202-207`),`app.css:564` 的 `.anticon` 尺寸规则也照旧命中。
|
||||
登记表是 `.ts`,所以用 `createElement` 而不是 `<Glyph />`——这点在函数上方注释里写明了,
|
||||
避免下一位改成 JSX 时被「为什么不用尖括号」绊住。
|
||||
|
||||
### 2.2 图标就是控件全部语义的 4 处:给自然中文名字
|
||||
|
||||
这 4 处的图形由 **antd 在内部**渲染,绕不过登记表,各走 antd 自己开的正门,全部落在 kit 层、**页面 0 改动**:
|
||||
|
||||
| 位置 | 改前 AT 名称 | 改后 | 入口 | 文件 |
|
||||
|---|---|---|---|---|
|
||||
| 搜索框尾部那颗放大镜按钮 | `search` | **搜索** | `enterButton={<Button icon={<IconSearch/>} aria-label="搜索" disabled loading/>}` | `components/ui/Input.tsx:123-127` |
|
||||
| 搜索框一键清空 | `close-circle` | **清空搜索** | `allowClear={{ clearIcon: <IconClear aria-label="清空搜索"/> }}` | `components/ui/Input.tsx:124` |
|
||||
| 页签溢出菜单「…」 | `ellipsis` | **更多页签** | `more={{ icon: <IconMore aria-label="更多页签"/> }}`(`MoreProps` 只有 `icon` 一条,名字只能挂图标上) | `components/ui/Tabs.tsx:50` |
|
||||
| 密码框显示 / 隐藏 | `eye` / `eye-invisible` | **显示密码 / 隐藏密码**(复用旁边已有的三态 hint) | `iconRender` | `components/forms/SecretInput.tsx:109-111` |
|
||||
| 分页上一页 / 下一页 | `left` / `right` | **上一页 / 下一页** | `itemRender` + `cloneElement`(类名、皮肤、禁用逻辑不动) | `components/ui/Ctlbar.tsx:360-364,381` |
|
||||
|
||||
(严格说是 5 个入口、4 类控件:搜索那颗同时占了「按钮」和「清空」两处。)
|
||||
|
||||
覆盖到的调用面:`SearchInput` 全站 9 处(`Dashboard`×3 / `AssetLibrary` / `ModelCenter` / `Library` /
|
||||
`Overview` / `Storyboard` / `UserAdmin`)、`Pager` 是全站**唯一**的 `<Pagination>` 出口、
|
||||
`SecretInput` 用于 `Login` / `UserAdmin`×2 / `Account`、`Tabs` 覆盖全部带页签的页面。
|
||||
|
||||
`SearchInput` 里 `{...props}` 仍然排在后面,页面要覆盖 `allowClear` / `enterButton` 的话优先——
|
||||
实测 9 处调用点**没有一处**覆盖,所以收口是完整的。
|
||||
|
||||
### 2.3 明确不动的两类 antd 内部图形
|
||||
|
||||
| 图形 | 实测 | 为什么不动 |
|
||||
|---|---|---|
|
||||
| `Select` / `Dropdown` / `Collapse` 的下拉箭头 | 68 只,全在 `aria-hidden="true"` 的祖先里 | antd 自己就藏了,AT 根本看不见,处理它是空转 |
|
||||
| `InputNumber` 上下键 | 76 只,宿主自带 antd **硬编码英文** `aria-label="Increase Value" / "Decrease Value"`(`zh_CN` locale 也没翻,实测 `providers.tsx:43` 已挂 `zhCN`) | 字形名进不了可读名称,但会念英文。要改得动 antd 内部 DOM 或全站 locale(locale 会连 Pagination / Table / Empty 的**可见文字**一起改)——为几个英文码不值,记 §6 漂移 P2 |
|
||||
|
||||
### 2.4 唯一一处 CSS(不是新增外观,是补回被降掉的层级)
|
||||
|
||||
`Input.Search` 一旦收到 `enterButton` **元素**(以前收到的是字符串,走的是 antd 自绘分支),
|
||||
antd 就给外层挂 `.ant-input-search-with-button`,其唯一实际作用是悬停时把输入框的 `z-index` 从 1 降到 0,
|
||||
让按钮那条 1px 左边框压住输入框的悬停描边。本项目改前的观感是「输入框主色描边在上面」,
|
||||
所以补一条限定作用域的规则把它还原:
|
||||
|
||||
```css
|
||||
.ant-input-search-with-button > .ant-input-wrapper > .ant-input-affix-wrapper:not(.ant-input-disabled):hover { z-index: 1 }
|
||||
```
|
||||
|
||||
特异性 (0,5,1) 高于 antd 那条 (0,4,1),不靠样式注入顺序取胜,也不用 `!important`(AGENTS 强制规则 9)。
|
||||
证据:`reports/ui_evidence/nex-s2/search-{BEFORE,AFTER}-{idle,hover}.png` 明暗两色逐张比对 **0 像素差异**(§5.2)。
|
||||
|
||||
---
|
||||
|
||||
## 3. 修改文件清单与前后差异
|
||||
|
||||
| # | 文件 | 净增 | 改的是什么 |
|
||||
|---|---|---|---|
|
||||
| 1 | `frontend/src/components/icons/index.ts` | +213/−87 | 79 条出口 → `decorative()`(§2.1);新增 `decorative()` 与规则 5;新增 `IconClear` |
|
||||
| 2 | `frontend/src/components/ui/Input.tsx` | +23/−4 | 搜索按钮「搜索」+ 清空键「清空搜索」(§2.2) |
|
||||
| 3 | `frontend/src/components/ui/Ctlbar.tsx` | +18/−1 | `pagerLabel()` + `itemRender` → 上一页 / 下一页 |
|
||||
| 4 | `frontend/src/components/ui/Tabs.tsx` | +9/−0 | `more.icon` → 更多页签 |
|
||||
| 5 | `frontend/src/components/forms/SecretInput.tsx` | +9/−0 | `iconRender` → 显示 / 隐藏密码 |
|
||||
| 6 | `frontend/src/styles/app.css` | +9/−0 | 悬停 `z-index` 还原(§2.4),唯一一处样式 |
|
||||
| 7 | `scripts/ui/classaudit.mjs` | +30/−1 | 第 2 闸新增 `ICONA`:登记表出口形状;退出码纳入 |
|
||||
| 8 | `scripts/ui/semanticcheck.py` | +127/−2 | 第 8 条判据 `GLYPH` + `GLYPH_TOKENS` 交叉核对 + `GLYPH_ALLOW` |
|
||||
| 9 | `scripts/ui/gateprobe.py` | +123/−18 | `semanticcheck.GLYPH` / `GLYPH-seen` 两条 + `classaudit.GATE2-bad/good` 静态一条 → 17 条判据 |
|
||||
| 10 | `scripts/ui/census-icons.py` | **新增 170 行** | 只读普查(A/B/D 三组),立项与收口对账用;**不进串行、无退出码** |
|
||||
| 11 | `docs/UI规范.md` | +71/−17 | §5.1.1 从「在册待办」改成「已修的口径」;§15.12/15.13 探针口径;§16 第 9 步 |
|
||||
| 12 | `docs/NEX-对照与例外.md` | +4/−1 | §2.8 一行 COMPLIANT + 验收手段行 + §6 漂移一条 + §7 变更记录 |
|
||||
| 13 | `nex.config.yaml` | +4/−3 | 闸注释同步(出口形状 ICONA / GLYPH / 17 条判据 / 登记 census 只读) |
|
||||
|
||||
**没做的事**(对齐授权书禁止项):后端 0 改动、数据库 0 改动、业务 API 0 改动、技术栈未升级、
|
||||
未引入第二套 UI 组件库、未删除任何组件与页面、未改任何布局尺寸、未做无关视觉重设计、未删任何自动化检查。
|
||||
|
||||
---
|
||||
|
||||
## 4. 自动化与规范落点(防复发)
|
||||
|
||||
授权书第 8 条要求「更新自动化检查,避免类似问题再次出现」。这类缺陷的特殊之处是**它在 DOM 上完全隐形**:
|
||||
改前 900 只图标全都「有名有姓」,`NAME` 判据一条都不报。所以补的是**两头各一道闸 + 一份反向验证**,
|
||||
再加一条只读普查负责「下次立项时不用重新数」。
|
||||
|
||||
### 4.1 `classaudit` 第 2 闸·附条 `ICONA`(源码侧 · 钉写法)
|
||||
|
||||
原第 2 条 `ICON` 只管「别人不许 import 字形」,管不到登记表自己怎么写出口——
|
||||
而 S-2 的整条因果链就断在出口上。新增的 `ICONA` 逐条匹配固定形状
|
||||
`export const IconX = decorative(Glyph, 'IconX')`,三种绕过写法都会红(`scripts/ui/classaudit.mjs:192-219`):
|
||||
|
||||
| 绕过写法 | 为什么必须红 |
|
||||
|---|---|
|
||||
| `export { UploadOutlined } from '@ant-design/icons'` | 出口直接是 antd 原件 → `role=img aria-label=upload` 复活 |
|
||||
| `export { UploadOutlined as IconUpload }` | 换名不吃 `decorative()`,同上 |
|
||||
| `export const IconUpload = UploadOutlined` | 最像「合规」的一种:进了登记表但没包一层,同上 |
|
||||
| 一条 `decorative()` 都没匹配到 | 登记表结构变了 → 这条闸正在空转,必须响 |
|
||||
|
||||
为什么用正则逐行而不是 AST:加图标的人是**复制旁边一行**,不是先读注释;形状不对就红,
|
||||
比语义解析更贴合实际失误方式。退出码已把它算进去(同文件末行 `process.exit(... + regHits.length + ...)`)。
|
||||
|
||||
实测读数(`99-gates/03-classaudit.log:4`,复跑 `99-gates/25-classaudit-FINAL.log`):
|
||||
|
||||
```
|
||||
0 处绕过登记表的图标 import(只许 src/components/icons/index.ts)
|
||||
0 处图标出口未走 decorative()(登记表 79 条出口 / 0 处外部 import)
|
||||
CLASSAUDIT_EXIT=0
|
||||
```
|
||||
|
||||
### 4.2 `semanticcheck` 第 8 条判据 `GLYPH`(DOM/行为侧 · 钉结果)
|
||||
|
||||
写法闸挡不住「写法对但漏了一条出口」,所以行为侧再认一次结果。立案判据刻意**不依赖字形名单**:
|
||||
|
||||
> 一颗 `.anticon` 的 `aria-label` **等于自己的类名后缀**(`anticon-upload` ↔ `upload`)
|
||||
> → 这名字不可能是人写的 → 它是字形码。
|
||||
|
||||
这样登记表将来再换写法(现在是 `decorative()`),闸照样咬得住。可见性口径用
|
||||
`getComputedStyle().visibility` + 祖先 `aria-hidden`(`semanticcheck.py:227` 的 `VIS`),
|
||||
包围盒非零但 `visibility:hidden` 的一律不算——这条口径的细节见 §4.4。
|
||||
|
||||
三档分流,只有中间那档进退出码:
|
||||
|
||||
| 档位 | 条件 | 处理 | 本轮实测 |
|
||||
|---|---|---|---|
|
||||
| **遮蔽** | 宿主自己带 `aria-label` / 有效 `aria-labelledby` | 只计数:AT 念的是那句人话 | 每档 **72** 只(`InputNumber` 上下键 + 分页两颗) |
|
||||
| **立案** | 宿主存在但名字要靠 contents 算 | 进退出码 | **0** |
|
||||
| **无宿主** | 标签里的图标、提示条图标、状态点 | 逐条打印位置,不立案(S-2 只承诺操作名称) | **0** |
|
||||
| 在册豁免 | `GLYPH_ALLOW`(按宿主 sig 建键) | 放行并打印命中数 | 空表 / 0 |
|
||||
|
||||
另加一条**只打印不立案的交叉核对**:拿 CDP AX 树里 AT 真读到的名称去撞从 `index.ts` 解析出来的
|
||||
78 个字形码。DOM 侧安静而 AX 侧有命中,说明名字来自正文文本或闸门看不见的第三处,两种都要人看一眼。
|
||||
|
||||
实测(`99-gates/19-semanticcheck-1440.log`、`20-semanticcheck-430.log`,各 12 路由 × 明暗):
|
||||
|
||||
```
|
||||
GLYPH 1440/dark/assets 可见图标 2 · 外泄 0 / 遮蔽 2 / 无宿主 0 / 豁免 0
|
||||
GLYPH 1440/dark/projects/10/dispatch 可见图标 6 · 外泄 0 / 遮蔽 6 / 无宿主 0 / 豁免 0
|
||||
GLYPH 1440/dark/projects/10/timeline 可见图标 26 · 外泄 0 / 遮蔽 26 / 无宿主 0 / 豁免 0
|
||||
GLYPH 1440/dark/projects/10/delivery 可见图标 2 · 外泄 0 / 遮蔽 2 / 无宿主 0 / 豁免 0
|
||||
…(light 同读数;430 档同读数)
|
||||
GLYPH 交叉核对用 78 个字形码(解析自 index.ts);DOM 侧立案判据不依赖这张表
|
||||
GLYPH 在册豁免 0 条(空表)
|
||||
=== 语义与行为 0 条违规 ===
|
||||
```
|
||||
|
||||
**「只有 4 条路由出数」不是闸瞎**,而是期望终态:登记表出口的图标已经不带 `aria-label`,
|
||||
不满足「label == 类名后缀」,根本不进候选。出数的 4 条正是 antd 自绘 `InputNumber`/`Pagination`
|
||||
那 80 只所在的页面。与 §0 的 census 口径 80 vs 闸的 72 差 8 只,两处原因都可核对:
|
||||
① `semanticcheck` 默认 12 条路由(不含 `/help`、`/users`、`/account`);
|
||||
② 它按「镜头最多的项目」取项目 10,census 用项目 13——10 的 timeline 26 只、storyboard 无输入框,
|
||||
13 的对应读数是 28 与 2。两口径下外泄都是 **0**。
|
||||
|
||||
### 4.3 `gateprobe`:17 条判据与「对偶断言」新规矩
|
||||
|
||||
新闸必须自证会红。三条新判据(`scripts/ui/gateprobe.py`):
|
||||
|
||||
| 判据 | 夹具 | 断言 |
|
||||
|---|---|---|
|
||||
| `semanticcheck.GLYPH` | `pb-glyph`:`<button>` 里只有一颗 `aria-label=upload` 的图标 | **必须点名** |
|
||||
| | `pg-glyph`:按钮自己写了 `aria-label="导入脚本"` | 必须放行(遮蔽档) |
|
||||
| | `pg-glyph2`:只有文字「导入脚本」的按钮 | 必须放行 |
|
||||
| | `pg-glyph3`:图标显式具名 `aria-label="清空搜索"`(label ≠ 类名后缀) | 必须放行 |
|
||||
| `semanticcheck.GLYPH-seen` | 同一批夹具 | `pb-glyph` **与 `pg-glyph` 都必须被采到** |
|
||||
| `classaudit.GATE2-bad/good` | 把真登记表抄进临时目录、改出 3 种绕过写法 + 一颗越界 `StarOutlined` import,喂给 classaudit | 坏形状 4 条点名行必须出现;好形状必须安静 |
|
||||
|
||||
`GLYPH-seen` 这条是本轮新立的**对偶断言**规矩:光说「`pg-glyph` 必须放行」是空转——
|
||||
「压根没采到」和「采到了但判为遮蔽」在同一条串里看不出差别。所以凡是一条判据的正确答案是
|
||||
**「0 条 / 不点名」**,就必须同时断言「它的输入确实被采集到了」。这条已写进 `UI规范.md` §15.12。
|
||||
`gate2_static()` 里还有一层自保护:锚点在登记表里找不到就直接 `SystemExit` 点名,
|
||||
防止将来登记表改行之后这条静态判据悄悄变成恒绿。
|
||||
|
||||
实测:`GATEPROBE_OK 17/17`(54 条断言全 `OK`,见 `99-gates/24-gateprobe-DOCS-AFTER2.log`、
|
||||
`26-gateprobe-FINAL.log` → `GATEPROBE_EXIT=0`)。顺带把 §15.12 的口径修正为:
|
||||
判据条数(17)≠ 夹具种数(17 个 `pb-*` + 22 个 `pg-*`),末行数的是判据。
|
||||
|
||||
### 4.4 `scripts/ui/census-icons.py`:只读普查(**不进串行、恒返回 0**)
|
||||
|
||||
闸门只回答「有没有缺陷」,回答不了「这一族缺陷原来有多大」。普查脚本量 A/B/D 三组,
|
||||
立项与收口对账用;它**不进 `ui_gates` 串行**(否则 1 072 条读数里任何一条口径抖动都会变成红色阻塞),
|
||||
只在 `nex.config.yaml` 里留一行注释登记。
|
||||
|
||||
本轮给它补了 `vis` 字段,暴露出一件必须写下来的事——**可见性有两条口径,结论会差 6 只**:
|
||||
|
||||
| 口径 | 量法 | 改前 B 组 | 改后 B 组 |
|
||||
|---|---|---|---|
|
||||
| 包围盒(立项时用的) | `getBoundingClientRect()` 非零 | 42 条 / 19 种 | 0 |
|
||||
| **AT 可读**(现在两处一致) | 再排除计算后 `visibility:hidden` 与祖先 `aria-hidden` | **36 条 / 16 种** | 0 |
|
||||
|
||||
差的正是 6 只页签溢出「…」:rc-tabs 在没有溢出时给 `.ant-tabs-nav-operations` 挂
|
||||
`-hidden`(`visibility:hidden`),**包围盒有值但读屏念不到**;`census-icons.BEFORE.json` 生成时
|
||||
还没有 `vis` 字段,所以裸数停在 42。这条已在 PROBE3 的 36 组视口 × 明暗扫描里独立证实:
|
||||
1440/1100/900/760 全是 `ant-tabs-nav-operations-hidden`,只有 `/models` 600 与 430、`/library` 430 真正可见。
|
||||
`semanticcheck` 从第一条判据起就按 AT 可读口径判(`:227` 一直在看 `visibility`),
|
||||
**是普查脚本原来只按包围盒**——两个口径现在对齐了,别再拿裸数当结论。
|
||||
|
||||
收口对账(`CENSUS-FINAL4.txt`,15 路由 × 明暗 = 1 072 条图标读数,本轮用脚本原口径重算一遍):
|
||||
|
||||
| 组 | 改前 | 改后 |
|
||||
|---|---|---|
|
||||
| 带字形名的图标读数 | 1 072(全部) | 176(其中 148 是字形码 + 16 `清空搜索` + 6 `更多页签` + 6 `显示密码`) |
|
||||
| A 组:字形名对 AT 可见 | 900(包围盒)/ 894(AT 可读) | **80 / 80** |
|
||||
| B 组:图标是宿主唯一语义 | 42 条 19 种(AT 可读 36 条 16 种) | **0 条 0 种** |
|
||||
| 剩余 80 只的构成 | — | `up` 38 + `down` 38(`InputNumber` 上下键,含 10 只 disabled)+ `left` 2 + `right` 2(分页两颗);分布 timeline 56 / dispatch 12 / assets 4 / storyboard 4 / delivery 4 |
|
||||
| D 组:可读名称撞字形表 | 未量 | 2 条读数 / 1 种 = `/api/meta` × 2(**假阳性**:链接正文里真写着 `api`,节点里没有 `.anticon`) |
|
||||
|
||||
D 组这条就是 §0 表里「CDP AX 名称含字形码 261 → **1**」的那 1:AX 树 656 个节点里
|
||||
唯一剩下的命中是 `/help` 页那条 `<a>/api/meta</a>`,撞中的 token 是 `api`。
|
||||
它是正文文本,不是图标外泄,所以既不改判据也不加豁免——把它排除掉(比如不看 `<code>` 与 URL 文本)
|
||||
反而会给真缺陷留后门,这条记进 §6。
|
||||
|
||||
CDP AX 侧的对照(`AX-DIFF-BEFORE-AFTER3.txt`,1440/430 × 明暗,656 节点):
|
||||
|
||||
```
|
||||
可读名称含字形码:前 261 条 / 后 1 条(= 上面那条假阳性)
|
||||
承诺的中文名称是否真的进了 AX 树:
|
||||
导入脚本 1→1 · 导出 10→10 · 搜索 7→15 · 上一页 0→1 · 下一页 0→1 · 手册 17→17 · 显示密码 3→3
|
||||
清空搜索 0→0 · 更多页签 0→0 · 隐藏密码 0→0(快照时输入框为空 / 1440 下溢出键 visibility:hidden,未渲染或不可读)
|
||||
```
|
||||
|
||||
### 4.5 文档与配置落点(不复制规范)
|
||||
|
||||
授权书禁止「复制一份与 `docs/UI规范.md` 大量重复的规范文档」,所以本轮**只在既有章节里改口径**:
|
||||
|
||||
| 文件 · 章节 | 写了什么 |
|
||||
|---|---|
|
||||
| `docs/UI规范.md` §5.1.1(R15 那颗按钮一只语义图标) | 从「在册待办」改成「已修口径」:`decorative()` 三档规则、4 处显式具名清单、`visibility` 星号脚注、以及「溢出『…』与密码眼睛的名字只能挂在图标上」(antd 的 `MoreProps` / `iconRender` 没给宿主开 `aria-label` 口子) |
|
||||
| `docs/UI规范.md` §15.12 | gateprobe 判据 16 → **17**;夹具种数 ≠ 判据条数;**「正确答案是 0 条的判据必须同时断言输入被采到」**这条新规矩 |
|
||||
| `docs/UI规范.md` §15.13 | `semanticcheck` 判据七条 → **八条**;`GLYPH` 三档分流与豁免表打印口径;可见性按 `visibility` 而非包围盒 |
|
||||
| `docs/UI规范.md` §16 第 9 步 | 改动流程里加「图标可访问名称」一项(默认装饰 / 需要时具名 / 两处闸的跑法) |
|
||||
| `docs/NEX-对照与例外.md` §2.8 | 新增一行 **COMPLIANT**:NEX 08 §1/§2「名称必须是自然语言」,本项目出处 = 登记表 + 4 处具名 + 两道闸;并把「两头都不许一刀切」写成理由 |
|
||||
| `docs/NEX-对照与例外.md` §6 / §7 | §6 新增一条漂移(antd 内部 `InputNumber` 上下键的英文宿主名);§7 变更记录 2026-11-08 一行 |
|
||||
| `nex.config.yaml` | 闸注释同步:第 2 闸写成「图标 import + 出口形状 ICONA」、`semanticcheck` 注释补「字形名外泄 GLYPH」、`gateprobe` 注释写「17 条判据 = 16 页面 + 1 静态」、census 一行注明「只读普查,不进串行、无退出码」 |
|
||||
|
||||
`AGENTS.md` 未改:现有强制规则 6(交互状态完整 · 可点击元素必须键盘可达)与规则 3/4(禁硬编码 /
|
||||
禁私自建变体)已覆盖本轮口径,图标这条走的是 §5.1.1 与 §15.x,不需要新加一条全局规则。
|
||||
|
||||
### 4.6 改文档之后的复跑
|
||||
|
||||
`classaudit` 第 9 闸会拿 `docs/UI规范.md` 的断点表与探针登记对账,文档一改就必须复跑:
|
||||
|
||||
| 日志 | 时间 | 结果 |
|
||||
|---|---|---|
|
||||
| `21-classaudit-DOCS-AFTER.log` / `22-gateprobe-DOCS-AFTER.log` | 文档首轮改后 | 全绿 / `GATEPROBE_OK 17/17` |
|
||||
| `23-classaudit-DOCS-AFTER2.log` / `24-gateprobe-DOCS-AFTER2.log` | 再改(`visibility` 脚注 + census 取证行)后 | 全绿 / `GATEPROBE_OK 17/17` |
|
||||
| `25-classaudit-FINAL.log` / `26-gateprobe-FINAL.log` | 本报告定稿前复跑 | `CLASSAUDIT_EXIT=0` / `GATEPROBE_EXIT=0` |
|
||||
| `27-classaudit-POSTREPORT.log` / `28-gateprobe-POSTREPORT.log` | 本报告 §0/§3 校订**之后**复跑 | `CLASSAUDIT_EXIT=0`(9 道子闸全 0,含出口形状那条:79 条出口 / 0 处外部 import)/ `GATEPROBE_OK 17/17` |
|
||||
|
||||
### 4.7 对 R15 与其它探针的影响(授权书第 7 条)
|
||||
|
||||
- **R15(一颗按钮一只语义图标)不受影响**:`decorative()` 只转发 props,不增删 DOM 节点,
|
||||
渲染结果仍是同一只 `span.anticon` + 同一份 svg。R15 的计数按类名走,读数一字不变。
|
||||
- **按 `.anticon` 类名判别的探针全部不受影响**:`visualcheck.py:178-182`、`semanticcheck.py:202-207`、
|
||||
`app.css` 的 `.anticon` 尺寸规则与 `.nex-tag` 皮肤族都照旧命中。
|
||||
- **`classaudit` 其余 8 道子闸**(死类名 / 裸 button / 浮层底部 / antd import / 反馈表面 / 标题图形 /
|
||||
标签皮肤 / 断点对账):全 0,见 `03-classaudit.log` 与 `25-classaudit-FINAL.log`。
|
||||
- **`tableaudit` 四档 / `gridcheck` / `rhythmcheck` / `tagcheck` / `btnrowcheck` / `aligncheck` /
|
||||
`symmetrycheck` / `footercheck` / `btnclustercheck` / `feedbackcheck`**:全绿(§5.1)。
|
||||
- **`visualcheck`**:120 状态全过,像素与基线差在噪声量级(§5.2)。
|
||||
- 唯一被**改动**的探针行为是 `semanticcheck` 多了一条判据、`gateprobe` 多三条反向验证——
|
||||
都是「加闸不加严既有判据」,既有 12 条路由 × 明暗的违规读数仍为 0,没有靠放宽规则换取绿灯。
|
||||
|
||||
---
|
||||
|
||||
## 5. 回归与验收
|
||||
|
||||
### 5.1 串行质量闸(项目实际存在的命令,无 lint / 无单测)
|
||||
|
||||
跑法:`cd frontend && npm run typecheck && npm run build`;
|
||||
`node scripts/ui/classaudit.mjs`;`.venv/bin/python scripts/ui/<gate>.py`(`NEX_BASE=http://127.0.0.1:5199`)。
|
||||
日志逐份落在 `reports/ui_evidence/nex-s2/99-gates/`,`SUMMARY.txt` 是总账。
|
||||
|
||||
| # | 命令 | 退出码 | 耗时 | 完成时刻 |
|
||||
|---|---|---|---|---|
|
||||
| 01 | `npm run typecheck` | 0 | 3 s | 16:08:36 |
|
||||
| 02 | `npm run build` | 0 | 2 s | 16:08:38 |
|
||||
| 03 | `node scripts/ui/classaudit.mjs`(9 道子闸) | 0 | 1 s | 16:08:39 |
|
||||
| 04 | `scripts/ui/gateprobe.py` | 0 | 3 s | 16:08:42 |
|
||||
| 05–08 | `tableaudit.py` × {1440, 768, 576, 430} | 0 ×4 | 41 s ×4 | 16:11:27 |
|
||||
| 09–17 | `gridcheck` / `rhythmcheck` / `tagcheck` / `btnrowcheck` / `aligncheck` / `symmetrycheck` / `footercheck` / `btnclustercheck` / `feedbackcheck` | 0 ×9 | 共 605 s | 16:21:32 |
|
||||
| 18 | `visualcheck.py`(**120 状态**) | 0 | 253 s | 16:25:45 |
|
||||
| 19–20 | `semanticcheck.py` × {1440, 430} | 0 ×2 | 700 s + 613 s | 16:47:38 |
|
||||
| 21–26 | 文档改动后的 `classaudit` / `gateprobe` 复跑 ×3 轮 | 0 ×6 | — | 17:19:0x |
|
||||
|
||||
`ALLDONE`;无一条被跳过,无一条放宽阈值。
|
||||
被测代码最后一次改动是 16:03:13(`ui/Tabs.tsx`、`forms/SecretInput.tsx`),
|
||||
早于串行起跑 16:08:36 → 19/20 号日志测的就是最终代码。
|
||||
|
||||
**84 状态基线**:`nex.config.yaml → frontend.verification.baseline` = 14 路由 × {1440, 768, 430} × 明暗 = 84。
|
||||
本轮 `visualcheck` 跑的是 **15 路由 × {1440, 768, 576, 430} × 明暗 = 120 张**(`99-gates/shots-120/`),
|
||||
**84 ⊂ 120**(新增 `/9e0f-not-a-page` 一路与 576 一档),因此与既有基线逐帧可比;
|
||||
`tableaudit` 四档与 `semanticcheck` 两档也都覆盖到 430/576 这档窄视口。
|
||||
|
||||
### 5.2 像素:与「同一份代码跑两次」的噪声对照比,而不是和 0 比
|
||||
|
||||
`visualcheck` 的 120 张里 **38 张非零**。单看这个数会误判,所以拿一份**噪声对照**:
|
||||
阶段 8.5 收口时的 `main` 快照与**同一份代码**再跑一次的 `final` 快照对比 → **非零 33 张**。
|
||||
逐张把「噪声是否在同帧同区域复现」并进去分类(`PIXDIFF-CLASSIFY.txt`):
|
||||
|
||||
| 判定 | 张数 | 依据 |
|
||||
|---|---|---|
|
||||
| 与噪声同区域(同帧复现,bbox 重叠) | 26 | `account` / `users` 两页占大头(`avatar` 与随机骨架),`maxΔ` 96~209 但噪声同量级 |
|
||||
| 纯抗锯齿(`maxΔ ≤ 4`) | 10 | 登录页 2 张 `maxΔ=2`、`models` 2 张 `maxΔ≤4` 等 |
|
||||
| **需看图定性** | **2** | `1440-dark-help.png` bbox(248,25,1416,701)、`1440-dark-projects-10-dispatch.png` bbox(771,24,1015,32) |
|
||||
|
||||
两张定性的做法是把差异框按 2×~4× 放大后读像素(`PIXDIFF-help-dark-top-2x.png`、
|
||||
`PIXDIFF-dispatch-dark-header-4x.png`):`help` 的差异带落在正文滚动条与代码块的换行处,
|
||||
`dispatch` 的 bbox 正好是顶栏阶段进度点那一行(`y 24–32`),两块在噪声对照里同样非零
|
||||
(`1440-light-projects-10-delivery.png` 的噪声 bbox(771,22,1017,34) 与它同区域)。
|
||||
登录页那 2 张 `maxΔ=2` 单独放大确认是聚焦输入框圆角处的 ±1 LSB:
|
||||
差异像素 `(21,96,203)` vs `(21,97,203)`,而边框中点 `(22,104,220)` 前后完全相同
|
||||
(`PIXDIFF-login-{dark,light}-3x.png`)。
|
||||
|
||||
搜索框悬停那处唯一的 CSS(§2.4)另有专门对照:`search-{BEFORE,AFTER}-{idle,hover}.png`
|
||||
明暗各两张,**逐张 0 像素差异**——改前后同一条描边、同一个层级。
|
||||
|
||||
### 5.3 键盘与焦点(本轮三处新增交互入口 + 既有热区)
|
||||
|
||||
| 对象 | 实测 | 出处 |
|
||||
|---|---|---|
|
||||
| 分页两颗 + 页码 | `/assets` 共 10 条、每页档位 `[24,60,120,全部]` → 凑不出第 2 页(最小档 24 > 10),两颗箭头在 `1 / 1` 下 disabled;**没有为验证去造业务数据** | `PAGER4.txt`、`s2-pager4.json` |
|
||||
| 从 disabled 的「上一页」起连按 Tab | 按钮被跳过、焦点回到页首:`收起导航菜单` → `长视频编导平台 · 返回项目总览` → `平台当前空闲`,**每一站 `:focus-visible` 都是 `2px solid`** | 同上 |
|
||||
| 两颗箭头的可访问名称 | `get_by_role("button", name="下一页")=1`、`name="上一页")=1`(明暗各 1 次) | `FINAL-SHOTS2.txt` |
|
||||
| 页签溢出「…」 | 36 组视口 × 明暗扫描:只有 `/models` 600 / `/models` 430 / `/library` 430 真正可见(`visibility` 不是 hidden),其余 33 组是 `-hidden`;**键盘 Enter 与鼠标点击都能展开**(`opened_keyboard=1 / opened_mouse=1`) | `PROBE3.txt`、`s2-probe3.json`、`s2-tabsmore-kbd-*.png` |
|
||||
| 搜索框清空键 | DOM = `<button type="button" tabindex="-1" class="ant-input-clear-icon">` + 内部 `role=img aria-label="清空搜索"`;`get_by_role("button", name="清空搜索")=1`;激活后 `value_after=""`(真清空) | `PROBE3.txt` |
|
||||
| 密码眼睛 | 登录页 `Tab` 序列实测 = `checkbox → button → body → button(切换明暗主题) → input(用户名) → input(密码)`,**眼睛不在序列里**(`tabindex="-1"`,设计如此);点击后 `type=password → text` | `FINAL-SHOTS2.txt`、`s2-eye-{dark,light}-login.png` |
|
||||
| 搜索按钮 | `get_by_role("button", name="搜索")=1`;`anticon_search` 本体 `aria-hidden=true` | `FINAL-SHOTS2.txt` |
|
||||
| 既有 3 处热区(阶段 2 成果) | `semanticcheck.TABTARGET` / `HOTSPOT` 在 1440 与 430 两档仍 0 违规,`gateprobe` 对偶夹具照旧点名 | `19/20` 号日志 |
|
||||
|
||||
一处必须记录的中性发现:程序化 `focus()` 到清空键时 `outline: 3px none / boxShadow: none`——
|
||||
**没有焦点环**。这不是本轮引入的(antd 那颗本来就 `tabindex="-1"`,键盘用户走不到它),
|
||||
记进 §6 供 P2 决策。
|
||||
|
||||
### 5.4 产物冒烟(`preview`)
|
||||
|
||||
`npm run build` 之后 `npm run preview`(:4173)跑 22 组组合(11 路由 × {1440, 430} × light):
|
||||
|
||||
```
|
||||
PREVIEW-SMOKE.txt → === 冒烟失败 0 条 ===(顶栏高度 56 全部一致、导航在场、正文节点数 145~1537)
|
||||
```
|
||||
|
||||
标题与路由逐条对上(`分镜与脚本` / `导出与成本` / `使用手册` / `平台资产库` / `模型管理中心` / `项目`),
|
||||
说明 `decorative()` 的转发没有影响 SSR-less 产物里的水合与样式落地。
|
||||
|
||||
---
|
||||
|
||||
## 6. 边界、漂移与未解决(逐条,附建议)
|
||||
|
||||
| # | 事项 | 现状与证据 | 建议 |
|
||||
|---|---|---|---|
|
||||
| U-1 | **`InputNumber` 上下键的宿主名是英文**(`Increase Value` / `Decrease Value`),antd 硬编码,`zh_CN` locale 也没翻 | 76 只(含 10 只 disabled);`PROBE3.txt` 抓到 DOM;`providers.tsx:43` 确实挂了 `zhCN` | 记 §6 漂移 P2。要改只能覆盖 antd 内部 DOM 或全站 locale(后者会连 Pagination / Table / Empty 的**可见文字**一起改)——为几个英文码不值,本轮不动 |
|
||||
| U-2 | **清空键与密码眼睛 `tabindex="-1"` 且程序焦点无焦点环** | `PROBE3.txt`(`outline 3px none`、`matchesFocus=true`)、`FINAL-SHOTS2.txt`(`Tab` 序列不含眼睛) | antd 既有设计,鼠标可达、键盘走不到。若 P2 要「键盘也能一键清空」,需要单独决策(改 `tabindex` 会动 Tab 走位清单),不要顺手改 |
|
||||
| U-3 | **分页两颗:真机旁白未听到 + 多页 Enter 未验证** | 现有数据 10 条 / 最小档 24 → 恒 `1 / 1`,箭头 disabled、`Tab` 跳过;三轮自动走查中断(§7) | 名称与焦点已由 CDP AX + `get_by_role` + `GLYPH` 遮蔽档证明;**Enter 翻页**需在 >24 条素材的项目里人工补测,人工脚本见 `10-voiceover/README.md` §3 |
|
||||
| U-4 | **census D 组会把正文文本当外泄**(`/api/meta` 撞中 token `api`) | `CENSUS-FINAL4.txt` 2 条读数 / 1 种;AX 侧同一根因 | 建议下轮给 D 组与交叉核对排除 `<code>` / `href` 文本,但**要同时加一条正例断言**防止排除过头;本轮宁留假阳性,不掩真缺陷 |
|
||||
| U-5 | **改前裸数 900 / 42 是包围盒口径**,AT 可读口径是 894 / 36(6 只页签「…」在 1440 下 `visibility:hidden`) | `census-icons.BEFORE.json` 生成时还没有 `vis` 字段;PROBE3 的 36 组扫描证实隐藏条件 | 已在 `UI规范.md` §5.1.1 脚注与 `census-icons.py` docstring 双处标注。引用这两个数时必须带口径,别再当同一个数用 |
|
||||
| U-6 | **NVDA + Chrome 未执行**(本机无 Windows / 无 NVDA) | §7 环境表 | **MANUAL QA REQUIRED**,不得宣称通过;测试步骤已写进 `10-voiceover/README.md` §3 |
|
||||
| U-7 | 分页 `li.ant-pagination-prev/next` 上挂着 antd 的 `title="Next Page"`(英文) | `FINAL-SHOTS2.txt`:`tag=li`、`title="Next Page"`,而两颗**按钮本体** `aria-label` 已是中文;CDP 全量 AX 树里 `Next Page` 出现 0 次 | 不是本轮引入(改前那颗按钮整颗叫 `left`/`right`,见 `AX-DIFF` 前表)。人工复测时若听到「Next Page」,来源是这层 `li` 的 tooltip,与图标字形码无关;要消它同样落到 U-1 的 locale 决策里 |
|
||||
| U-8 | 浮层里的图标(87 条读数) | `OVERLAY-ANTDI-INTERNAL.txt`:外泄 0 / 无名宿主 0 | 已结案,无需追加 |
|
||||
| U-9 | 真机走查第三轮被 macOS「Enable ChatGPT Computer Use Permissions」系统弹窗打断并顺带关掉了旁白 | `10-voiceover/README.md` §1 与 §3 | 与项目代码无关(本机自动化权限)。补测时先把该授权落地,否则按键注入会在任意时刻失焦 |
|
||||
|
||||
**明确没有做的事**(对齐授权书禁止项):没有批量 `aria-hidden`(②档全站仅 4 处、③档 0 处调用点新写);
|
||||
没有改视觉(§5.2);没有改业务流程与数据;没有动后端 / 数据库 / API;没有升级技术栈;
|
||||
没有引入第二套 UI 组件库;没有删除任何组件、页面或自动化检查;没有改任何布局尺寸;
|
||||
没有跑 P2 批量整改;没有动阶段 4–8 已验收的东西。
|
||||
|
||||
---
|
||||
|
||||
## 7. 真机读屏实录(VoiceOver + Safari)
|
||||
|
||||
**环境(实测,不是推断)**:macOS 15.3(`24D60`)/ Mac16,10 · Safari 18.3 ·
|
||||
旁白嗓音「中文(普通话)婷婷」·被测 dev `:5199`(工作树)·登录 `admin`·项目 13。
|
||||
播报采集走 `log stream --predicate 'process == "VoiceOver"'`,原始日志 240 MB(已 gzip 存
|
||||
`10-voiceover/vo-log.txt.gz`),抽取 516 条播报、去重 225 行 →
|
||||
`10-voiceover/voiceover-announcements-2026-11-08.txt`。
|
||||
**对照基线**是阶段 8.5 在同一台机器上抓的改前实录
|
||||
(`reports/ui_evidence/nex-p8f/07-screen-reader/voiceover-announcements-2026-11-08.txt`:
|
||||
`upload 导入脚本` / `plus 新增镜头` / `book 手册` / `appstore 看板` / `ordered-list 分镜表` / `search 图像` / `down 导出`)。
|
||||
|
||||
改后命中 18 组播报(完整表 + 时间戳见 `10-voiceover/README.md` §2),其中直接对应本轮修改的 8 组:
|
||||
|
||||
| 改前(真机) | 改后(真机 · 时刻) |
|
||||
|---|---|
|
||||
| `upload 导入脚本` | **`导入脚本 斜线 关键帧` + `按钮`**(16:59:26 / 16:59:28) |
|
||||
| `down 导出` | **`导出`**(17:05:29) |
|
||||
| `plus 新增镜头` | **`新增镜头`**(16:59:35) |
|
||||
| `appstore 看板` / `ordered-list 分镜表` | **`切换分镜视图` 单选按钮组 → `看板`(已选择 第 1 项/共 2 项)→ `分镜表`(第 2 项)**(17:00:57–17:01:29) |
|
||||
| `search`(那颗按钮整颗只念码) | **`搜索 按钮`**(17:03:11,前面依次是 `搜索 :` 与占位说明句) |
|
||||
| `book 手册` | **`, 手册`** + `使用手册 · 全流程操作截图(新窗口打开)`(16:57:46 / 47) |
|
||||
| `project 返回项目总览` | **`, 长视频编导平台 · 返回项目总览`**(16:57:10) |
|
||||
| — | 第二轮 /assets 走查:统计卡 4 张、页签 3 颗、视图切换 3 颗、搜索框、3 个筛选 + 排序、「仅疑似重复」复选框、标签行、卡片首项(17:11:38–17:14:22),**全程零字形码** |
|
||||
|
||||
其余 10 组是未改动控件的对照组(汉堡 `收起导航菜单 按钮`、`平台当前空闲`、
|
||||
`切换明暗主题,当前为浅色 按钮`、地标 `横幅/补充/菜单/主要`、`标题级别3 分镜与脚本`、
|
||||
三个筛选组合框、`分镜脚本 斜线 关键帧导入`),用来证明**没有把原本念得对的东西改坏**。
|
||||
|
||||
**未覆盖(MANUAL QA REQUIRED)**:分页「上一页 / 下一页」两颗、「清空搜索」一颗、「显示/隐藏密码」两态一颗、
|
||||
「更多页签」窄视口一颗,以及 **NVDA + Chrome 全家**。
|
||||
四者的原因、已有证据与人工复测步骤(含期望播报原文)逐条写在
|
||||
`reports/ui_evidence/nex-s2/10-voiceover/README.md` §3。
|
||||
第三轮起按键注入被系统权限弹窗打断(`17:15:49 旁白关闭`),补跑 8 次按键零播报后**主动收手**,
|
||||
没有把「没听到」写成「听过了」。
|
||||
|
||||
**因此本轮读屏验收的准确表述是**:VoiceOver + Safari 18.3 真机证明了 8 处修复与 10 组对照控件无回退;
|
||||
其余 4 处由 CDP AX 名称、`get_by_role` 与 `semanticcheck.GLYPH` 遮蔽档在程序化口径上证明;
|
||||
NVDA 未执行。**S-2 的读屏验收不能标记为完全通过。**
|
||||
|
||||
---
|
||||
|
||||
## 8. 交付物索引与建议的提交切分
|
||||
|
||||
**报告**:`reports/NEX阶段8.5.1-S-2图标可访问名称-2026-11-08.md`(本文件)
|
||||
**证据目录**:`reports/ui_evidence/nex-s2/`(`99-gates/` 26 份日志 + `shots-120/`、
|
||||
`10-voiceover/`、`AX-*`、`CENSUS-*`、`PROBE3.txt`、`PAGER4.txt`、`PIXDIFF-*`、`PREVIEW-SMOKE.txt`、`FINAL-SHOTS2.txt`、
|
||||
`s2-*.png` 共 80+ 份)
|
||||
**代码 / 规范**:§3 的 13 个文件(含新增 `scripts/ui/census-icons.py` 170 行)
|
||||
|
||||
建议按三个关注面切分提交(本报告随第三组走):
|
||||
|
||||
1. `fix(可访问性): 图标默认为装饰 · 4 处控件补自然中文名称`
|
||||
—— `frontend/src/components/icons/index.ts`、`ui/Input.tsx`、`ui/Ctlbar.tsx`、`ui/Tabs.tsx`、
|
||||
`forms/SecretInput.tsx`、`styles/app.css`
|
||||
2. `test(闸门): 字形名外泄钉死在源码与 DOM 两头 + 对偶断言规矩`
|
||||
—— `scripts/ui/classaudit.mjs`、`semanticcheck.py`、`gateprobe.py`、`census-icons.py`
|
||||
3. `docs(规范): UI规范 §5.1.1/§15.12/§15.13/§16 + NEX 对照 §2.8/§6/§7 + nex.config.yaml + 阶段 8.5.1 报告`
|
||||
—— 两个 docs、`nex.config.yaml`、本报告
|
||||
|
||||
`nex_design_system/`(NEX 子仓库工作副本)**不入本仓提交**。
|
||||
|
||||
**本轮到此暂停**:S-3、T-1、Bundle 优化未启动,等下一步确认。
|
||||
Loading…
Reference in New Issue