包使用概览
Lumal 按职责拆包。应用只消费 公开 exports 入口 与样式路径，不要依赖 packages/*/src 或测试内部文件。
本组文档对应已发布版本 0.0.4-beta；安装时显式指定版本并保持所有 Lumal 包同版。版本变更与发布方式见 更新日志。
选型建议
| 场景 | 推荐包 |
|---|---|
| 后台壳、布局、权限、表单表格 | @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@^3.5 vue-router@^4.5 element-plus@^2.11 @iconify/vue@^5
pnpm add @lumal/core@0.0.4-beta @lumal/icons@0.0.4-beta @lumal/icons-vue@0.0.4-beta
# 按需
pnpm add @lumal/charts@0.0.4-beta echarts@^6 vue-echarts@^8
pnpm add -D @lumal/vite@0.0.4-betaPinia 按应用需要安装。纯服务接入优先使用 @lumal/core/minimal / request，无需 Element Plus；UI 入口需安装对应 peer 与样式。
开发工作区内的新功能时使用 workspace:* 或 file:，不要把未发布 API 当作 npm 同版能力，见 安装与版本。