用途:shadcn/ui 是构建 UI、组件与设计系统的框架,组件以源码形式通过 CLI 加入用户项目。本技能用于管理 shadcn 组件与项目,涵盖添加、搜索、修复、调试、样式与组合 UI,并提供项目上下文与组件文档。
主要能力:通过 CLI 获取项目配置与已安装组件信息;搜索注册表(含社区注册表)查找组件;获取组件文档、示例与 API 参考;添加、更新、预览组件变更;应用预设(preset)与模板;查看未安装的注册表项。
使用方式:所有 CLI 命令须使用项目对应的包运行器,如 npx shadcn@latest、pnpm dlx shadcn@latest 或 bunx --bun shadcn@latest。常用命令包括 npx shadcn@latest info --json、npx shadcn@latest docs <component>、npx shadcn@latest search、npx shadcn@latest add、npx shadcn@latest view、npx shadcn@latest apply --preset <code>、npx shadcn@latest init --preset <code>。更新组件时先用 --dry-run 与 --diff 预览,再决定覆盖或合并;未经用户明确同意不得使用 --overwrite。
适用场景:在已有或新建项目中添加与组合 UI 组件、构建表单与数据展示、导航与浮层、反馈与图表等界面;也用于从社区注册表引入组件并修正导入路径。
限制:须先检查已安装组件,避免重复添加或导入未安装组件;添加社区注册表组件后需检查硬编码导入路径并按项目别名重写;图标导入须依据项目 iconLibrary,不可假定 lucide-react;isRSC 为 true 时使用状态或浏览器 API 的组件需加 "use client";tailwindVersion 决定主题写法;预设命令须在项目目录内运行,apply 仅适用于含 components.json 的现有项目。资料未提供收费、价格与效果信息。