shadcn

用途：shadcn/ui 是用于构建 UI、组件和设计系统的框架，组件以源码形式通过 CLI 加入用户项目，便于在项目内直接维护与组合。\n\n主要能力：提供项目上下文信息、组件文档与用法指引；支持搜索与添加注册表组件，也支持社区注册表；覆盖表单、导航、浮层、反馈、图表、布局、菜单、空状态、提示等大量组件的选型与组合规范。\n\n使用方式：所有 CLI 命令需使用项目包管理器运行器，例如 npx shadcn@latest、pnpm dlx shadcn@latest 或 bunx --bun shadcn@latest。常用命令包括 npx shadcn@latest info --json 查看项目配置与已装组件，npx shadcn@latest docs <component> 获取文档与示例 URL，npx shadcn@latest search 搜索注册表，npx shadcn@latest add 安装或更新组件，使用 --dry-run 与 --diff 预览变更，npx shadcn@latest view 查看未安装项。\n\n适用场景：在 React/Next.js/Vite 等项目中搭建界面、设计系统、仪表盘与设置页等，优先复用已有组件而非自定义标记。\n\n限制：需遵循其组合与样式规则，如使用语义色、gap-* 替代 space-、size- 等；更新组件不得手动抓取 GitHub 文件，必须用 CLI，且 --overwrite 需用户明确同意。切换预设前需询问用户选择。添加组件需明确指定注册表。