nex_animation/reports
mula.liu 4521c9f926 前端统一到 React 18 + Ant Design 5 + Vite + Zustand + React Router 6:控件不再在原生件上缝皮,Radix 那一层整体换成 antd 标准件 + 一层自有 kit,并把「谁定义控件」收口成词汇表。
用户连着三轮指出「字段标题、控件不对齐」「下拉控件的样式不对」,最后点名技术栈。真正的病不在
antd 还是 Radix,而在同一件事有三千种写法:左导航内边距一页 11px 一页 12px,白名单要从页面
className 上抄切片才能命中。上一轮 Radix 只外包了行为,皮肤仍由 30 多个页面自己拼,且没有任何
机制阻止分叉长回来。这一轮改的是词汇表:页面只准说业务,控件怎么长由 kit 层 + 一份令牌说了算。

底座(读数见报告 26.2):react 19.3.1→18.3.1、react-router-dom 7.18.5→6.30.6(点名为 18/6,是
降级,代价见 26.6)、新增 antd 5.29.3 + @ant-design/icons 6.3.4,@radix-ui/* 5 包与
class-variance-authority 清零;zustand/vite/tailwindcss 4.3.3 不变,Tailwind 留作皮肤 utility。
删 components/primitives/(11 文件 1133 行)与 styles/{base,tokens}.css;净 +488 行不是「少一千行」,
是同样面积的代码从三十个页面挪进两个目录——省的不是字节,是分叉次数。

新增:
- app/providers.tsx:ConfigProvider + <App> 唯一入口(主题、zh_CN、button.autoInsertSpace:false、cssVar),
  命令式 message/notification/modal 挂 antdApi 供 stores/ 使用;React Router 的 v7 future flag 一处收口。
- theme/{palette,antd,css-vars,metrics}.ts:数字只有一个来源 metrics.ts → 同时喂 antd ThemeConfig 与
  --ctl-h-*/--radius-*/--text-*,antd 控件与自绘区读同一把尺子,结构上长不歪了。
- components/ui/{Input,Checkbox,Menu,Rail,Tile,Overlay,field-labels};lib/layers.ts(Esc 先看有没有 antd
  浮层压着,否则分镜检查器里关一个下拉整层抽屉一起没)、lib/ref.ts、hooks/use-narrow.ts(触摸档必须
  同时喂给 antd 的 JS 数字,否则 560/430 一屏混着 31/38 与 36/40 两把尺子——首跑量出的 61 项就这么来的)。
- styles/app.css 接替 base+tokens,只留元素默认值与三处必须靠 CSS 的 antd 集成。
- scripts/ui/ 三件套首次入库:audit.py 七项机器判据 × 14 视图、vocab.py 六条源码词汇表闸、metrics.py。

修掉四个探针全绿也看不见的静默 bug:
1) 探针会假绿:浮层用例找不到抽屉时兜底 scope=main 把页面重量一遍,分镜「检查器」29 字段/57 输入
   /35 按钮(在 main 外面的 aside 里)一条都没测过。
2) Select 选中 null 回显成灰色 placeholder:antd 把 null 当无值,而「不绑定/无台词/未指定」的真实值
   就是 null(接口收 null,10 处)。kit 内折哨兵 nex-null,出入口各折一次,页面 API 一字未改。
3) JSX 子节点上的 /* */ 不是注释而是文本,挂在应用外壳之上把整站下推约 30px;移到 JSX 外并立词汇表规则 6。
4) 抽屉可以整块开在屏幕外面:Overlay 用 getContainer={false} 让 antd 就地渲染,rootStyle 的 absolute
   于是相对文档定位——入口按钮在折叠线以下时抽屉 y=-scrollY(1440 lib_edit 只剩 201px,430 assets_gen
   完全不可见,用户点了「AI 生成」像没反应)。改 fixed 后四档 10 个浮层全部 y=0 完整可见。为此给 audit
   加第 7 项判据 surface(浮层完整落在视口内 + 中心点 elementFromPoint 命中自己),反向验证:改回
   absolute 后 430 下 4 红 exit=1;判据取「有交集」太松(42px 也算过),收紧为「完整在视口内」才对。

验收(复跑读数):audit --only page 1440/1280/900 × 明暗 6 组 84 行视图全 0、exit=0;--only overlay
1440/900/560/430 × 明暗 8 组 exit=0,surface 80/80 绿,72 个下拉样本 popW==trigW、inViewport、
optClipped=false、popOnTop=false 计 0;vocab 85 文件/皮肤常量 79(账实相符)exit=0;
npm run build(tsc+vite)exit=0(ui chunk 881.94 kB / gzip 278.63);probe_nullopt CLEAN、probe_secretref PASS。

文档同步:UI规范 §8 判据清单五项→七项(补 surface)、§1.3 新增「抽屉可以整块开在屏幕外面」;
工程规范 §1.1 体检器职责改为 10 浮层 × 4 宽度 × 七项;README 六项→七项判据;报告补第二十六章
26.1–26.9(选型换向、版本读数、四条根因、改法、逐项验收、降级代价、注释泄漏、仍未做、抽屉开在屏外)。
2026-11-02 21:57:13 +08:00
..
UI审计与调整-2026-10-26.md 前端统一到 React 18 + Ant Design 5 + Vite + Zustand + React Router 6:控件不再在原生件上缝皮,Radix 那一层整体换成 antd 标准件 + 一层自有 kit,并把「谁定义控件」收口成词汇表。 2026-11-02 21:57:13 +08:00
验收报告-深夜面馆 · 最后一盏灯-2026-10-26.md v 0.1.0 2026-11-01 16:18:07 +08:00
验收报告-跨界斗地主 · 客栈牌局-2026-10-26.md v 0.1.0 2026-11-01 16:18:07 +08:00