用途：shadcn 是一个用于构建 UI、组件与设计系统的框架，组件以源码形式通过 CLI 加入用户项目，便于按项目需求组合与定制。
主要能力：提供组件添加、搜索、文档与示例获取、注册表浏览、预设（preset）应用、项目信息查询等 CLI 能力。可用 npx shadcn@latest add 添加组件，用 search 检索注册表，用 docs 获取组件文档与示例 URL，用 view 浏览尚未安装的注册表项，用 info 查看项目配置与已安装组件。支持从第三方注册表（如 @magicui、owner/repo）添加组件。
必要用法：所有 CLI 命令需使用项目对应的包运行器，如 npx shadcn@latest、pnpm dlx shadcn@latest 或 bunx --bun shadcn@latest。初始化项目可用 npx shadcn@latest init --preset <code>；已有项目应用预设可用 npx shadcn@latest apply <code>，其中 --only theme、--only font 可仅更新主题或字体。更新组件时先用 --dry-run 预览受影响文件，再用 --diff <file> 查看差异，避免直接覆盖本地修改；不要手动从 GitHub 下载原始文件。使用 preset 相关命令需在项目目录内，apply 仅适用于存在 components.json 的项目。
适用场景：需要按项目定制 UI 组件、构建设计系统、从注册表复用组件或块、在保留本地修改的前提下合并上游组件更新时使用。添加第三方注册表组件后需检查导入路径与图标库是否与项目实际配置一致。
限制：资料要求不得猜测注册表，用户未指定注册表时应先询问；切换预设前需询问覆盖、部分更新、合并还是跳过；未获用户明确同意不得使用 --overwrite。isRSC、别名、Tailwind 版本、base、图标库等须以项目上下文为准，不能硬编码或假设。具体收费、价格与效果信息暂未提供。