SuperAPI AI 工具集

shadcn

测试与质量

查看项目

更新于 10-15 23:45

技能介绍

用途:shadcn/ui 是构建 UI、组件与设计系统的框架,组件以源码形式通过 CLI 加入用户项目。本技能用于管理 shadcn 组件与项目,涵盖添加、搜索、修复、调试、样式与组合 UI,并提供项目上下文与组件文档。

主要能力:通过 CLI 获取项目配置与已安装组件(npx shadcn@latest info --json);搜索注册表(npx shadcn@latest search);获取组件文档与示例 URL(npx shadcn@latest docs <component>);添加组件(npx shadcn@latest add);预览变更(--dry-run、--diff);管理预设(preset decode/url/open/resolve、apply、init --preset)。

使用方式:所有 CLI 命令须使用项目对应的包运行器:npx shadcn@latest、pnpm dlx shadcn@latest 或 bunx --bun shadcn@latest。先读取项目上下文,检查已安装组件,再搜索、获取文档、安装或更新。更新组件时用 --dry-run 与 --diff 智能合并,未经用户明确同意不得使用 --overwrite。添加第三方注册表组件后需检查并修正硬编码导入路径与图标库。

适用场景:在已有或新建项目中添加、组合、调试 shadcn 组件,构建表单、导航、覆盖层、反馈、图表、布局等界面,以及切换主题预设。

限制:资料未提供收费、价格、平台与效果信息。预设命令须在项目目录内运行,apply 仅适用于含 components.json 的现有项目;预设代码不编码 base,临时目录需显式传 --base。图标库、别名、RSC、Tailwind 版本等须以项目上下文为准,不得假设。