用途:在 Vue 3 与 Nuxt 应用中接入 SoybeanUI。该库提供两套包:@soybeanjs/ui 提供 S* 预样式组件,@soybeanjs/headless 提供无样式逻辑与可访问性原语。
主要能力:帮助判断选用哪套包或混合使用;配置主题、语言环境、方向等全局设置;按分类浏览并定位组件,查看各组件概览、特性、导出符号、props、emits、slots。
使用方式:先加载 REFERENCE.md 获取安装概览与文档路由。选择包或混合两层时加载 references/headless-vs-styled.md;涉及主题、SConfigProvider、locale、nonce、方向时加载 references/theming.md;需浏览组件库时加载 references/components.md;仅按任务涉及的组件加载对应 components/*.md。样式需引入 '@soybeanjs/ui/styles.css',可按示例用 unplugin-vue-components 与 @soybeanjs/ui/resolver 自动引入。全局配置通过 SConfigProvider 设置 theme、size、dir 等。若本地技能文件不足,可参考 https://ui.soybeanjs.cn/llms.txt 与 https://ui.soybeanjs.cn/llms-full.txt。
限制:技能组件文件由 docs/src/docs/en/ui/components 与 docs/src/generated/api/ui 生成;仓库内部组件开发或修改 SoybeanUI 源码应使用 soybean-ui-develop 技能;文档或生成 API 数据变更后用 pnpm sui gen skills 重新生成组件参考文件。其他细节暂未提供。