diff --git a/AGENTS.md b/AGENTS.md index 932a959..3baf7d7 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -9,7 +9,7 @@ | 层 | 文件 | 负责什么 | |---|---|---| -| 1 | `docs/UI规范.md` | **项目级 UI/UX 权威**:20 条硬规则 R1–R20、§1–§16 全部尺子与口径、12 道常驻探针、十二步改动流程 | +| 1 | `docs/UI规范.md` | **项目级 UI/UX 权威**:20 条硬规则 R1–R20、§1–§16 全部尺子与口径、13 道常驻探针、十二步改动流程 | | 2 | `docs/工程规范.md` | 目录职责、脚本准入、代码风格、部署、删除策略、最低验收 | | 3 | `docs/NEX-对照与例外.md` | NEX 逐条判定(COMPLIANT / ADOPTED / ADAPTED / DEFERRED / NOT APPLICABLE)与**项目级例外登记**;NEX 与本项目冲突时按此文件执行 | | 4 | `nex.config.yaml` | 项目现状声明(真实尺寸、真实技术栈、真实检查命令)。改了布局尺寸必须同步它 | @@ -41,7 +41,7 @@ - **Empty 三分类**:没数据 / 没匹配 / 引导下一步,文案分开,且能清除筛选恢复默认。 - **反馈四级表面**(R19):`ErrorText`/`LineHint` → `Notice` → `notify*` 吐司 → `confirmAction`。长任务唯一进度源是顶栏「平台动态」(§13.7),页面内不得再放第二个进度条。 - **专业工作区交互**:分镜卡拖拽、时间线、录音、素材灯箱、版本面板的既有操作路径。 -- **质量闸门**:12 道常驻探针 + §16 十二步流程。这是 NEX 10「阶段 5 质量门禁」的现成实现,复用而非重造。 +- **质量闸门**:13 道常驻探针 + §16 十二步流程。这是 NEX 10「阶段 5 质量门禁」的现成实现,复用而非重造。 - 本项目**没有**文档阅读 / PDF 预览 / AI Chat 工作区,不要为对齐 NEX 引入相应模板、布局或图表依赖。 ## 3. 强制规则 diff --git a/docs/NEX-对照与例外.md b/docs/NEX-对照与例外.md index 02b9aa9..81d543c 100644 --- a/docs/NEX-对照与例外.md +++ b/docs/NEX-对照与例外.md @@ -15,7 +15,7 @@ - 反向清单:本轮实施中发现**需要 NEX 自己修订或补充**的地方(§5),以及尚未收敛的漂移(§6)。 **不是:** -- ❌ 不是第二份 UI 规范。尺子、口径、20 条硬规则、12 道探针仍然只在 `docs/UI规范.md`,本文件**不重复制定数值**,只做判定与引用。 +- ❌ 不是第二份 UI 规范。尺子、口径、20 条硬规则、13 道探针仍然只在 `docs/UI规范.md`,本文件**不重复制定数值**,只做判定与引用。 - ❌ 不是改造任务清单。改造计划见 `reports/NEX设计审计与改造计划-2026-11-07.md`。 - ❌ 不是 changelog 替代品。改了尺寸/机制,先改 `theme/antd.ts` 与 `UI规范.md`,再回来更新本表受影响的那一行。 @@ -92,6 +92,7 @@ NEX 与本项目差异用「项目适配」解决,**不得反向修改本项 | §7 面包屑要求 | **ADAPTED**(E5) | `UI规范.md` §0 R18 | 本项目**不用**面包屑:R18 要求「每级身份只说一遍」,门牌 + 侧栏已表达归属;kit 导出的 `Breadcrumb` 实测 0 个页面使用 | | §8 响应式断点(576/768/992/1200) | COMPLIANT + **ADAPTED**(E9) | `styles/index.css:166-170` | 五档与 antd Grid 全等(含 1600 = antd `xxl`),主阶梯未造私档 | | §8 「不允许私有断点」 | **ADAPTED**(E9,阶段 7 已收口) | `styles/index.css:171-175`、`UI规范.md` §4「登记断点」 | 原则接受并已收口:页面里 5 个私档(`max-[620px]`×10、`max-[720px]`×2、`max-[1080px]`、`max-[1240px]`、`max-[1400px]`)改名为 `--breakpoint-*` 命名变体,`grep -rn "max-\[" frontend/src` = 0,**px 一字未改**(归到相邻档位会让已验证的看板列数 / 检查器宽度回退,实测见 §4 表)。机制本身已被 NEX 采纳(**N16 已闭**:`04-layout-system.md` §8.1「命名断点登记出口」四条口径),并且四条全部由 `classaudit.mjs` **第 9 闸 BP** 机器对账(裸 `max-[…]`、未登记名、一名多使用者、0 使用者、`UI规范.md` §4 缺行、`visualcheck.py` 的 `BP`/`BPORDER` 失同步、`.css` 里未登记的 `@media` 像素) | +| §8.2 表格类数据的窄屏降级(三种形态之外的第四种:**换列定义**) | **ADOPTED**(阶段 8.5 · 第 3 项批准:逐表方案,不得统一处理) | `components/ui/Table.tsx::useNarrowTable()`(<992)、九张表各自的窄档 `columns`:`Dashboard.tsx:474/532`(①走已验证卡片)、`Dispatch.tsx:256+/475+`(②③)、`Review.tsx:468+`(④)、`Timeline.tsx:801+`(⑤)、`Delivery.tsx:289+/331+/455+/532+`(⑥⑦⑧⑨);口径 `UI规范.md` **§13.2.1** | NEX 04 §8.2 给的三选一(横向滚动 / 堆叠单栏 / 抽屉化)**放不下这一族**:定宽列合计 400~902 的表在 430 会把**片名 / 提示词 / 错误文本**挤成 0 宽——数据不是被滚动藏起来,是根本不渲染。本项目采用的第四条路是「宽档列定义一字不动、窄档换一套 columns,次要列并进主列第 2/3 行 + `title` 存全文」;为什么不用 CSS 显隐(表头与单元格仍在 DOM 里,辅助技术会读到看不见的列)已写在 hook 注释。建议 NEX 把这条补进 §8.2(→ §5 **N17**) | | §8 工作区 <768 降级 | **ADOPTED**(阶段 8 · 用户批准 N7) | `app/layout/AppSider.tsx`(`AppNavMenu` / `AppSider` / `AppNavDrawer` 三导出)、`app/App.tsx:187`(`narrow`)、`app/layout/AppHeader.tsx`(同一颗按钮换语义) | <768 **不渲染侧栏**,导航只剩顶栏汉堡一个入口,点开的是 kit `Drawer placement="left"`(宽 = `SIDER_WIDTH` 224、`flushBody` 贴边、换页自动关)。改前三条已实测:图标轨 + 汉堡**同屏两个入口**语义重叠、正文白吃 64px(430 档正文 366、顶栏胶囊 `sw203>cw170` 溢出 33px)。菜单本体是**同一份组件**,不是第二套导航。NEX 侧的范式已由 **N7** 落到 `04-layout-system.md` §8.2「导航形态在同一视口内只留一个入口」;≥768 的手工折叠(64 图标轨)保留不动 | ### 2.5 `docs/05-component-system.md` — 组件系统 @@ -143,6 +144,7 @@ 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,**不是**问题) | | §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`(外层无 `
`)⇒ `