用途:在 FigJam 白板中逐个元素地构建内容并读回结果,当原生一次性 generate_diagram 过于粗糙时(例如需要指定颜色、位置、磁吸点,或扩展现有白板),可用它获得细粒度控制。
主要能力:创建单个便签与批量便签、节点间连接线、带文字形状、分区、表格、代码块,支持自动排列,并可读取白板内容与连接关系。
使用方式:先确认目标是 FigJam 文件,运行 return { editorType: figma.editorType }; 检查返回值必须为 'figjam',否则所有操作都会抛错。随后从 references/figjam-snippets.md 选择对应操作片段,通过 use_figma(skillNames: "figjam-create-content")运行,并修改脚本顶部内联的常量(文本、位置、颜色、节点 ID)。连接线需要真实节点 ID:先创建节点并捕获返回的 ID,再用这些 ID 创建连接线(起点/终点加磁吸点)。创建后返回 ID,批量操作后可读取白板内容确认。
关键规则:需先加载官方 figma-use 技能,它是完整的 Figma Plugin API 参考。脚本使用纯 JS,顶层 await 加 return,不用 IIFE,不调用 figma.closePlugin(),console.log 不会返回;输入以 const 内联在脚本顶部;颜色使用 0–1 范围;任何文本操作前先加载字体;使用 await figma.getNodeByIdAsync(...);错误是原子性的,脚本失败不会应用任何更改,需读取错误、修复后重试。
限制与注意:文本操作前必须加载字体,便签、带文字形状、表格单元格和连接线标签都会写入文本,每个片段在设置 .characters 前需 await figma.loadFontAsync(...),默认字体不可用时回退到 Inter。便签颜色使用命名调色板(YELLOW、BLUE、GREEN、PINK、ORANGE、PURPLE、RED、LIGHT_GRAY、GRAY),其他颜色回退为默认便签填充。形状 shapeType 取值包括 SQUARE、ROUNDED_RECTANGLE、ELLIPSE、DIAMOND、TRIANGLE_UP、TRIANGLE_DOWN、PARALLELOGRAM_RIGHT、PARALLELOGRAM_LEFT 等。连接线磁吸点为 AUTO、TOP、BOTTOM、LEFT、RIGHT。这些工具需要 Figma 桌面应用,浏览器中不可用 Plugin API。