gongxiangp2/docs/photocraft-template-mapping.md

10 lines
1.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 小壹模板接入规则
知识库按资源组提供组件和文件用途。小壹使用品牌、品类和模板编号查找资源组,用组件内标注的原稿、字段映射、预览图、字体和附件组装模板。各组件独立核对,原稿和映射以文件身份、版本和映射中声明的原稿校验值配对。
新模板推荐使用 `screens` / `fields` 结构。模板编号填资源组的 `key`,组件标明详情页、主图或 SKU。每个页面声明原稿和画布范围,每个字段声明所属页面、用途、原稿图层编号、完整路径及目标矩形。图片矩形使用 `ps_style.coverage_rect`,文字矩形使用 `ps_style.bounds`,坐标顺序是左、上、右、下。多份原稿用不同的 `asset_id` 分开绑定。
小壹也读取已发布的简版映射。图片字段可以逐项列出,或者用 `layers` 和 `targets` 按顺序配对。图片范围可用明确矩形、整张画布、原图层范围或指定目标图层。文字字段逐项绑定原稿文字层。简版只写图层名时,名称须在原稿内唯一;同名时写完整路径。只有显式声明的备用图层才能在主图层缺失时使用。
预览通过表示映射文件和已发布的原稿版本能配对。进入画布时才核对实际图层、类型和范围。映射结构不完整、原稿版本变化或图层无法定位时,按组件提示具体缺项,可用预览和其他齐备组件仍可查看。已保存项目继续读取自己的固定版本。