SuperAPI AI 工具集

figma-extract

设计与创作

查看项目

更新于 10-16 06:51

技能介绍

用途:figma-extract 是 figma-migration 场景的起始原子,把 Figma 文件 URL(或 node-id)与 Figma OAuth 令牌这一对输入,转成磁盘上的权威记录,供后续 token-map、generate、critique 等阶段使用。

主要能力:在项目当前目录下写出确定性的 JSON 结构快照,包含 figma/tree.json(规范节点树,含 id、type、parent、children、box、fills、text)、figma/tokens.json(从文件提取的颜色、排版、间距令牌)、figma/assets/(文件标记为导出的每个叶子节点的栅格化导出,如 <node-id>.png|svg|webp)以及 figma/meta.json(fileUrl、version、lastModified、exportedAt、atomDigest)。tree.json 是下游原子的规范支点,tokens.json 是 token-map 的输入,assets/ 是 generate 媒体阶段的输入。

使用方式:通过 figma-oauth GenUI 界面提供文件 URL,或使用 od plugin apply --input fileUrl=… 传入;OAuth 令牌经 oauth-prompt 路由,oauth.route='connector'、connectorId='figma',守护进程不会把令牌存入 SQLite。完成条件是 figma/tree.json 存在且非空,until 评估器读取 figma.tree.nodes >= 1;若文件为空或令牌过期,会发出明确错误事件并中止运行,需用户修复授权或换文件。

限制与约束:禁止在 OAuth 路径失败时用截图合成节点树,必须重新提示用户,不得编造节点 id;不支持的节点类型不能静默丢弃,需记录到 meta.json.unsupportedNodes[] 供人工审计;组件实例不视为重复,需记录 componentRef 链接,以便 token-map 在正确边界去重。该原子由 apps/daemon/src/plugins/atoms/figma-extract.ts 中的守护进程运行器实现,负责拉取并遍历 Figma REST 树、记录不支持节点、提取令牌并栅格化支持的资源。