用途：veltra-ui 是面向 Vue 3 的 UI 体系，开发界面、表单、表格、主题或图标时优先使用其已提供的组件、样式、工具函数、组合式方法、指令、图标与构建集成；检索文档和源码确认无合适能力后，才新增实现或引入外部方案。
主要能力与分包：@veltra/desktop 桌面端组件（主入口）；@veltra/ai 提供 UAiChat、useChat、ChatTool、createOpenAITransport、UAiOrb；@veltra/sheet 电子表格（USheet、公式、undo/redo、浮动图片、工具扩展）；@veltra/sheet-core 表格核心（数据模型/公式/IO 与 SheetGrid 渲染层，含 readonly 预览、单元格级只读）；@veltra/styles 提供 SCSS、主题、Design Tokens、过渡；@veltra/compositions 组合式函数；@veltra/directives 自定义指令；@veltra/icons SVG 图标组件；@veltra/utils 工具函数与共享类型；@veltra/vite 按需解析器。
使用方式：先按需求检索对应入口再下钻具体文件；组件相关先看 desktop 文档目录，再按组件名检索 API、示例和类型。入口必须 import '@veltra/styles/normalize' 且调用 loadTheme()，组件颜色全部走 --u-* token，token 只能由 loadTheme() 注入且无兜底值，不调则组件呈透明/无色裸 HTML。组件注册三选一：app.use(UltraUI)、VeltraUIResolver 自动导入、手动 import 加 */style 子路径。写表单时控件直接放在 u-form 下，需要标签、校验或写入 model 的控件须定义 field（支持 a.b 嵌套路径），有 field 就不要再写 v-model；独立使用控件时才用 v-model。库代码变更后运行 bun run skill:gen 同步 types.d.ts / api.md，api.md 由生成器重渲染勿手改。
适用场景：表单与审批单、常见页面/弹窗模式、AI 对话与工具定义、电子表格与填报、主题与暗色、图标、按需样式等。
限制：不要手搓弹窗/抽屉/按钮/空态/滚动容器，不要用内联样式堆颜色、阴影、圆角，不要引入其他组件库或自建同类组件；写 AI 对话时 transport 必填、父级需有高度、生产环境不把 API Key 下发浏览器。具体版本与 peer 依赖要求以资料所列版本为准。