gongxiangp2/docs/photocraft-template-mapping.md

小壹模板接入规则

知识库按资源组提供组件和文件用途。小壹使用品牌、品类和模板编号查找资源组，用组件内标注的原稿、字段映射、预览图、字体和附件组装模板。各组件独立核对，原稿和映射以文件身份、版本和映射中声明的原稿校验值配对。

新模板推荐使用 screens / fields 结构。模板编号填资源组的 key，组件标明详情页、主图或 SKU。每个页面声明原稿和画布范围，每个字段声明所属页面、用途、原稿图层编号、完整路径及目标矩形。图片矩形使用 ps_style.coverage_rect，文字矩形使用 ps_style.bounds，坐标顺序是左、上、右、下。多份原稿用不同的 asset_id 分开绑定。

小壹也读取已发布的简版映射。图片字段可以逐项列出，或者用 layers 和 targets 按顺序配对。图片范围可用明确矩形、整张画布、原图层范围或指定目标图层。文字字段逐项绑定原稿文字层。简版只写图层名时，名称须在原稿内唯一；同名时写完整路径。只有显式声明的备用图层才能在主图层缺失时使用。

预览通过表示映射文件和已发布的原稿版本能配对。进入画布时才核对实际图层、类型和范围。映射结构不完整、原稿版本变化或图层无法定位时，按组件提示具体缺项，可用预览和其他齐备组件仍可查看。已保存项目继续读取自己的固定版本。