用途:打通 Builder.io Fusion(代码生成)与 Publish(可视化 CMS),把项目中的 React 组件注册为可视化编辑器可拖拽的自定义组件。
主要能力:搭建 Publish 集成(catch-all 路由、builder-registry.ts、SDK 配置、.builderrules);注册单个组件,读取 TypeScript props 映射为 Builder 输入类型;扫描目录批量注册组件,借助并行子代理分析并汇总写入注册表;维护 registration-log.json 注册记录。
必要用法:先运行 bash .builder/skills/fusion-to-publish-v2/scripts/detect-project.sh 检测项目状态;扫描用 bash .builder/skills/fusion-to-publish-v2/scripts/scan-components.sh components builder-registry.ts。缺 SDK 时执行 npm install @builder.io/react @builder.io/dev-tools。需 Next.js App Router 项目与 Builder.io Publish 公共 API key,key 写入 .env.local,并需在部署平台环境变量中配置。
限制与常见问题:list 输入必须有 defaultValue: [],object 输入必须有 defaultValue: {},枚举用 type: "text" 配 enum 数组(无 type: "enum");服务端与客户端两处 builder.init() 均需保留;[...page] 不处理根路径 /;Next.js 15+ 的 params 为 Promise 需 await;可视化编辑器无法使用 localhost,需部署到公网;CSP 或 X-Frame-Options 需允许 https://*.builder.io;避免重复包裹 BuilderDevTools()。具体计费与价格资料暂未提供。