Appearance
包体与接入方式
Lingxi UI 同时提供 ESM 按需入口和 IIFE 入口。Vue3 工程项目优先使用 ESM 按需入口;非工程化 Vue2 页面优先使用按能力拆分的 IIFE 包。
IIFE 体积基线
以下数据由 npm.cmd -w packages/lingxi-ui run size:dist 生成,基于当前 dist/ 产物。
| 产物 | 原始大小 | gzip 大小 | 推荐场景 |
|---|---|---|---|
lingxi-chat.iife.js | 476.64 KB | 162.00 KB | 基础聊天、输入框、消息列表 |
lingxi-file-preview.iife.js | 106.18 KB | 38.66 KB | PDF / OnlyOffice 文件预览 |
lingxi-visualization.iife.js | 11056.99 KB | 2397.63 KB | 富内容、脑图、知识图谱、表格 |
lingxi-ui.iife.js | 11637.97 KB | 2574.72 KB | 需要全部能力的兼容入口 |
对应 CSS:
| 产物 | 原始大小 | gzip 大小 |
|---|---|---|
lingxi-chat.css | 88.30 KB | 13.09 KB |
lingxi-file-preview.css | 10.65 KB | 2.21 KB |
lingxi-visualization.css | 257.28 KB | 49.93 KB |
lingxi-ui.css | 387.47 KB | 68.93 KB |
依赖边界
lingxi-chat.iife.js 不包含文件预览、脑图、知识图谱、表格和富内容渲染能力。Vue2 老系统只接入聊天时应加载 lingxi-chat.iife.js 和 lingxi-chat.css。
lingxi-file-preview.iife.js 保持 pdfjs-dist 为 optional runtime import。使用 PDF 能力时,业务侧仍需确保 PDF 运行时资源可用。
lingxi-visualization.iife.js 包含富内容、脑图、图谱和表格相关能力,体积接近全量包。它适合可视化工作台页面,不建议作为普通聊天页默认依赖。