SuperAPI AI 工具集

library-variables-figma

设计与创作

查看项目

更新于 10-16 01:49

技能介绍

用途:浏览当前 Figma 文件所订阅团队库中已发布的变量,按需导入所需变量。导入后每个变量获得本地 id,行为与本地变量一致,可绑定到节点属性、读取或作为本地语义 tokens 的引用来源。

主要能力:列出所有已订阅的变量集合及其内每个变量的 key;将指定 key 导入为本地变量并返回新 localId;重复导入具有幂等性,会返回相同的本地 id。

使用方式:脚本基于官方 figma-use skill 的 Figma Plugin API 规范运行,需先加载该 skill。通过 use_figma 运行 scripts/list-library-variables.js(可传 skillNames: "library-variables-figma"),可选用 LIBRARY_NAME / COLLECTION_NAME / TYPE 过滤,得到各集合及变量 key;再把 key 填入 scripts/import-library-variable.js 运行完成导入。绑定与引用参见 figma-use 或 manage-variables-figma。脚本要求纯 JS、顶层 await 加 return,不使用 IIFE,不调用 figma.closePlugin(),console.log 不会被返回;输入以 const 内联在脚本顶部;颜色为 0–1 范围;文本操作前先加载字体;用 await figma.getNodeByIdAsync(...);错误为原子性,脚本失败不产生任何改动,可读错误修正后重试。

适用场景:需要复用共享团队库中已发布的设计变量时;需要把库变量引入当前文件后绑定到图层或作为本地语义 tokens 引用时。

限制:只显示已订阅的库,若集合缺失需先在文件的库设置中手动启用该库;getVariablesInLibraryCollectionAsync 接收集合 key 而非 id;库变量是源文件的只读引用,值必须在库文件中修改,不能在此处编辑。本地(非库)变量的导出与管理请使用 export-tokens-figma、manage-variables-figma。其他信息暂未提供。