Appearance
🎨 太白 @lintaibai UI
太白 UI —— 天工开源项目的统一 UI 组件库,采用 shadcn/ui 模式,把组件源码直接复制到你的项目里。
📦 项目简介
太白 UI 是天工开源项目沉淀的统一 UI 组件库,覆盖 Vue3 / React 等主流框架,提供一致的视觉风格和交互体验。
✨ 核心特性
- 🎨 统一风格:跨框架一致的视觉规范和交互体验
- 🧩 多端适配:Web / App / 小程序 一套设计体系
- ⚡ 开箱即用:按需引入,组件即文档
- 📦 主题定制:CSS 变量驱动,快速换肤
💡 设计初衷
为什么要做统一的 UI 组件库?
- 🔸 各端组件风格不统一,维护成本高
- 🔸 重复封装相同组件,浪费时间
- 🔸 业务组件无法复用,扩展性差
目标:一套设计体系,多端一致呈现,沉淀天工全栈生态的组件资产。
⚙️ 工作原理
太白 UI 采用 shadcn/ui 模式——不安装整个组件库,而是把你需要的组件源码直接复制到你的项目里,你拥有完全控制权。
用户执行: npx @lintaibai/ui add button
↓
CLI 临时安装 @lintaibai/vue 到临时目录
↓
从 node_modules/@lintaibai/vue/src/components/button/index.vue 读源码
↓
把源码写入用户项目的 components/ui/button/
↓
删除临时安装的 @lintaibai/vue核心优势:
- ✅ 组件源码直接放进你的项目,可随意修改
- ✅ 组件库更新了,CLI 自动跟着更新,不用维护两套模板
- ✅ 按需安装,用哪个装哪个,不打包多余代码
- ✅ CSS 变量驱动,跨组件风格一致
🚀 快速开始
安装组件
bash
# 自动检测项目框架(Vue/React)
npx @lintaibai/ui add button
# 手动指定框架
npx @lintaibai/ui add button vue
npx @lintaibai/ui add button react生成的文件结构
你的项目/
└── components/
└── ui/
└── button/
└── index.vue # 或 index.tsx📦 支持的框架
| 框架 | 包名 | 状态 |
|---|---|---|
| Vue3 | @lintaibai/vue | 迭代更新 |
| React | @lintaibai/react | 规划中 |
🧩 可用组件
| 组件 | 说明 |
|---|---|
| button | 6 种变体按钮 |
| input | 输入框 |
| dialog | 对话框 |
| tabs | 标签页 |
| card | 卡片 |
| badge | 徽标 |
| tag | 标签 |
| switch | 开关 |
📁 项目结构
packages/
├── taibai-shared/ # 共享样式与工具
├── ui-taibai-vue/ # Vue 组件库源码
├── ui-taibai-react/ # React 组件库源码(规划中)
└── ui-cli/ # CLI 安装工具
├── cli.js
└── templates/