Shopify JSON 模板里加 app block 后提示 schema 无效

现象#

手工在 JSON 模板的 blocks 里写了一个 type: "shopify://apps/xxx/blocks/yyy"，保存时提示 block 类型无效或整段被丢弃。

原因#

• app block 的 type 必须与应用注册的 handle 完全一致，手写容易少一段路径
• 应用未在当前主题启用 app embed，block 不可用
• block 的 settings 里键名与该 app block schema 不匹配
• blocks 里缺少必需的 block_order 或 id 重复

处理步骤#

1. 不要手写：在编辑器里添加该 app block 后保存，再从 templates/index.json 里复制生成的 type
2. 到「应用 → 该应用 → 主题嵌入」确认已启用
3. 删除 settings 里不认识的键，只保留编辑器生成过的
4. 确认 block_order 数组包含所有 block id

验收标准#

保存不再报错，编辑器里能看到该 app block，前台渲染出应用内容。