用途:浏览当前文件所订阅的 Figma 团队库发布的变量,并将需要的变量导入到当前文件。导入后的变量会获得本地 id(localId),可作为普通本地变量进行绑定、读取和引用。
主要能力:列出每个已订阅集合及其全部变量的 key;按需导入指定变量 key 并返回新的 localId;重复导入具有幂等性(得到相同的本地 id)。
使用方式:先加载官方 figma-use 技能(完整的 Figma Plugin API 参考)。这些脚本依赖以下要点:纯 JS,支持顶层 await 与 return(不使用 IIFE,不调用 figma.closePlugin(),console.log 不会被返回);输入以 const 内联在各脚本顶部;颜色使用 0–1 范围;文本操作前先加载字体;使用 await figma.getNodeByIdAsync(...);错误为原子性(脚本失败则不应用任何更改,需读错误、修复后重试)。
第一步发现:通过 use_figma 运行 scripts/list-library-variables.js(skillNames: "figma-library-variables"),可选设置 LIBRARY_NAME、COLLECTION_NAME、TYPE 过滤器,返回每个已订阅集合及其所有变量的 key。
第二步导入:将变量 key 填入 scripts/import-library-variable.js 并运行,返回每个变量的新 localId;重复导入幂等。
第三步使用:将导入的变量绑定到节点属性,或从本地语义令牌引用(绑定方式见 figma-use / figma-manage-variables)。
限制:只显示已订阅的库;若缺少某个集合,需先在文件的库设置中启用该库(手动 Figma 步骤)。getVariablesInLibraryCollectionAsync 接收集合 key 而非其 id。库变量是源文件的只读引用,修改值应在库文件中进行,而非当前文件。本地(非库)变量请使用 figma-export-tokens、figma-manage-variables。