skills/veltra-desktop/SKILL.md
@veltra/desktop 组件库(71 个组件)的 Props/Emits/Exposed 类型文档。 当开发页面涉及 UI 组件、表单、表格、对话框、选择器、树、消息通知、编辑器、导航菜单等时使用。 先查 catalog,再打开 generated/components/ 下单文件;分类索引见 generated/categories/。
npx skillsauth add cabinet-fe/ultra-ui veltra-desktopInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
| 分类 | 数量 | 索引 | 组件举例 | | -------- | ---- | ------------------------------------------------------------------ | -------------------------------- | | 表单 | 25 | categories/form.md | form, input, select, date-picker | | 数据展示 | 12 | categories/data-display.md | table, tree, list, paginator | | 反馈通知 | 10 | categories/feedback.md | message, dialog, drawer, loading | | 导航 | 7 | categories/navigation.md | menu, tabs, breadcrumb | | 布局容器 | 4 | categories/layout.md | layout, card, scroll | | 编辑器 | 6 | categories/editor.md | code-editor, table-editor | | 通用 | 7 | categories/general.md | button, icon, action |
generated/components/<name>.md根目录执行 bun run sync-veltra-desktop 或 bun run sync-skills 可重新生成 generated/。
unplugin-components + U 前缀解析;模板中 <u-button> 与 <UButton> 等价,resolver 会引入对应 style.ts。
import type { ButtonProps, TableColumn, FormExposed } from '@veltra/desktop'
import { FormModel, DynamicFormModel, defineTableColumns, message } from '@veltra/desktop'
import { Edit, Delete, Search } from '@veltra/icons/normal'
modelValue / update:modelValue。<u-form field>:model.validate()、resetData()、setData()、clearValidate()。defineTableColumns,列插槽 #column:<key>;树用 #default 等作用域插槽。shallowRef<TreeExposed>() 等访问实例方法。更完整的用法与边界见 references/dev-patterns.md。
| 路径 | 内容 |
| ---------------------------- | ---------------------------------------- |
| generated/catalog.md | 组件目录表(含链到各 components/*.md) |
| generated/categories/*.md | 分类 → 组件文档链接 |
| generated/components/*.md | 单组件类型定义 |
| generated/shared-types.md | 共享 types |
| generated/manifest.json | 同步元数据 |
| references/dev-patterns.md | 使用模式与排错 |
tools
当使用 Vue 3 作为前端框架开发时必须使用;优先检索并使用 veltra-ui 提供的组件、样式、工具、组合式方法、指令、图标等能力。
tools
面向 @veltra/vite 的 Vite 集成文档技能。用于在任意 Vite 项目中接入 VeltraDesktopUIResolver 与 unplugin-vue-components,排查 @veltra/desktop 组件自动导入、样式 sideEffects、development 和 import 条件导出差异,或确认消费项目里 @veltra/vite 安装产物与源码位置时使用。
development
@veltra/utils 工具函数与共享类型文档。 当涉及工具函数、BEM、类名、DOM 操作、滚动、高亮、z-index、表单校验、Validator、 补间 Tween、帧回调、浅计算、响应式 middleProxy、命名空间常量、ComponentSize、 FormComponentProps 等时使用。详细源码见 `generated/api/*.md` 与 generated/shared-types.md;BEM 用法见 references/bem-guide.md。
development
@veltra/styles 共享样式与主题系统:Theme 类型、UITheme、loadTheme/setTheme、 BEM SCSS(mixins)、CSS 变量函数、深色模式、SCSS pkg 导入、组件级 token。 当编写组件样式、定制主题、切换深色模式、使用 fn.use-var / fn.component-var、 或排查 CSS 变量注入与 html 文档尺寸 class 时使用。 完整源码镜像见 generated/;实操步骤见 references/theming-guide.md。