mula.liu
|
ee17358182
|
feat(前端): 阶段 9–45 呈现层落地——环节资产同构、图标两级表、kit 分包与四处交互收口
这一提交是 NEX 阶段 9–45 里所有**业务呈现层**的落地(不含探针与文档)。
三把尺子里只碰了 `styles/index.css`/`styles/app.css`,`theme/antd.ts` 一字未动;
不升级、不换库、不引入第二套 UI 组件包,业务页仍然不直接 import antd(R8)。
主线:
- 环节「资产管理」与平台资产库呈现层同构(阶段 44):`pages/project/Library.tsx`
换成与 `pages/AssetLibrary.tsx` 同一套 kit 骨架——PageHead / StatGrid /
Tabs+counts / Panel / Ctlbar `cols={5}` / ChipBar / Grid+Tile pick / MediaThumb /
Drawer;摘要尺上收为 `Tile.TILE_SUMMARY` 一处定义,两页共用,不再各写各的。
在册偏离见 `docs/NEX-对照与例外.md` E11(本页接口不收 `page`/`page_size`,
硬造前端切片是假分页;筛选条缺平台那两颗「状态」「排序」下拉,因为环节接口
根本不收 `status`/`sort`,补它们属于功能改动——待授权)。
- 项目总控台去掉「展开/收拢执行过程」那颗文字胶囊(阶段 44):折叠行本身
就是可点的语义元素,胶囊是同一动作的第二入口。口径写进 `UI规范.md` §13.14。
- 卡片动作收口(阶段 45):项目总览 / 环节资产 / 模型中心三处卡片上的动作
按钮按 `§5.1.2.1` 的尺子归位(32 档只属于页头与工具条独立动作,卡片内不再
混挂实底),`Ctlbar` 与 `Fields` 配套。
- 图标:登记表两级拆分落地(阶段 25)——`components/icons/core.ts`
(首屏外壳可达 54 只)/ `extra.ts`(只有懒页面要 24 只)/ `_kit.ts`(不含图形)/
`index.ts` 退化为只转发 core 的桶;边界由 `classaudit` 附三守。
`@ant-design/icons` 按嵌套包定价回落到 `^5.6.1`(阶段 26、27)。
- 分包:`vite.config.ts` 一条 `codeSplitting.groups` 只圈我们自己的四个目录
(components/lib/stores/api),`includeDependenciesRecursively: false` 是关键,
第三方怎么分块一个字不动。同一把 churn 实验:只改 `Input.tsx` 一个字符串,
改前 21 块里 20 块改名(用户多下 1 276 kB/gzip 390 kB),改后第三方大块
1 217 164 B 哈希不变,只有 `kit-*`/`index-*` 换名。
`frontend/chunk-budget.mjs` 的产物级预算基线 `chunk-budget.json` 随仓库走。
- S-2/S-3/T-1 的收口:图标默认为装饰 + 控件补自然中文名称、antd 语言包根因、
表单 id 关联新增 `ui/fieldId.ts`、离线告警宿主、交付面与窄屏表等(阶段 9–43 报告逐条)。
- `public/help/*.png` 是 `helpshots.py` 重新拍的 12 张手册插图(此前与实现漂移)。
提交前当场复跑静态四闸:`npm run typecheck` 0、`npm run build` 0(产物哈希与阶段 44
收工读数一字不差:`Library-0Ke7LMGG.js`/`AssetLibrary-DiALYoDN.js`)、
`node scripts/ui/classaudit.mjs` FAMILY 12 族全 0、`node scripts/ui/chunkbudget.mjs` 全 `ok`。
|
2026-11-12 10:21:29 +08:00 |
mula.liu
|
d853560fa7
|
前端按 Ant Design 规范重写:Header + 两级侧栏 + 页面内部页签,手写规范整体退场
外壳三段交还 antd:Layout.Header(56) / Layout.Sider 两级 Menu / Content。
全局多页签条(PageTabs + stores/tabs)删掉——内容页不做多 Tab,菜单只到两级,
指定项目的二级挂在「当前项目」下;页签回到页面内部:
资产 3 类、项目资产 4 面板、模型 4 能力、分镜 4 检查器。
Tabs(换看不同内容)与 ViewSwitch(同一批数据换排法)的判据写在 components/ui/Tabs.tsx。
删:theme/{metrics,palette,css-vars}.ts、icons/{Icon,glyphs}.ts、hooks/use-narrow.ts、
app/layout/{AppBar,SideNav,PageTabs,NoticeToast}.tsx、nav.ts、components/ui/Rail.tsx。
尺子只改三类(品牌色 / 表面色 / 少量结构性 token),几何、字阶、圆角、间距、断点
一律等于 antd 默认;图标全站唯一入口 components/icons/index.ts(语义登记表)。
一并收进本轮与并行线程查出的静默故障(tsc/build 全绿但页面是坏的):
- frontend/package.json 结尾的字面量 \n;line-height 被写成 px 让全站文字塌陷;
Tailwind v4 @layer 层叠反转(preflight 与 antd 收进同一层,R13)
- 值型控件的宽度预算错给了「标签 + 控件」整字段,23 处下拉当前值被省略号咬
(91>70 / 77>70 / 77>46)::has 规则把 flex-basis 交回内容 + 面板按内容加宽折行;
整句型选项值(时间线字幕/语音来源/原声策略、交付字幕)挂 nex-prose-value 显式登记
- ViewSwitch 传 block 把「全部素材」最后一个字裁掉半格;AgentConsole 一键指令双重省略号;
总览「下一步建议」按钮在 430 档捅出视口
- 时间线 / 交付页在没有版本时白调 /timeline 与 /timeline/report,两条 404 换来一片假绿
(先拿版本清单,清单为空就别问)
注:并行线程「迁移前端到React+Tailwind」在同一份工作区落了下拉档宽、下拉面板加宽折行、
上述时间线 404 闸门与浮层底部动作口径(R14),本 commit 一并收进,不代表那条任务已收尾。
|
2026-11-03 12:42:16 +08:00 |
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 |
mula.liu
|
670f4973e5
|
控件行为层选型落地:Radix primitives(headless)+ 自有皮肤,原生控件清零,字段标题同时被对齐。
用户问「要不要换一套标准控件组」。答:要,但只买行为不买皮肤——antd/MUI/Arco 自带 token(控件高 32px)
与我们的 --ctl-h-main(38px)并存就是两套尺子,再加一份 preflight 跟 Tailwind v4 base 层抢深浅主题,
而深色 studio 视觉本来就得覆盖八成,省下的工时会全数还回去。选定 Radix primitives + CVA 皮肤
(即 shadcn 架构,源码 vendored 在 components/primitives/),Radix 管 portal/定位/翻边/视口避让/焦点圈定与归还/
键盘/Esc 分层/锁滚动,尺寸配色仍只来自 tokens.css。
症状一:字段标题与控件不对齐,/review 同一列里控件左缘出现 1353/1425/1472 三种,最大右移 47.3px。
根因不是排版:Field 同时带 [&>*]:min-w-0(让长控件能收缩)与 min-w-(--label-w)(撑住标签列),
两条特指度都是 0-1-0,Tailwind 把 min-w-0 排在自定义值之后 → 66px 下限被无声清零,控件左缘跟着中文标签字数漂。
改法:下限换到压得住的选择器 [&>span:first-child]:min-w-(--label-w)(0-2-0),hint 栅格的标签列
从 auto 换成 minmax(var(--label-w),max-content);尺子补 --field-label-w:66px(全站 193 个行内标签的 p90)
与 --label-w 作用域开关(FormRow 抬起、Ctlbar/ChipBar/CardActions/Pager 压回 0,工具条不参与表单对齐;
≤560px 一行一个字段没有对齐对象,直接归 0)。
症状二:勾选框是 macOS 系统绿圆角块、滑杆是系统 range、分页还有个裸 select,深浅两版主题各长一个样;
「按一次 Esc,下拉连背后的抽屉一起没了」。改法:checkbox/range/menu/dialog 全部接进 primitives
(Checkbox 尺寸收成 --check-size 14px、触摸档 18px),每层浮层带 data-nex-layer,
页面级快捷键第一行 if (floatingLayerOpen()) return,层级只用一套(遮罩 100/抽屉 101/模态 111/下拉 400);
手写的 use-outside-click 删掉,外点关闭交给 Radix。依赖清单同步等于实际 import:卸载 8 个装了没在用的
@radix-ui/*(tabs/tooltip/label/separator/progress/radio-group/switch/visually-hidden),
顺带删掉这条死链上唯一消费它们的 ui/Toggle.tsx(0 个用户),现在 5 个 radix 包全部有 import。
实测:nex_align4.py 全站 30 个表单字段,五项判据(同列控件左缘不一致 / 标签压控件 / 控件溢出字段盒 /
行内标签与控件中心不齐 / 同列 stack-inline 混用)全 0 组、0 console error;nex_ctl4.py 31 项控件行为回归
31/31(抽屉+下拉叠加、Esc 只关一层、锁滚动不横跳、点文字切勾选、滑杆键盘可调、菜单方向键与焦点归还、
真实鼠标开关抽屉滚动全程守恒 101→101→101);源码里裸 select/checkbox/range 残留 0(grep 仅剩 3 条注释);
tsc --noEmit 与 npm run build 均 EXIT=0。
|
2026-11-02 16:17:09 +08:00 |
mula.liu
|
c5edd65d82
|
下拉控件迁入 Radix primitives:新建 components/primitives(Popup + CVA 尺子 + 共用 listbox 键盘 hook),Select/MultiSelect 全部改由 Radix Popover 接管浮层行为——面板宽度至少等于触发器、按最长选项展开到 440px 不再换行,两档触发器同字号同圆角,翻边/滚动/外点关闭交给 Radix;顺手修掉「点触发器自身关不掉面板」的 anchor 误判(Radix 把 handler 挂在真实被点元素上,原先的 currentTarget 比较恒真),并补上多选的首字母定位。表单公共 API 一字未改,页面 87 处调用零改动;旧的 use-popup/parts 手工定位已归档。
|
2026-11-02 14:46:44 +08:00 |
mula.liu
|
93abe0ce7b
|
迁移应用外壳:AppBar / SideNav / AuthGate / 路由 + 页面占位,全量 typecheck + build 通过
|
2026-11-01 16:48:29 +08:00 |
mula.liu
|
9467e1bb97
|
v 0.1.0
|
2026-11-01 16:18:07 +08:00 |