包使用概览
Lumal 按职责拆包。应用只消费 公开 exports 入口 与样式路径，不要依赖 packages/*/src 或测试内部文件。
选型建议
| 场景 | 推荐包 |
|---|---|
| 后台壳、布局、权限、表单表格 | @lumal/core + icons 系列 |
| 后台图表工作流 | @lumal/charts |
| 大屏边框 / 装饰 / 飞线等 | @lumal/datav |
| 可编排驾驶舱布局与 Designer | @lumal/cockpit（+ 可选 datav） |
| Vite 自动导入 / monorepo alias | @lumal/vite |
| 从 Vben 迁移 | @lumal/vben-compat |
| 快速起项目 | create-lumal-admin |
包卡片
| 包 | 说明 | 文档 | 本地路径 |
|---|---|---|---|
| @lumal/core | 安装器、布局、路由权限、请求、主题、Schema 组件 | 在线文档 | packages/core |
| @lumal/icons | 框架无关图标内核 | 在线文档 | packages/icons |
| @lumal/icons-vue | Vue 图标组件 | 在线文档 | packages/icons-vue |
| @lumal/charts | ECharts 图表与面板 | 在线文档 | packages/charts |
| @lumal/datav | DataV 风格可视化组件 | 在线文档 | packages/datav |
| @lumal/cockpit | 驾驶舱编排框架 | 在线文档 | packages/cockpit |
| @lumal/vite | Resolver 与 workspace alias | 在线文档 | packages/vite |
| @lumal/vben-compat | Vben 常用 API 兼容 | 在线文档 | packages/vben-compat |
| create-lumal-admin | 脚手架 CLI | 在线文档 | packages/create-lumal-admin |
npm 包地址与安装方式见 安装与版本。
安装顺序（典型 Admin）
bash
pnpm add vue vue-router pinia element-plus
pnpm add @lumal/core @lumal/icons @lumal/icons-vue
# 按需
pnpm add @lumal/charts echarts vue-echarts
pnpm add -D @lumal/vite未发布到 npm 时使用 workspace:* 或 file:，见 安装与版本。