用途
design-layer-import 是 Picsart Gen AI Skills 中“Stage 1 — Import”阶段的技能，目标是将设计稿或静态素材以图层的形式导入场景，而不是作为单一扁平帧。因为动效设计需要让元素独立运动，只有保留图层结构，后续才能实现滑动、滚动、打字、视差和智能动画效果。如果图层在导入阶段丢失，后续无论怎么调整都无法恢复，结果只能是幻灯片。
主要能力
逐帧提取图层树：在读取 Figma 之前先发送进度提示。通过 get_metadata / get_design_context 遍历每个帧的节点树，并递归展开完整树，确保嵌套的子节点（组、组件实例、自动布局子项、蒙版内容）不被遗漏。对每个图层记录：id 与名称/角色、类型（text/vector/raster/group）、变换信息（x、y、w、h、旋转、透明度、层级顺序）、父组关系、图片的 scaleMode 与 imageTransform，以及文本的字符串、解析后的字体 URL、字号、水平对齐方式和文本框尺寸与换行行为。
按类型导出图层：文本保持为实时文本（字符串 + 字体 URL），不转为图片；矢量元素（图标、Logo、线条、面板、扁平形状）创建为形状层，使用 picsart_scene_patch 添加图层，再通过 picsart_scene_import_svg_path 导入路径数据，并用 picsart_scene_import_figma_paint 应用填充、阴影、渐变等；位图/照片则导出为透明 PNG，从 download_assets → rawImages 获取原始位图，而不是节点导出或截图。
粒度控制：拆分出会独立运动或跨帧持续的元素（标题、每个 CTA、主图、可滚动列表、点击目标），将静态装饰、卡片固定内部结构和背景保持分组。避免过度拆分或拆分不足。
完整导入：导入设计渲染的每一个元素，只有设计本身隐藏的元素才可跳过。部分在画框边缘被裁剪的元素仍应导入，完全在画框外的元素也应导入，以便后续编排滚动或平移动画。
跨帧匹配标记：为连续帧中重复出现的元素分配稳定的 matchKey，按语义角色匹配，而不是按精确字符串或位置。即使元素被变换或内容改变，仍保持同一 matchKey，使后续动画能从一个状态平滑过渡到另一个状态。
素材 URL 宿主化：每个图层素材必须上传到 Picsart 托管的 HTTPS URL（pastatic/gcdn），不能使用 figma.com URL 或 base64 data URI。使用 picsart_drive_upload_ask / picsart_drive_upload 上传并读取返回的 URL。
使用方式
该技能通过 Picsart Gen AI Skills 环境调用，依赖 Figma 连接器读取设计结构。使用流程包括：读取图层树、记录图层属性、按类型导出或创建图层、上传素材到托管 URL、标记跨帧匹配元素、按 Figma 的帧顺序确定运行顺序。格式比例和帧率在开始时通过一次 ASK 询问，预填建议值供确认。
适用场景
适用于将 Figma 设计稿（如广告、Reels、营销素材）转化为可动画的场景，或导入静态素材并保留图层结构以支持后续动效编排。
限制
若没有 Figma 连接器，只能导入扁平帧并退化为幻灯片，需告知用户。若 Figma 导出配额用尽，可继续上传剩余素材，或仅能获取扁平帧时说明结果将是幻灯片并建议配额恢复后继续。Drive 空间不足时停止上传并告知用户，提供清理选项。validate_scene 和 contact_sheet 不能证明预览渲染正常，唯一可靠的验证是编辑器预览本身。