变量

Figma Variables 导入后不应继续依赖场景中的 VARIABLE_SET / VARIABLE 伪节点。规范化事实存放在 artifact.tokens.variables，包括 collection、mode、variable、alias、binding 与默认 active mode。

三层 API

artifact.tokens.variables   持久化变量图
flamo.variables             当前 Instance 的读取、解析、mode、override、订阅
authoring.variables         revision-safe 的永久创建、修改、删除与 binding 变更

flamo.variables 的 override 只改变当前 Runtime context。它适合主题预览、A/B 状态或临时调试，不会修改 Artifact。永久更新必须走 authoring.variables，并生成 patch、diagnostic 和 receipt。

Mode、alias 与 binding

• collection 定义一组 modes；Runtime 按 collection 选择 active mode；
• variable value 可以是具体值或另一个变量的 alias；
• resolver 会检测 alias cycle、最大深度、类型不匹配与缺失 mode；
• binding 把变量投影到 paint、corner radius、font size、text data 等明确字段；
• mode 或 override 变化后，只让受影响节点进入对应 dirty/reflow 路径。

与 Figma 同步

Figma Adapter 可以抽取变量和 consumption map，并保留 provenance。再次同步 scene 时，Artifact token graph 仍是 Runtime 的优先事实源。当前文档不把 Figma 团队库、跨文件订阅或任意远程变量链接描述为已支持的 Flamo 资源发布能力；跨项目复用需要独立、精确版本的资源合同。

实践建议

设计主题时把颜色、间距和字体等稳定语义放入 collection/mode；不要用 runtime script 永久改 token。提交 authoring transaction 前先 dry-run，提交后核对受影响 binding、Artifact revision 与多实例隔离。字段结构可在 FlamoArtifact 手册中搜索 tokens.variables。