diff --git a/docs/style-system.md b/docs/style-system.md new file mode 100644 index 0000000..2321f14 --- /dev/null +++ b/docs/style-system.md @@ -0,0 +1,100 @@ +# OpenCloud 样式体系 + +这套体系用于让视觉规则集中、Vue 模板可读,同时保留 Tailwind 对一次性布局的灵活性。它不是“所有样式都写成全局类”,而是把会跨页面复用、带有产品语义或必须一致的规则集中管理。 + +## 分层 + +| 层级 | 文件 | 职责 | +| --- | --- | --- | +| 设计令牌 | `src/styles/tokens.css` | 颜色、字体、渐变、阴影、动效时长等稳定决策 | +| 基础规则 | `src/styles/base.css` | 页面基线、选中文本、全局圆角策略 | +| 组件规则 | `src/styles/components.css` | 页面 Hero、容器、表单、面板、按钮等共享语义类 | +| 第三方主题 | `src/lib/theme.ts` | Naive UI 的全局主题契约;值应与设计令牌保持一致 | +| 单组件样式 | Vue 文件的 `