使用场景：templateUploadAndCombind.vue 的模板上传（Normal / 精品 / 服饰满印）。
交付前请逐项确认（建议设计师导出后再“导入预检查一次”，失败就按下方报错定位）。
0. 通用硬性条件（所有模式都必须满足）
- PSD 内包含至少一个“智能对象”图层（代码会通过 placedLayer 识别）
- 切片宽和高都要 >= 50px（过小会导致上传失败）
失败提示对照：
- 请使用8位的psd文件 -> 位深是 16 位，需导出为 8 位
- 文件无可替换智能对象 -> PSD 内没有可识别的智能对象（placedLayer）
- 检测到PSD有过小的切片... -> 存在切片过小
1. Normal（普通铺货模式）PSD要求
1.1 智能对象命名（强约束）
要被替换的图层：必须是 智能对象，且命名（忽略空格）应以以下关键字开头或包含关键字：
命名示例：
1.2 宽高比一致性（强约束）
- 除“背景池”外，所有参与替换的智能对象，其宽高比要保持一致
- 如果宽高比最大最小差距超过 20% -> 会报错 图片比例差距过大
自检建议：
- 分别读取智能对象内容的 width : height（例如 1:2、2:2）
1.3 背景池智能对象（用于切片顺序与蒙版）
- PSD 中需要准备背景池智能对象：名称应包含 背景
- 命名建议按切片从上到下顺序使用：背景1、背景2、背景3...（以减少错位风险）
1.4 AI/蒙版能力（如需要）
- 若你希望启用蒙版/AI蒙版效果：背景池对应的 PSD 内，需要存在名称包含 蒙版 的图层
- 若没有 蒙版 图层：系统会把 mask_url 判定为空（不会生成蒙版图片）
2. 精品（quality）PSD要求
基础要求与“通用硬性条件”一致。
额外建议（为了最大通过率）：
- 替换用智能对象仍建议采用 Normal 的命名关键字（换图/图案/插图/插画/替换/素材/更换 + 数字）
- 在 quality 且 sku 场景下，系统虽然不会严格依赖命名，但后续上传仍会携带 type/key/value，不符合命名可能导致后端处理失败
孔位配置（页面会做选择）
- 每个智能对象都要配置对应孔位图/孔位参数（页面会提示“孔位配置”）
- 尽量保证智能对象尺寸与孔位图尺寸保持一致，避免“生产后货不对板”
3. 服饰满印（clothesFullyPrint）PSD要求
基础要求与“通用硬性条件”一致。
- 命名/裁片关联：页面的“裁片配置”里，会选择“模板的智能对象图层名字”
- 请确保裁片配置返回的 crop.name 与智能对象图层名满足匹配规则（系统会用 layer_name.trim() 去比对）
切片与孔位无须额外手动在 PSD 内命名（切片会由系统按切片顺序生成 切片1..N），但切片必须可解析且尺寸 >= 50。
4. 推荐的导出/复核顺序（建议照做）
- 在 Photoshop 确认 RGB + 8位/通道
- 按模式检查命名（Normal 强约束；quality 建议沿用同命名；满印按裁片配置匹配）
- 创建背景池智能对象（Normal 强烈建议；满印/quality 视实际需求准备）
7.（可选）在背景池 PSD 内加入包含 蒙版 的图层（如需要 AI/蒙版）
5. 上传失败时的快速定位
- 文件无可替换智能对象：智能对象未正确使用（不是 placedLayer 形式）
- 检测到PSD有过小的切片...：切片太小（>=50px 不满足）
- 文件图层命名不符合规范：Normal 替换智能对象命名不匹配关键字
- 智能对象解析失败，推荐使用psd文件：智能对象链路解析失败（建议用标准 PSD，不要奇怪的链接/压缩方式）
