diff --git a/docs/NEX-对照与例外.md b/docs/NEX-对照与例外.md index 81d543c..707c1d1 100644 --- a/docs/NEX-对照与例外.md +++ b/docs/NEX-对照与例外.md @@ -143,8 +143,9 @@ NEX 与本项目差异用「项目适配」解决,**不得反向修改本项 | NEX 条款 | 状态 | 本项目出处 | 理由 | |---|---|---|---| | §1 语义化交互(不用 `div + onClick`) | **ADOPTED(原则)**;3 处热区 **本轮阶段 2 修** | `Storyboard.tsx:1915`(`
`)、`ui/Rows.tsx:11`(`
`)、`AppHeader.tsx:60,70`(`Avatar`/`Text` 当链接)——**行号为阶段 0 记录值**;阶段 2 之后三处已分别变为 `Storyboard.tsx:1915+`(带 `tabIndex`/`onKeyDown`)、`ui/Rows.tsx:27`(`clickable` 分支)、`AppHeader.tsx:70`(已是真 ``) | 原则完全接受;存量违规仅这 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`(外层无 `
`)⇒ `