用途:根据代码或描述在 Figma 中创建或更新界面元素,例如页面、视图、模态/抽屉/侧栏/面板、单个组件或设计系统资产。不适用于把 Figma 设计读成代码,那是 figma-codegen 的职责。
主要能力:读取当前连接文件的变量(get_variable_defs)、本地组件(scan_components / get_local_components)和共享样式(get_styles),按“复用优先于重建、引用令牌而非字面量”的原则构建:颜色经 bind_variable_to_paint、标量经 bind_variable_to_node、共享外观经 apply_style_to_node;相关子元素使用 auto-layout,尺寸经 set_layout_props 采用 HUG/FILL/FIXED;值按设计系统→源码→合理比例的优先级取值,不凭感觉猜测。来源含动画时可作者为 Figma Motion(测试版),用 apply_animation_style 或 apply_manual_keyframe_track,并用 set_timeline_duration 设置时长。构建后用 get_screenshot 截图核对并修复偏差。
使用方式:操作对象是已连接的 Figma 文件,插件须处于当前会话,且目标文件需处于打开状态;不支持按 URL 抓取。构建前先用 ping 确认插件已连接。若同时打开多个文件且未指定,工具结果会出现“MORE THAN ONE FIGMA FILE IS OPEN”提示,此时先用 list_files 列出文件,再用 use_file({ fileName }) 认领;同名文件可用 use_file({ sessionId })。后续调用即作用于已认领文件,即使其标签页在后台。用户未说明文件时应询问,不要猜测。
适用场景:把已有代码或文字描述落成符合当前 Figma 文件风格的设计稿,复用该文件的设计系统,或在其缺失时补建设计系统资产(变量/集合、画布/文字样式、组件及变体)。
限制:必须先有已连接的 Figma 文件且处于打开状态;设计系统若位于已发布的团队库,文件内读取可能为空,需要到库文件读取对应 key 并导入;Motion 目前仅支持 Figma Design,关键帧需附加在顶层 frame 的图层上。其他未在资料中说明的功能、收费与平台支持情况暂未提供。