SuperAPI AI 工具集

theme-builder

前端与建站

查看项目

更新于 10-15 17:29

技能介绍

用途:用于处理 Shopify Online Store 2.0 的 JSON 模板,包括 templates/ 下的 product.json、index.json、page.contact.json 等,以及引用 blocks/ 中主题区块的 section JSON。不覆盖 config/settings_schema.json、config/settings_data.json、结账品牌、Checkout UI 扩展、extensions/ 下的主题应用扩展,也不替代尚未采用 JSON 的 .liquid 模板。若主题有构建步骤生成 sections/ 或 blocks/,需先阅读主题 README 并编辑源文件。

主要能力:解析文本或图片需求,提取布局、行列、内容类型与样式;列出 blocks/ 并读取父级 {% schema %} 以发现允许的区块类型;将需求映射到真实区块;分析区块与 section 的 schema,获取允许的子区块、设置 ID、类型、默认值和预设;按 Shopify 模板结构编译 JSON,包含 sections、嵌套 blocks、order 与 block_order 数组;最后按检查清单验证。

使用方式:先理解需求,再发现允许的区块类型(必需),然后映射到真实区块、分析 schema、编译 JSON、验证。模板结构示例:{"sections":{"<sectionId>":{"type":"<sectionType>","settings":{},"blocks":{"<blockId>":{"type":"<blockType>","name":"t:blocks.block_name","settings":{},"blocks":{},"block_order":[]}},"block_order":["<blockId>"]}},"order":["<sectionId>"]}。区块实例 ID 使用描述性前缀并保持唯一。设置键需存在于目标 schema 中,优先使用翻译键如 "t:blocks.image"。

适用场景:编辑或创建 Shopify JSON 模板、使用主题区块构建布局、根据设计图或文字需求生成模板结构。

限制:JSON 模板无法表达所有视觉细节,任意排版、一次性 CSS 或全局调色板更改可能需要主题设置、section 设置或自定义 CSS。无法从静态图片可靠读取精确断点、字体大小和像素间距。若设计无法用主题现有区块和设置实现,需说明差距并提供最接近的结构。不要从捆绑示例中输出类型字符串,除非它们出现在目标主题的允许集合中。