用途：管理 shadcn/ui 项目与组件，覆盖添加、搜索、修复、调试、样式和组合 UI，并为操作提供项目上下文与组件文档。组件以源码形式通过 CLI 加入项目，而非作为依赖包引入。
主要能力：通过 CLI 查询项目配置与已装组件信息，搜索注册表组件，获取组件文档与示例网址，安装或更新组件，预览改动，查看尚未安装的注册表条目。可指定命名预设（base-nova、radix-nova）与模板（next、vite、start、react-router、astro、laravel），支持 monorepo。
使用方式：所有 CLI 命令须使用项目对应的包运行器，依 packageManager 选择 npx shadcn@latest、pnpm dlx shadcn@latest 或 bunx --bun shadcn@latest。常见用法包括：npx shadcn@latest init --preset base-nova 初始化；npx shadcn@latest add button card dialog 添加组件；npx shadcn@latest search @shadcn -q "sidebar" 搜索；npx shadcn@latest docs button dialog select 获取文档与示例网址；npx shadcn@latest add button --dry-run 与 --diff 预览。切换预设需用户选择重新安装、合并或跳过。
限制与注意事项：优先使用现有组件与内置变体，使用语义化颜色，避免手工 dark: 覆盖与手动 z-index；表单使用 FieldGroup + Field，输入组使用 InputGroup 子组件；Dialog、Sheet、Drawer 必须包含标题以保证可访问性；图标经 data-icon 传入对象；添加第三方注册表组件后需按项目实际别名修正导入并替换为项目图标库；未指定注册表时不得替用户默认选择；不得使用 --overwrite 除非用户明确同意；需先检查已装组件，避免重复添加或导入未添加组件。更多字段与主题定制细节以随附引用文件为准。