SuperAPI AI 工具集

shadcn

通用与其它

查看项目

更新于 10-16 05:53

技能介绍

用途:shadcn/ui 是构建 UI、组件与设计系统的框架,其组件不是依赖包,而是通过 CLI 以源码形式添加到用户项目中,便于直接阅读和修改。该技能用于管理 shadcn 组件与项目,覆盖添加、搜索、修复、调试、样式设置和 UI 组合等任务,并注入项目上下文(配置与已安装组件)以及组件文档。

主要能力:通过 CLI 获取项目信息(npx shadcn@latest info --json)、搜索注册表(search)、阅读文档与示例(docs)、安装或更新组件(add)、浏览未安装的注册表项(view)。内置组件库涵盖按钮、表单控件、数据展示、导航、浮层、反馈、命令面板、图表和布局等,并强调优先复用现有组件与内置变体,使用语义化颜色和 gap 间距等规范。

使用方式:所有 CLI 命令需按项目包管理器选择运行器,如 npx shadcn@latest、pnpm dlx shadcn@latest 或 bunx --bun shadcn@latest。创建项目示例:npx shadcn@latest init --name my-app --preset base-nova;添加组件:npx shadcn@latest add button card dialog;查看文档:npx shadcn@latest docs button dialog select。更新组件前可用 --dry-run 和 --diff 预览差异,避免覆盖本地改动;使用 --overwrite 需先获得明确同意。

适用场景:为现有或新建前端项目初始化 shadcn 配置、按需添加与更新组件、组合表单/仪表盘/设置页等界面、排查组件用法与导入路径问题。

限制:具体预设、模板和注册表来源需以 CLI 实际输出为准;社区注册表添加的组件可能包含硬编码导入路径,需按项目别名手动修正;更新与预设切换可能覆盖本地改动,应谨慎操作。官方收费、价格或效果信息暂未提供。