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` | +| 裸 `