SuperAPI AI 工具集

figma-manage-variables

设计与创作

查看项目

更新于 10-15 23:57

技能介绍

用途:对 Figma 变量系统做增量、精细的编辑,包括创建单个或多个变量、批量更新值、重命名、设置作用域与代码语法、添加或重命名模式以及删除,全部通过 use_figma 执行,适用于任意 Figma 套餐。

主要能力:变量、集合、模式的增删改查;批量创建与批量更新(scripts/batch-update-variables.js 比逐值调用快 10–50 倍);设置变量作用域;通过 setVariableCodeSyntax('WEB', '--token-name') 设置代码语法,使设计与代码命名对齐;用 figma.variables.createVariableAlias(targetVar) 建立变量别名绑定。

使用方式:先加载官方 figma-use 技能(完整 Figma Plugin API 参考)。脚本需为纯 JS,使用顶层 await 与 return,不用 IIFE,不调用 figma.closePlugin(),console.log 不会返回;输入以 const 内联在脚本顶部;颜色使用 0–1 范围,十六进制输入用 hexToRgb;文本操作前先加载字体;用 await figma.getNodeByIdAsync(...);脚本出错为原子性,失败不应用任何更改,需读错误、修复后重试。多数操作需要 ID,可从 figma-export-tokens 读取脚本或 get_variable_defs 获取 variableId/modeId/collectionId,集合也可在脚本内按名称查找。操作片段见 references/variable-ops.md,运行方式为 use_figma(skillNames: "figma-manage-variables")。完成后用 get_variable_defs 读回验证。

适用场景:从零搭建请用 figma-setup-design-tokens;代码同步请用 figma-import-tokens / figma-export-tokens。

限制与注意:新建变量务必设置作用域,默认 ALL_SCOPES 会污染所有选择器;重命名安全,保留值与已有绑定;删除具有破坏性,删除集合会同时删除其全部变量并解绑所有引用,删除前需与用户确认。