diff --git a/reports/NEX阶段8.5-响应式UX与质量收口-2026-11-08.md b/reports/NEX阶段8.5-响应式UX与质量收口-2026-11-08.md new file mode 100644 index 0000000..b19d5f2 --- /dev/null +++ b/reports/NEX阶段8.5-响应式UX与质量收口-2026-11-08.md @@ -0,0 +1,615 @@ +# NEX Design System · 阶段 8.5 实施报告(响应式 UX 与质量收口 · 七项) + +- 分支 / 提交链:`main`,基线 `5a10bfb`(阶段 8 收尾)。本轮按批准项分次提交,逐项对应 §1–§7。 +- 授权来源:`reports/NEX阶段8实施-2026-11-07.md` 之后用户对**剩余七项问题**的逐条决策(阶段 8 授权书 §1–§7)。 + 七项里 5 项 APPROVED、1 项 DEFERRED(CSS Layer)、1 项「保持现状 + 写清理由」(导航状态)。 +- 上游文档:`docs/UI规范.md`(项目级权威)、`docs/NEX-对照与例外.md`(映射与例外登记)、`nex_design_system/`(NEX 0.1.1 独立仓库)。 +- 环境:dev `http://127.0.0.1:5199` · 后端 `:8010` · preview `:4173` · HEAD 对照组 dev `:5299`(worktree `/private/tmp/nexd/head-p8g`)· 探针项目 PID=10 · 登录 `admin` +- 项目**没有** `lint` / `test` 脚本;可用命令只有 `npm run dev` / `build` / `typecheck` / `preview` 与 `scripts/ui/` 下的探针(§8.1)。 +- 证据目录:`reports/ui_evidence/nex-p8f/`(01 css-layer · 02 topbar-name · 03 tables · 04 semantic · 05 nav · 06 chunk · 07 screen-reader · 09 gates · 10 preview-smoke · 11 visualcheck)。**注意:`.gitignore:50` 的 `reports/*evidence/` 让整棵证据树不进版本库**(仓库既有策略,本轮不改),所以它是**本机路径**——提交里能看到的是本报告与 §10.1 的代码/文档;换机器要重新跑闸。 +- 硬约束(全部遵守):不动后端与数据库 · 不升级技术栈 · 不引入第二套 UI 组件库 · 不改业务流程 · 不做无关视觉重设计 · 不删自动化检查 · 表格改造全部做数据完整性回归 · 每项给文件清单与理由。 + +--- + +## 0. 结论摘要 + +| # | 项 | 决策 | 改动面 | 关键验证 | +|---|---|---|---|---| +| 1 | CSS Layer 治理 | **DEFERRED** | **零迁移**:只做全站样式组织盘点(`docs/UI规范.md` §1.1.2 + `01-css-layer/census.txt`);唯一局部修复是第 4 项咬出的一个**可复现缺陷**(`app.css` +11 行焦点环) | `app.css` 828→839 行 / 140→141 规则 / 198→199 分支,`@layer` 声明仍为 0、`!important` 仍为 4 且全在 reduced-motion 内(同口径复跑脚本可复现) | +| 2 | 430 顶栏项目名 | **APPROVED** | `PipelineConsole.tsx` 一处(+53/−5,其中 25 行是决策注释):受控 `Tooltip` 提供 Hover/Focus 提示,Touch 走概况抽屉;只在 `scrollWidth` 真的溢出时才弹;**触屏档按 `matchMedia('(hover: hover)')` 根本不弹**(§2.2.1——复跑证明「抽屉展开即收回」挡不住 `mouseEnterDelay` 的 100 ms 定时器) | 430 `truncated:true` 且 **accessible name 为完整名**(CDP `getFullAXTree`);Hover/Focus/Touch/Click **四通道分档实测**(§2.2.1 表):430 触屏 `tip_visible:false` 且抽屉标题=完整名,430 桌面窄窗 Hover 与 `:focus-visible` 各自 `tip_visible:true`,768/640/900/1440 `truncated:false` ⇒ **不弹**;`stray_tooltips` 1→**[]**;顶栏子元素 x 区间未变(操作区没被挤压) | +| 3 | 六张窄屏违规表 | **APPROVED** | 新增共享开关 `useNarrowTable()`(`components/ui/Table.tsx`)+ 9 张表逐表两套 columns(`Dashboard` `Dispatch` `Review` `Timeline` `Delivery`);宽档列**一字未改** | `tableaudit` 430:**HEAD 违规 6 张 → 工作树 0 张**,576/768 同 0;1440 输出与 HEAD **逐字节相同**(仅时间戳差异);数据完整性按 token 对账:补丁后 ⑥失踪 **3→0**、③失踪 **9→2**(两次复跑读到的都是实时耗时计时器,值每次都在变大 ⇒ 漂移不是隐藏)、②④⑤⑦ 恒 0(`03-tables/DATA-INTEGRITY.txt`) | +| 4 | 第 9 闸语义检查 | **APPROVED** | 新增 `scripts/ui/semanticcheck.py`(1062 行 · 7 条判据 · CDP AX + 真键盘);`gateprobe` +89/−8 行反向验证;`nex.config.yaml` 登记为常驻闸门;**咬到的 4 类真缺陷全部就地修复**(`AudioPlay` `MediaLightbox` `AssetLibrary` `app.css`) | HEAD `semanticcheck` 1440 **EXIT=58**(NAME 20 / HOTSPOT 16 / TAB 16 / FOCUS 6)→ 工作树 **EXIT=0**;`GATEPROBE_OK 14/14` | +| 5 | 导航状态治理 | **保持分离设计** | 代码零改(折叠 `useLocalStorage` / 抽屉 `useState` 维持原样),理由写进 `docs/UI规范.md` §6.2.1;顺手关掉实测发现的 AT-2(`AppSider.tsx` 补 `aria-current="page"`,+18/−5 含注释) | 折叠:reload 后 `ls="true"`、侧栏 63px;抽屉:`localStorage` 键集为空、reload 后 `open:false`;`aria-current` 三条路由 + 抽屉内**有且只有当前项**带它,菜单宽度 207 未变;折叠成图标轨时二级项不渲染(弹层展开后恢复有名)——边界已写清并登记 **S-4**(`05-nav/ARIA-CURRENT.txt`) | +| 6 | UI chunk | **先分析 → 实施 0 处** | 零代码改动。新增测量脚本 `scripts/ui/chunkinfo.mjs`(按映射区间计字节) | 首屏 before/after(HEAD 两次 / 工作树三次构建,抖动 ≤0.25 kB):1486.24~1487.46 kB raw(**+0.9~1.2**)/ 453.87~454.45 kB gzip(**+0.4**)/ 370.90~371.58 kB brotli,增量来自第 3 项的两套列定义;首屏文件数 7 → 7(没多一个请求);13 条路由**已经全部** `lazy()`;`ui-*.js` 1187.8 kB 是 rolldown 自动分组,不是本项目的手工分包决策 | +| 7 | N14 真实读屏 | **MANUAL QA REQUIRED** | 零代码改动(键盘操作与「前移 / 后移」按钮原样保留)。产出真实 AT 会话记录:`07-screen-reader/`(149 条 VoiceOver 实播报 + 环境取证 + 24 行记录表 + 人工复测脚本) | VoiceOver + Safari 18.3 + macOS 15.3 **实跑**:13 步 PASS、3 步部分通过(新缺陷 AT-1 图标字形名外泄)、4 步待人工;**NVDA + Chrome 本机无 Windows 环境,未执行** ⇒ 见 §7 | + +**一句话结论**:七项里没有一项需要动布局、动业务流程或动技术栈;真正改变屏幕的只有第 3 项(窄屏 <992 的表格重排,宽档逐字节不变)和第 2 项(顶栏多出一层只在截断时出现的提示)。收口阶段被自己的复跑闸揪出两处「改完还在」的缺陷——触屏 Tooltip 幽灵气泡(§2.2.1)与 ③⑥ 两张表漏并的数据(§3.4)——两处都在本轮内改成最终修法并用同一把探针复跑归零。第 4 项把「源码字符串齐全但辅助技术读不到」这一整类缺陷变成了会红的闸,并且在第一天就咬出 4 类 58 条真实缺陷——全部就地修好,退出码回到 0。 + +**验收状态:阶段 8 不能标记为完全验收通过。** N14 的真实读屏验收只完成了 VoiceOver 一档的一半(NVDA 未执行、⌥↑/⌥↓ 在 AT 下的播报未复听),本轮按授权书 §7 明记 **MANUAL QA REQUIRED**,不宣称通过。 + +--- + +## 1. CSS Layer 治理 — 决策 DEFERRED + +### 1.1 现状:全站样式怎么组织 + +| 入口 | 行数 | 层归属 | 内容 | +|---|---|---|---| +| `styles/index.css` | 220 | 声明层序 `@layer theme, base, components, antd, utilities` | Tailwind `theme.css`→`theme` 层、`preflight.css`→`antd` 层、`utilities.css`→`utilities` 层;`@theme` 块 1 个(Token 出口)、`@utility` 2 条(`scrollbar-slim` / `scrollbar-none`)、`@custom-variant light` | +| `styles/app.css` | **839** | **整文件未分层**(`@import "./app.css"` 不带 `layer`) | 141 条规则 / 199 条选择器分支:132 条含 `.nex-*`(其中 4 条是 `.ant-btn:has(> .nex-…)` 这类给 antd 收口的)、40 条纯 `.ant-*` 覆写、18 条元素级复位、9 条全局伪类。`@layer` 声明 **0** 条,`@media` 1 处,`@keyframes` 2 组,`!important` **4 处且全部落在 `@media (prefers-reduced-motion)` 内** | + +口径与全量输出可复跑:`NEX_SRC=<文件> NEX_LABEL=<标签> .venv/bin/python /private/tmp/nexd/csscensus.py`(剥 `/* */` → 按花括号配对逐条取选择器 → 逗号拆分支;同时命中 `.nex-` 与 `.ant-` 只计 `.nex-` 一次),改前/改后同口径对照见 `reports/ui_evidence/nex-p8f/01-css-layer/census.txt`。 + +### 1.2 由此得出的层叠优先级(这是**现状设计**,不是意外) + +未分层的 `app.css` 优先于**所有**分层声明——包括 Tailwind 的 `utilities` 层。实际后果有两条,一条是我们一直在用的,一条是坑: + +1. **在用**:`.nex-*` 自绘表面因此稳定压过 utility 类,`theme/antd.ts → applyRootVars → @theme` 的 Token 才能被局部皮肤直接引用而不需要 `!important`。全站 `!important` 只有 4 处,全在减动效分支,说明这套「未分层皮肤」在实操里没有靠提权续命。 +2. **是坑**:反过来 **`max-md:hidden` 这类 display 工具类点不亮 `.nex-*`**(`.nex-tag.ant-tag{display:inline-flex}` 未分层 ⇒ 优先级更高)。这条已经被写成注释钉在 `PipelineConsole.tsx` 里,并被阶段 8 的 CDP 实测证实过一次。迁移到 `@layer components` 会让这 132 条规则的相对顺序整体反转——**影响面 = 全站**。 + +### 1.3 为什么 DEFERRED(三条依据,按批准书 §1「仅在存在可复现缺陷时局部修复」) + +| 依据 | 读数 | +|---|---| +| 没有缺陷堆积 | 120 状态像素回归 + 13 道常驻闸门全绿;`!important` 只有 4 处且语义正当(减动效),没有「靠提权打补丁」的症状 | +| 收益不可测量 | 迁移能换来的是「层叠可解释」,但本轮找到的唯一层叠类缺陷(§1.2 第 2 条)**已经用注释 + 一处 `:has()` 局部修复收口**;剩余收益要靠改 199 条分支去换,风险/收益倒挂 | +| 会撞上别的批准项 | 第 3 项的两套 columns、第 2 项的 Tooltip 都依赖现有皮肤的优先级形态。同一轮里既重排表格又重排层叠,出问题时无法归因 | + +**结论:DEFERRED 保持**。不迁 `app.css`、不引入新层、不批量重写 CSS。规范登记落点:`docs/UI规范.md` §1.1.2(含上表与「何时值得重启这项」的触发条件)。 + +### 1.4 本轮唯一动 CSS 的地方(可复现缺陷,属第 4 项咬出的 FOCUS) + +`frontend/src/styles/app.css` +11 行:`.ant-btn:has(> .nex-file-input:focus-visible) { outline: 2px solid var(--ant-color-primary); outline-offset: 2px }`。 +症状:Tab 停在「上传素材 / 导入脚本」这类整块上传按钮上,**屏幕上焦点环完全看不见**(`semanticcheck` FOCUS 硬档,明暗各 3 处)。根因是热区靠一层 `opacity:0` 的 input 铺满按钮实现,而 46 行那条把描边交回 antd token 的 `:where(...):focus-visible{outline:none}` 与 41 行的兜底描边同特异性、位置在后,连这颗透明 input 唯一的一圈描边也一起吃掉了。做法是把环改画在**看得见的按钮**上,颜色/粗细/offset 与 41 行既有兜底一致;用 `:has(> :focus-visible)` 而不是 `:focus-within`,否则鼠标点一下也会描边。未新增层、未新增 `!important`、未新增 Token 之外的颜色字面量。 + +### 1.5 未解决(登记不隐藏) + +- **L-1**:`.nex-*` 未分层导致 `max-*:hidden` 对自绘表面失效,目前靠「写注释 + 换写法」规避。彻底解法是把 `app.css` 归入 `components` 层并逐条复核 132 条规则的相对顺序,属独立一轮(估 1 个改动轮 + 全量 120 状态回归)。 +- **L-2**:`preflight.css` 被放进 `antd` 层是历史决定(让 antd 复位与自身组件同层),语义上更该在 `base`。同样属 L-1 那一轮一起判。 + +--- + +## 2. 430 顶栏项目名称 — 决策 APPROVED(单行省略号 + 完整名称提示) + +### 2.1 先量清「缺的是哪一条」 + +批准书要求四条:Hover、Focus、Touch、完整名保留在辅助技术名称里,外加「不许挤压顶栏操作区」。 +把 HEAD 放到 430 视口逐条量(`02-topbar-name/before-430-dark.json`): + +| 通道 | HEAD 实测 | 结论 | +|---|---|---| +| 单行省略号 | `name_w=86 / scrollW=178`、`lines=1`、`text-overflow:ellipsis`、`white-space:nowrap` | **本来就有**,不需要新增 | +| AT 可读全名 | CDP `getFullAXTree`:`role=button name="跨界斗地主 · 大漠客栈二番局 83%"`,`accessible_name_includes_full=true` | **本来就有**(名字本身在 DOM 里,只是被 `overflow:hidden` 裁掉) | +| Hover | `tip_on_hover={text:"跨界斗地主 · 大漠客栈二番局", opacity:"1"}` | **本来就有**(`Typography.Text ellipsis={{tooltip}}`) | +| **Focus** | **`tip_on_focus=null`** | **缺这一条**——antd 的 `ellipsis.tooltip` 只认鼠标,键盘 Tab 到胶囊上时屏幕上没有任何地方能读完这个名字 | +| 顶栏未被挤压 | `content_overflow=0`、`doc_scrollW=430=vw`、四颗子元素 x 区间 `[16,36] [52,84] [100,272] [288,414]` | **本来就没挤**,改后必须逐字节守住 | + +**所以这一项真正的缺口是键盘那一格**,不是「没有省略号」也不是「没有 tooltip」。按批准书「不得为了形式统一改动已验证布局」,落点选在**已有的那颗胶囊组件**(`app/layout/PipelineConsole.tsx`,它就是 project switcher),而不是新建一层提示或改 `AppHeader`。 + +### 2.2 改法(`PipelineConsole.tsx` +53/−5 行,其中 25 行是决策注释) + +- `Typography.Text` 的 `ellipsis={{tooltip}}` 换成**受控 `Tooltip`**:`trigger={['hover','focus']}`、`open={nameTip}`。 +- **只在真的截断时才弹**:`nameTruncated()` 在悬停/聚焦那一刻现量 `scrollWidth - clientWidth > 1`,不引 `ResizeObserver`、不给 Header 增加测量节点。名字读得完还飘一层同样的字是噪音。 +- **Focus 只认键盘**:`onFocus` 里 `matches(':focus-visible')` 为真才弹;鼠标点击胶囊(要开抽屉)不会在背后挂一层提示。`onBlur` 与 `Escape` 关闭。 +- **Touch 通道**:手机档点这一下本来就是「项目概况」的唯一入口,而抽屉标题 `ProjectBriefDrawer` 就是完整项目名——这条不改,只在注释里把它写成契约的第三条腿。 +- **本轮自己引入、复跑时才发现没修干净的缺陷**:触屏点胶囊会同时唤起 Tooltip 和概况抽屉,抽屉盖住提示、提示却留在背后。第一版修法(`useEffect(() => { if (briefOpen) setNameTip(false) }, [briefOpen])`)在 14:14 的数据完整性复跑里**没通过**,最终改法见 §2.2.1。 + +#### 2.2.1 复跑打脸:「抽屉一开就收提示」挡不住触屏气泡(14:20 最终修法) + +复跑读数(`03-tables/DATA-INTEGRITY.txt` 上一版 B 段):`stray_tooltips: ["跨界斗地主 · 大漠客栈二番局"]`。 +按事件序列重测(`02-topbar-name/p85_tip.py`,430 + `has_touch` + `is_mobile`): + +| 时刻 | 实测 | +|---|---| +| 事件顺序 | `pointerover:touch → pointerdown → pointerup → **mouseover** → focus → click` | +| `+300ms` | `aria-expanded=true`(⇒ `briefOpen` 到得了组件、effect 确实执行了),但 `.ant-tooltip` **没有** `ant-tooltip-hidden` | +| `+1600ms` | 同上;**Esc 关掉抽屉 +2.0s 之后气泡还在** | + +根因不是 effect 没跑,是**顺序**:antd Tooltip 的 `mouseEnterDelay` 默认 0.1s,触屏点按产生的那条兼容 `mouseover` 排了个 100ms 的「打开」定时器,它落在 click(→ `briefOpen` → 收提示)**之后**,把提示又顶开;手指不会离开按钮 ⇒ 永远没有 `mouseleave` ⇒ 再也没有下一次收口。 + +**改法:按输入能力收口,不按事件顺序打补丁。** `showNameTip()` 先看 `matchMedia('(hover: hover)')`,没有悬停能力的设备根本不弹这层提示(`PipelineConsole.tsx:166-169`);用 `hover:hover` 而不是 `pointer:coarse`,混合设备插上鼠标就还有提示。键盘档那条 `briefOpen` effect 保留(Enter 开抽屉时身后的提示该收),鼠标与键盘代码路径一字未改。三条通道从此各管各的输入设备:**Hover 归 Tooltip、Focus 归 Tooltip(`:focus-visible`)、Touch 归概况抽屉标题**。 + +四通道复测(`02-topbar-name/TOUCH-FIX-VERIFY.txt` + `p85_tip3.py`/`p85_tip5.py`;`tip_visible` = 存在没有 `ant-tooltip-hidden` 的 `.ant-tooltip`): + +| 通道 | 环境 | 动作 | `truncated` | `tip_visible` | 完整名称抵达处 | +|---|---|---|---|---|---| +| Touch | 430 触屏 | 点名字 | true | **false**(缺陷消失) | 抽屉标题「跨界斗地主 · 大漠客栈二番局」 | +| Hover | 430 桌面窄窗 | 悬停名字 | true | **true** | Tooltip 正文 = 完整名称 | +| Focus | 430 桌面窄窗 | Tab 到胶囊(`fv=true`) | true | **true**;Enter 开抽屉→false;Esc 关抽屉后焦点仍在胶囊,再按 Esc→false | 同上 | +| Hover/Focus | 768 / 640 / 900 / 1440 | 悬停 / Tab | **false**(三档同测均 false) | false | 名字整条读得完,不飘同样的字=不是噪音 | +| Mouse click | 1440 / 768 | 点胶囊 | false | false | 抽屉照常打开(业务交互未变) | + +同一份 B 段探针在 14:22 的最终代码上复跑:`stray_tooltips: []`。截图 `02-topbar-name/AFTER-430-keyboard-closed.png` = 430 键盘档最后一步:既无气泡也无抽屉。 + +### 2.3 改后实测(`02-topbar-name/after-*.json` + 同名 PNG,明暗各拍 Hover/Focus) + +| 视口 | `truncated` | Hover | Focus | blur 后残留 | 顶栏子元素 x 区间 | `content_overflow` | +|---|---|---|---|---|---|---| +| 430 dark | **true**(86/178) | ✅ 全名 | ✅ **全名(本轮新增)** | `tip_after_blur=null` ✅ | `[16,36] [52,84] [100,272] [288,414]` **与 HEAD 相同** | 0 | +| 430 light | true | ✅ | ✅ | null ✅ | 同上 | 0 | +| 768 dark | false(178/178) | 不弹 | 不弹 | null | 与 HEAD 相同 | 0 | +| 1440 dark | false | 不弹 | 不弹 | null | 与 HEAD 相同 | 0 | + +截图 10 张:`name-before-430-dark-{hover,focus}.png`、`name-after-{430-dark,430-light,768-dark,1440-dark}-{hover,focus}.png`。 +「不挤压操作区」的判据不是肉眼看的:顶栏四颗子元素的 x 区间逐条与 HEAD 对齐,`btn_scrollW==btn_clientW`(胶囊自身内部也无溢出)。 + +### 2.4 规范符合性 + +- 批准书 §2 四条全部满足(Touch 那条的最终载体是概况抽屉标题,不是 Tooltip——见 §2.2.1),且**没有新增视觉**:430 与 768/1440 的静态截图除提示层以外逐像素相同(第 8 项 120 状态回归中 1440/768 两档与基线同图)。 +- 未新增 `--nex-*` 变量、未新增 Token 之外的颜色、未新增组件库依赖(`Tooltip` 走 kit 已有的 antd 出口)。 +- `title` 上那句「流程进度 83% · 已完成 10/12 个节点 · 当前节点:…(点击展开项目概况)」保持不变——它是**进度**的抵达通道,与名字的省略号提示是两件事,不合并。 + +### 2.5 未解决 + +- **N-1**:430 顶栏在**项目名特别长**(>200px 额度)时省略比例更高,靠 `title` + Tooltip 兜住;如果后续产品要把「当前节点」也塞进 430 顶栏,得重新量一次额度,这一轮的结论不能外推。 +- **N-2**:Tooltip 的 `placement="bottomLeft"` 在最窄档会向左上折返(antd 自动翻转),本轮实测 430 不触发;换更窄(<380)视口需复测。 +- **N-3**:`canHover()` 之后,**纯触屏 + 外接键盘**(如 iPad + 蓝牙键盘)Tab 到胶囊时不再有 Tooltip,完整名称只剩「点按开抽屉」与辅助技术可访问名称两条通道。收窄是有意的,但本机没有该硬件,这条只按 `matchMedia` 分支推断、**未实机验证**,随 §7 人工脚本一起补。 + +--- + +## 3. 六张窄屏违规表格 — 决策 APPROVED(逐表方案,九张在册) + +### 3.1 根因 + +§13.2 那套列宽预算是按 1440 那把尺子算的(全宽表容器 **1118**)。同一份 `columns` 搬到窄屏,容器只剩 +**430→356、576→502、768→462、992→670**,而定宽列合计 400–902 不变 ⇒ 两种坏法:长文列被挤成 **0 宽**(成本台账「取值」列实测只剩 **14px**),或整张表拖一条横向滚动条(430 上去回滑一条成本记录 = 没有这条记录)。 +HEAD@430 `tableaudit`:**违规 6 张表**(`03-tables/head-tableaudit-430.log`,`EXIT=6`),横向溢出最大一条 **546px**。 + +### 3.2 总开关:`useNarrowTable()`,换列定义不换 DOM + +`frontend/src/components/ui/Table.tsx` 新增 `useNarrowTable()` = `Grid.useBreakpoint().lg === false`(<992)。页面写 `columns={narrow ? 精简列 : 宽档列}`。 + +- **为什么是 992**:侧栏 224 + 正文左右 48 之后,992 视口的表容器实测 **670**,是全站定宽预算放得下的最窄一档;992 以下只剩 502 / 462 / 356,而 **768 那一档比 576 还窄**(侧栏未折叠,正文被压到 462),所以三档窄屏共用一套精简列,不按 576/768 细分。 +- **为什么不用 CSS `max-lg:` 显隐**:要换的是**列定义**(少几列、格子合成几行),不是显示状态。两套 columns 只有一份在渲染,辅助技术才不会朗读到藏在 DOM 里的列(这条同时被第 4 项的 ARIA 判据支持)。 + +### 3.3 九张表逐表方案(宽档列一律未改) + +| # | 表 | 文件 | 选的方案(不统一,按数据特点) | 窄档列宽 | 行高 | +|---|---|---|---|---|---| +| ① | 项目列表 | `Dashboard.tsx` | 复用**已验证的项目卡片**,卡/表边界从 `max-sm` 推到 `max-lg` | 走卡片 | — | +| ② | 分镜任务清单 | `Dispatch.tsx` | 动作 Tag + 预估成本并入镜头行第 2 行,说明第 3 行 | 40/176/140 | 83 | +| ③ | 任务执行明细 | `Dispatch.tsx` | 9 列 → 3 列;状态与 stage 码进元信息行 | 148/128/80 | 83 | +| ④ | 审核留痕 | `Review.tsx` | 时间、类型·审核人、镜头合进首格三行 | 132/80/144 | 77 | +| ⑤ | 时间线版本 | `Timeline.tsx` | 版本号并入名称行、元信息第 2 行;宽档 `minWidth` 保留 | 144/84/128 | 59 | +| ⑥ | 成片记录 | `Delivery.tsx` | 规格/时长/大小第 3 行,耗时+校验和进 `title`;**缩略图保留**(唯一视觉凭证 + 预览入口) | 224/132 | 84 | +| ⑦ | 生成记录 | `Delivery.tsx` | #/类型/镜头/供应商进首列(重试次数 >1 才追加),成本/时长/时间右列 | 124/144/88 | 81 | +| ⑧ | 计费明细 | `Delivery.tsx` | 标识首列 / 数量·单价中列 / 金额·时间右列 | 124/136/96 | 59 | +| ⑨ | 成本台账 | `Delivery.tsx` | 维度 + 取值合并 / 金额 + 记录数右列 | 244/112 | 59 | + +方案分布对照批准书 §3 给的六个选项:**优先级列显示 + 次要列隐藏并格**(②③④⑤⑦⑧⑨)、**长文本完整内容提示**(全部长文列 `Clamp` + 原生 `title`)、**卡片式记录**(①——站内已有成熟卡片,不新造)、**行内操作合并**(⑥⑨ 右列收成一颗主操作 + `title` 兜住次要项)。 +**没有一张表用「横向滚动」当唯一答案**,也没有一张表只是把容器改宽。⑧⑨ 开发库无数据、探针看不见,用 `page.route` 伪造 `/api/projects/*/costs` 量出来的:改前 ⑨「取值」列 **14px**、⑧ 溢出 **456**。 + +窄档长文列下限 **≥120px**(宽档 ≥200):窄档容器只有 356,200 会挤死动作列;120 是实测「中文两行还能读出主干」的最窄值,低于它必须靠 `Clamp` + `title` 兜完整内容。行高预算仍 **≤84px**(3 行 × 22),⑥ 那条 `mt-0.5` 从 86 回到 84 就是这么来的。动作列宽度按 §13.2 第 3 条公式实测:成片「预览 66 + 下载 40 + gap 8 + 内边距 16 = **132**」,估的 120 会折两排。 + +### 3.4 「数据没失踪」是量出来的,不是保证的 + +探针 `/private/tmp/nexd/p85_verify.py` A 段(读数 `03-tables/DATA-INTEGRITY.txt`):同一张表在宽档与 430 各加载一次,把宽档每格正文切成 token 集,逐条问「这个 token 在窄档还在不在」。**在**的判据 = 仍出现在可见正文里 **或** 出现在某一格的 `[title]` 完整内容提示里(`Clamp` 折行与 `title` 是 §13.2 已批准的口径)。 + +| 表 | 宽档行数 | token 数 | 首轮仍在正文 | 首轮进 `title` | 首轮失踪 | 补丁后失踪(14:14 / 14:22 两次复跑一致) | +|---|---|---|---|---|---|---| +| ② 分镜任务清单 | 14 | 203 | 203 | 0 | **0** | **0** | +| ③ 任务执行明细 | 61 | 1021 | 717 | 226 | **9** | **2**(仍是漂移,见下) | +| ④ 审核留痕 | 33 | 995 | 995 | 0 | **0** | **0** | +| ⑤ 时间线版本 | 1 | 11 | 11 | 0 | **0** | **0** | +| ⑥ 成片记录 | 3 | 78 | 51 | 24 | **3** | **0** ✅ | +| ⑦ 生成记录 | 43 | 7954 | 7954 | 0 | **0** | **0** | + +补丁后 ③ 的 `still_visible` 从 717 涨到 **789**(+72 个 token 正是「追加状态中文 + stage 码」补回来的那批),`in_full_hint` 226 不变。剩下 2 条失踪在 14:14 与 14:22 两次复跑里分别是 `["955630.4s","959869.9s"]` 与 `["956252.9s","960492.3s"]`——**每次读数都在变大**,所以它们是实时耗时计时器,不是被隐藏的数据(陷阱 ①)。`03-tables/DATA-INTEGRITY.txt` 存的是最终代码那一次(14:22,含 `canHover()` 收口后的 B 段 `stray_tooltips: []`)。 + +两个真实缺口与修法(这是本轮后半段唯一新增的两处业务代码改动): + +| 表 | 缺什么 | 怎么补 | 为什么这么放 | +|---|---|---|---| +| ③ | 宽档「任务」列第二行的**类型中文 + stage 码**(`配音 · voiceover`、`资产处理 · asset`、`时间线合成 · compose`、`质检 · quality_check`、`调度 · dispatch`,共 5 组)+ 2 条实时耗时读数 | 窄档元信息行**追加** ` · ${状态中文} · ${stage}` | 该格 `line-clamp:1`、实测 `scrollHeight 60 / clientHeight 20`:**只有开头约 12 个字符能露出来**。所以「前置」等于把「进度 100%」换成一个 stage 码,是拿已有数据换新失踪数据;**追加**则是零视觉增量的「补齐」。(2 条耗时读数是两次加载之间任务还在跑造成的漂移,不是隐藏。) | +| ⑥ | 宽档首列的**导出编号** `65 / 78 / 79` | 名称行改成 `#编号 名称` 同行显示(`#{id} {name}`),`title` 同步为 `#id 名称` | 加一整行会把行高从 84 顶到预算外(这一档行高正好卡在 ≤84 上限);同行前缀与 ③⑦ 已有的「编号 + 名称」写法一致,实测行高仍是 84 | + +**两个测量陷阱**(写进规范,避免下一轮误判):① 耗时/进度类**实时值**在两次加载之间会变,不能按字符串等值判失踪,否则「漂移」会被当成「隐藏」;② `line-clamp` 是按**高度**裁的,不是按宽度——所以不能靠「文本还在 DOM 里」宣称数据可见,必须量 `scrollHeight/clientHeight` 推算真正露出的字数。 + +### 3.5 红线自证(批准书 §3 六条禁令逐条) + +| 禁令 | 自证 | +|---|---| +| 不得统一采用单一处理方案 | 九张表六种组合(§3.3),只有「长文 `Clamp` + `title`」是共用的兜底层 | +| 不得隐藏重要业务数据 | ③④⑤⑥⑦② 六表 token 对账(§3.4);两处缺口已补 | +| 不得仅扩大容器宽度 | 窄档容器与 HEAD 相同:430→**356**(`tableaudit-*-postfix` 与 HEAD 日志同值),未动侧栏/正文内边距 | +| 不得放宽 tableaudit 规则 | `ROW_H_MAX` 默认 84 未改、`NEX_SCROLL_SLACK` 未调;本轮两次表格运行都吃**默认阈值** | +| 保持键盘访问 | 第 4 项 `semanticcheck` 在 430 复跑:HEAD `timeline 热区 hard 7 / Tab 不可达 7` → 工作树 **hard 0**(并格后的操作是 antd `