用途:把代码侧的设计令牌推送到 Figma,生成或更新 Figma 变量(variables),覆盖变量集合、模式(modes)与取值。输入源可为 DTCG tokens.json、Tailwind/SCSS 导出,或手写的普通 token 对象。支持 {ref} 别名与多模式值;重复执行安全,变量按保存的 Figma id → key → 精确名称匹配,更新即编辑原变量而非新建。反向方向(Figma → 代码)应使用 figma-export-tokens。
主要能力与用法:对 DTCG 输入(含 figma-export-tokens 的输出)用内置解析器,而非手工展平:node scripts/parse-tokens.mjs tokens.tokens.json --default-mode Light --collection Brand;--strip-prefix "ds-" 可去掉导入时的名称前缀。该命令会打印 COLLECTION_NAME / MODES / TOKENS 常量,供粘贴到 apply 脚本,并处理 $type→Figma 类型、{ref} 别名、多模式($extensions…modes)、dimension 单位剥离和 variableId 往返。非 DTCG 来源需先导出为 DTCG,或手写 TOKENS 数组,元素形如 { name, type: "COLOR"|"FLOAT"|"STRING"|"BOOLEAN", values: { <mode>: literal | { reference: "{Color.Brand.500}" } }, figmaVariableId? }。随后确定冲突策略:默认代码值优先,但不经确认不删除 Figma 独有变量;确认目标集合名与模式列表(首个为默认)。把解析数据填入 scripts/apply-tokens.js 顶部常量,经 use_figma(skillNames: "figma-import-tokens")执行。脚本分两遍:先字面量后别名,返回 { created, updated, errors, variableIds }。最后报告创建/更新数量与错误,并用 figma-export-tokens 读取脚本或 get_variable_defs 回读校验。
限制与注意:须先加载官方 figma-use 技能;脚本依赖纯 JS 顶层 await + return、输入内联为顶部 const、颜色 0–1、文本操作前加载字体、await figma.getNodeByIdAsync(...) 及原子错误。两遍不可合并,别名目标须先存在。颜色接受 3/6/8 位 hex 并自动转为 {r,g,b,a}。新变量默认 ALL_SCOPES,导入后建议设置 variable.scopes。其他具体收费、平台与效果资料未提供。