用途：shadcn/ui 是构建 UI、组件与设计系统的框架，组件以源码形式通过 CLI 加入用户项目，便于直接修改与组合。
主要能力：提供项目上下文（配置与已安装组件）、组件文档与示例 URL；支持搜索注册表、添加/更新组件、预览变更、应用预设（preset）与主题/字体。强调优先复用已有组件、用内置变体与语义色，避免自定义样式。
使用方式：所有 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 添加组件；npx shadcn@latest add --dry-run 与 --diff 预览更新；npx shadcn@latest preset decode/url/open/resolve 处理预设；npx shadcn@latest apply <code> 应用预设。
适用场景：需要按源码方式管理组件、构建设计系统、组合表单/导航/覆盖层/反馈/图表等界面，并在 Next.js、Vite、Astro 等模板中初始化项目。
限制：须在项目目录内运行预设命令，apply 仅适用于已有 components.json 的项目；更新组件时不得手动从 GitHub 拉取原始文件，须用 CLI；不得在未获用户明确同意时使用 --overwrite；添加第三方注册表组件后需检查并修正硬编码导入路径与图标库；注册表须由用户明确指定，不可代为默认选择。