用途:Blode UI 是一个有主见的 shadcn/ui 组件注册表,由 Matthew Blode 构建,组件以源码形式安装,归项目所有并可自行编辑。本技能用于把 @blode 组件安装进项目并据此编写代码,不负责维护注册表本身、不用于搭建完整 Next.js 应用(用 scaffold-nextjs),也不提供非 Blode 产品的视觉方向(用 ui-design)。
安装前提:一是 CLI 能解析 @blode,较新的 CLI 无需配置,旧版 CLI 若报未知注册表,需在 components.json 注册命名空间;二是 @blode/ui 已安装,可在项目 CSS 中搜索 --field-radius,若缺失说明设计系统未添加,组件会无样式渲染。相关命令见 references/install-flow.md。
参考文件按需加载:install-flow.md 用于项目设置或组件无样式时;registry-workflows.md 用于搜索、查看、添加、更新组件;design-system.md 用于选择颜色、字体、间距、圆角、层次或动效。
规则:写组件代码前先加载对应规则文件,rules/_sections.md 有分类映射。优先级依次为组合与无障碍(comp-,关键)、表单与校验(form-,高)、样式与令牌(style-,高)、Base UI 原语 API(api-,高)、图标(icon-,中)。
注意事项:npx shadcn@latest add @blode/button 会经 shadcn 注册表目录解析;npx shadcn@latest registry add @blode=https://blode.co/ui/r/{name}.json 仅作为旧版 CLI 的兜底,不是必需首步。组件无样式应首先怀疑 @blode/ui 未安装。Blode 封装的是 Base UI 而非 Radix,没有 asChild,组合通过 render 实现。add 会无提示覆盖已定制组件,建议先用 --diff 预览。设计系统已确定强调色、圆角、动效与表面处理,不应另造。优先组合已安装组件。图标仅限 blode-icons-react。相关技能:scaffold-nextjs、ui-design、blode-icons-react。