用途:管理 shadcn/ui 组件与项目,在添加、样式化、组合或调试组件,初始化项目、切换设计系统预设,以及获取组件文档、示例和 API 参考时使用。
主要能力:通过 CLI 添加组件、搜索注册表、查看文档与示例、预览变更、更新组件并智能合并本地修改。组件以源码形式加入项目,可组合现有组件构建界面。
使用方式:所有 CLI 命令须使用项目对应的包运行器,如 npx shadcn@latest、pnpm dlx shadcn@latest 或 bunx --bun shadcn@latest。常用命令包括 npx shadcn@latest init、add、search、docs、view、info,以及 --dry-run、--diff、--overwrite 等标志。
限制与规则:优先使用现有组件,不重复造轮子;使用语义化颜色与内置变体;表单使用 FieldGroup + Field;图标通过 data-icon 传递;更新组件时不得手动从 GitHub 拉取原始文件,须使用 CLI;使用 --overwrite 前须获得用户明确同意;添加块或组件时若未指定注册表,应先询问用户。