用途:在 Shopify Hydrogen 项目中使用 Weaverse 可视化页面构建器开发店铺前台,帮助开发者编写类型安全的 React 组件并注册到编辑器。
主要能力:组件开发(默认导出 React 组件、schema 导出编辑器配置、可选 loader 导出服务端取数);使用 createSchema() 定义 type、title、settings、childTypes、presets、enabled 等;在 app/weaverse/components.ts 注册组件;通过 loader 调用 weaverse.storefront.query 访问 Storefront API,或用 weaverse.fetchWithCache 缓存外部请求;用 Tailwind CSS、useThemeSettings 与 CSS 变量实现主题,CVA 管理组件变体;集成 React Router v7 路由与 WeaverseHydrogenRoot;在 server.ts 初始化 WeaverseClient。技术栈为 React 19、React Router v7、Shopify Hydrogen、TypeScript、Tailwind CSS、Vite。
必要用法:组件须用命名空间导入(import * as X)注册,转发 {...rest} 到根元素以支持 Studio 交互;type 须为全局唯一 kebab-case;input 支持 text、richtext、image、select、product、collection、metaobject 等;数据维度注意 inspector 与 enabledOn 已弃用,改用 settings 与 enabled;影响 loader 的 schema 输入需设 shouldRevalidate: true。技能内置 helpers 位于同级 shopify-hydrogen 目录,单独安装本技能时相关命令会报 MODULE_NOT_FOUND,可运行 npx skills add Weaverse/shopify-hydrogen-skills --skill shopify-hydrogen 补装,或使用 references/ 下的离线参考。
适用场景:为 Hydrogen 店铺构建可拖拽编辑的首页、产品页、集合页等页面与可复用区块。
限制:reference 文件为离线备用,可能不反映最新变更;最新文档以 https://docs.weaverse.io 为准;具体收费、价格等信息暂未提供。