From 83d262a199808ee75159aefd193a03dad0413e29 Mon Sep 17 00:00:00 2001 From: "mula.liu" Date: Mon, 2 Nov 2026 16:17:20 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=87=E6=A1=A3=E6=8A=8A=E9=80=89=E5=9E=8B?= =?UTF-8?q?=E5=86=B3=E7=AD=96=E3=80=81R7=20=E4=B8=8E=E6=8E=A2=E9=92=88?= =?UTF-8?q?=E5=8F=A3=E5=BE=84=E5=86=99=E6=AD=BB=EF=BC=9AUI=E8=A7=84?= =?UTF-8?q?=E8=8C=83=E6=96=B0=E5=A2=9E=20=C2=A70.6=E3=80=8C=E6=A0=87?= =?UTF-8?q?=E5=87=86=E6=8E=A7=E4=BB=B6=E7=BB=84=20=3D=20Radix=20primitives?= =?UTF-8?q?=20+=20=E8=87=AA=E6=9C=89=E7=9A=AE=E8=82=A4=E3=80=8D=EF=BC=8C?= =?UTF-8?q?=E6=8A=A5=E5=91=8A=E8=A1=A5=E7=AC=AC=E4=BA=8C=E5=8D=81=E4=BA=94?= =?UTF-8?q?=E7=AB=A0=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit UI规范.md:§0.6 一次讲清四层分工(尺子 tokens.css / 行为 primitives / 皮肤 layers.ts / 语义 ui+forms)、 否掉 antd-MUI-Arco 的三条量化理由(两套尺子、preflight 抢深浅主题、深色皮肤要覆盖八成)、 以及规矩(页面与 ui/ 不许直接 import @radix-ui/*、新浮层必须先在 primitives 落原语再登记、 层级只用一套、Esc 先看 floatingLayerOpen()、Content 上写 fixed 会让 Radix 量到 0 高)。 另立「两个咬过人的陷阱」:① [&>*]:min-w-0 与 min-w-(--label-w) 特指度平票会无声清零标签下限; ② Playwright 的 locator.click() 先做 DOM.scrollIntoViewIfNeeded 把目标居中, 「开抽屉把页面顶回顶部」就是这么造出来的假 bug——量滚动位移前基线必须在 scroll_into_view_if_needed() 之后取。 硬规则从六条升到七条(R6 从「不用裸 select」扩成「控件不用浏览器原生外观」,新增 R7 字段形态唯一); §0.5 对照表补 Checkbox/Slider/Popup/Menu/Dialog 与 floatingLayerOpen 六行;§3 的 hint 栅格写法 从 grid-cols-[auto_minmax(0,1fr)] 更新成 minmax(var(--label-w),max-content)_minmax(0,1fr); §8 登记 align4(五判据各 0 组)与 ctl4(31 项)为新口径。 工程规范.md:§1.1 依赖链插入 components/primitives/ 这一层(附「一个用户就进,不等第二个用户」的例外), 扩展点加「加一类控件行为」一行,§4 补依赖卫生判据:grep 出的 import 集合必须等于 package.json。 README:分层表加 primitives/ 一行,并写清「不引成套组件库」的结论与 5 个 radix 包全部有 import。 报告第二十五章:现象归因表(对齐是 CSS bug、下拉与原生外观才是组件库该管的)、选型对照表、 三个根因的读数、逐项验收表(30 字段五判据 0 组、31/31、原生残留 0、13 装 6 用 → 5 装 5 用), 以及仍然没做的四条(MediaLightbox/RecordAudio 自绘 overlay、检查器刻意非模态、Tabs/tooltip 无用户先卸包、 日期与命令面板按需再补)。 --- README.md | 10 ++- docs/UI规范.md | 116 +++++++++++++++++++++++++++-- docs/工程规范.md | 18 ++++- reports/UI审计与调整-2026-10-26.md | 111 +++++++++++++++++++++++++++ 4 files changed, 244 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 202c7a0..4c964eb 100644 --- a/README.md +++ b/README.md @@ -49,10 +49,11 @@ media/ 产物库(MEDIA_ROOT) models/ whisper 词级对齐权重 r api/ 唯一的 fetch 出口:信封自动拆包、detail 统一成 Error、401 跳登录 app/ 应用外壳:router.tsx 路由表(唯一一份)· layout/ 顶栏侧栏鉴权闸门 pages/ 页面与项目页签,一屏一文件;页面私有的类名常量/子组件留在文件底部 -components/ 无业务语义的原语,三个目录按职责分: +components/ 无业务语义的原语,四个目录按职责分: ui/ 版式与控件(Button/Field/Ctlbar/Table/Modal/Drawer/Tag…) forms/ 选择器族(Select/MultiSelect/SecretInput + toOptions) media/ 带全局状态的媒体件(MediaThumb/AudioPlay/MediaLightbox/WorkflowBar…) + primitives/ 控件行为层(Radix primitives + CVA 皮肤:Popup/Dialog/Menu/Checkbox/Slider) stores/ zustand 切片:auth · theme · notice · project · models · system · audio · preview hooks/ use-async / use-polling / use-auto-refresh / use-outside-click / use-local-storage lib/ 纯函数与适配器:cn · format · media · pipeline · recorder · versions @@ -62,6 +63,13 @@ styles/ tokens.css(设计令牌 = 唯一尺子来源)· base.css(元 新增页面只做三件事:在 `pages/` 落文件 → 在 `app/router.tsx` 注册 → 复用 `components/*` 原语, 缺原语就补进 `components/`(不要复制粘贴样式)。加一类新母版/新页签同理:改表不改逻辑(见 `docs/工程规范.md` §1.1)。 +**控件不引成套组件库**(antd / MUI / Arco 都否掉了):行为层统一用 **Radix UI Primitives**, +皮肤层是自己的一套令牌(`styles/tokens.css` + CVA),即 shadcn/ui 的架构、但不带第三方皮肤—— +组件源码在 `components/primitives/` 里可直接改,深浅两套 studio 视觉不用跟组件库的默认 token 抢方向盘。 +因此 `package.json` 只有 5 个 `@radix-ui/*`(popover / dialog / dropdown-menu / checkbox / slider), +且每一个都有 import;页面里不许出现裸 ``**:单选 `Select`、多选 `MultiSelect`(`components/forms`);自动刷新类组件不放「立即刷新」按钮 | 全站历史问题 | +| R6 | **控件不用浏览器原生外观**:``(R6 禁用) | ``(R6 禁用) | ``(R6 禁用) | ``(Radix Checkbox,`role=checkbox`,点文字也切换) | `ui/Controls.tsx` · `primitives/Checkbox.tsx` | +| 原生 ``(R6 禁用) | ``(Radix Slider,键盘方向键可调) | `ui/Slider.tsx` · `primitives/Slider.tsx` | +| 裸 `