figma-slides

figma-slides — 编写 Figma Slides 演示文稿

创建和编辑 Figma Slides 演示文稿：管理幻灯片网格（列出 / 创建 / 复制 / 重新排序 / 删除 / 聚焦 / 跳过）、添加内容（文本、形状、背景颜色）并控制转场效果。每张幻灯片 都是一个 SLIDE 节点；演示文稿是一个二维网格（figma.getSlideGrid() → 幻灯片行）。

技能边界

• use_figma 规则 — 首先加载官方的 figma-use 技能；它是完整的 Figma Plugin API 参考。此类脚本依赖的要点：使用带顶层 await 和 return 的纯 JS（不使用 IIFE 或 figma.closePlugin()；console.log 不会作为返回值）、在每个脚本顶部以内联 const 定义输入、颜色值范围为 0–1、任何文本操作前先加载字体、使用 await figma.getNodeByIdAsync(...)，以及原子错误处理（脚本失败时不会应用任何更改 — 阅读错误信息、修复后重试）。
• 每项操作使用一段完整代码片段 → references/slides-snippets.md。

工作流

1. 确认这是一个 Slides 文件。 在 Slides 之外，每项操作都会抛出错误。先检查： return { editorType: figma.editorType }; — 必须为 'slides'。
2. 列出幻灯片，以获取 ID 和网格位置（scripts/代码片段 List slides）。其他所有操作都需要引用幻灯片 ID。
3. 从 references/slides-snippets.md 中选择操作：创建 / 复制 / 删除 / 重新排序幻灯片；添加文本 / 形状；设置背景；设置 / 获取转场效果；聚焦；跳过；读取幻灯片内容。
4. 通过 use_figma 运行代码片段（skillNames: "figma-slides"），并编辑内联常量。
5. 返回创建或更改的幻灯片 ID，并重新列出幻灯片或读取内容以确认。

注意事项

• 添加文本前会先加载字体。 add text to slide 会在设置 .characters 前调用 await figma.loadFontAsync({ family, style }) — 切勿跳过。默认字体为 Inter / Regular。
• 使用 figma.createSlide({ row, col }) 在网格位置创建，或使用 figma.createSlide() 追加。
• 转场 style 值：NONE、DISSOLVE、SLIDE_FROM_LEFT、SLIDE_FROM_RIGHT、 SLIDE_FROM_BOTTOM、SLIDE_FROM_TOP、PUSH_FROM_LEFT、PUSH_FROM_RIGHT、PUSH_FROM_BOTTOM、 PUSH_FROM_TOP、SMART_ANIMATE。时间设置默认为 { type: 'ON_CLICK' }。
• 背景通过插入到索引 0 的全幅（1920×1080）Background 矩形实现；重新运行时会更新已有矩形，而不会叠加。
• reorder 接受一个由幻灯片 ID 组成的二维数组（行 × 列），并通过 figma.setSlideGrid 重建网格。所有 ID 都必须存在于当前网格中，否则会抛出错误。
• 跳过操作会切换 slide.isSkippedSlide（注意：属性名是 isSkippedSlide，不是 skipped）。
• 这些工具需要 Figma Desktop 应用（浏览器中无法使用 Plugin API）。