用途:在 FigJam 白板中逐个元素地构建内容并读回结果,当原生一次性 generate_diagram 过于粗糙时(例如需要指定颜色、位置、磁吸点,或扩展现有白板),可获得更细粒度控制。
主要能力:创建单个/批量便签、节点间连接线、带文字形状、分区、表格、代码块、自动排列;读取白板内容与连接关系。
使用方式:先加载官方 figma-use 技能(完整 Figma Plugin API 参考)。脚本为普通 JS,使用顶层 await 与 return(不用 IIFE,不调用 figma.closePlugin(),console.log 不返回),输入以 const 内联在脚本顶部,颜色取 0–1 范围,任何文字操作前先加载字体,用 await figma.getNodeByIdAsync(...),错误为原子性(脚本失败则什么都不应用,读错误、修复、重试)。每个操作对应一个完整片段,见 references/figjam-snippets.md。通过 use_figma 运行片段(skillNames: "create-figjam-content"),编辑内联常量(文字、位置、颜色、节点 ID)。连接线需要真实节点 ID:先创建节点并捕获返回的 ID,再引用这些 ID 创建连接线(起点/终点 + 磁吸点)。返回创建的 ID,批量操作后读回白板确认。
限制:需先确认是 FigJam 文件(return { editorType: figma.editorType }; 必须为 'figjam'),非 FigJam 中每个操作都会抛错。文字前必须加载字体,便签、带文字形状、表格单元格、连接线标签均写文字,每段片段在设置 .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)。整图一次性生成请改用原生 generate_diagram 工具。