SuperAPI AI 工具集

figma-create-new-file

设计与创作

查看项目

更新于 10-15 21:41

技能介绍

用途:当用户想要新建 Figma Design、FigJam 或 Slides 文件时使用本技能,且必须在每次调用 create_new_file 工具之前先调用它。

第一步,确定 planKey 与 editorType。使用用户为此任务提供或选择的 planKey;否则调用 whoami 并检查返回的 plans。没有 plans 时告知用户无法创建文件;只有一个 plan 时用其 key 作为 planKey;有多个 plan 时列出可用 plan,请用户选择后用所选 plan 的 key。editorType 根据请求的文件类型从工具公开的输入枚举中推断,若不清楚则请用户指定文件类型。

第二步,调用 create_new_file,需传入三个必填参数:fileName(必填,用户未提供时取一个简洁名称)、planKey(必填,用第一步解析结果)、editorType(必填,用第一步选择结果);projectId 为可选,设置后可在指定项目中创建文件。响应中的 file_key 供后续 use_figma 等工具调用使用。

第三步(仅 Slides):新建的 Slides 文件没有任何幻灯片,figma.getSlideGrid() 返回 []。在读取幻灯片的主题令牌等属性前,需先调用 figma.createSlide() 或处理空的情况;首次 createSlide() 会自动创建第 0 行并插入幻灯片。

限制:可用 plan 取决于 whoami 返回结果,无 plan 时无法创建;文件类型不明确时需向用户确认。价格、平台与具体收费信息暂未提供。