generating-weaverse-project-json

该技能用于生成符合 Weaverse 导入契约的项目导出 JSON，适用于网站迁移、Figma 设计稿、设计说明或口头描述等输入场景，输出为单个可导入 Weaverse Studio 的 JSON 文件。使用前需读取参考文件了解 schema 与示例，读取 app/weaverse/components.ts 获取已注册的分区与块类型，并查看对应分区源码以确认字段、枚举值与默认值。可用 python3 scripts/validate.py <output-file> 校验结构。JSON 顶层包含 version、exportedAt、project、pages、pageAssignments；页面 items 为扁平数组，通过 children 的 id 引用表达层级，每个 item 必须带 data 与 children，main 根项 id 须与 rootId 一致。页面 id 用 25 位 CUID，item id 用带连字符的 UUID v7，所有 id 需唯一。data 中只写非默认值，枚举值必须来自源码。Shopify 集合与产品用对象格式，未知真实 ID 时省略或留空数组，不得编造。外部图片可用 URL 字符串，上线内容建议用 Shopify media 对象。项目已存在时通常不必再导入，可用 POST /projects/:projectId/pages 建页并一次性 PATCH 推送 items；后续内容编辑应走 weaverse-content-api，并保持 item id 稳定。限制：输入必须能确定使用哪些分区类型；presets 不会在导入或 API 写入时生效，需显式填写所需值；Figma 资产 URL 约 7 天后过期，不宜直接用于线上导出。校验未通过前不应交付 JSON。