用途:在 Figma 设计系统与代码组件库之间做同步,依据 Figma MCP 服务器和 Code Connect 建立设计与代码的双向关联。
主要能力:通过 MCP 盘点 Figma 文件中的全部组件,按类别分组并识别变体与属性;扫描代码库中的组件库与已有 Code Connect 配置;比对两端,找出 Figma 有而代码无、代码有而 Figma 无、变体不匹配、命名不一致等差异;输出同步报告,包含总数、已同步、需生成、需更新、需建立 Code Connect 的统计及行动清单;可生成缺失组件、更新现有组件、创建或更新 Code Connect 映射,或仅出报告不改代码。
使用方式:先选择工作流(全量同步、部分同步、仅报告、仅 Code Connect),再执行盘点、比对与同步步骤。Code Connect 映射文件使用如下形式声明: // Button.figma.tsx import figma from '@figma/code-connect'; import { Button } from './Button';
figma.connect( Button, 'https://www.figma.com/file/abc123?node-id=1:234', { props: { variant: figma.enum('Variant', { Primary: 'primary', Secondary: 'secondary' }), size: figma.enum('Size', { Small: 'sm', Medium: 'md', Large: 'lg' }), disabled: figma.boolean('Disabled'), children: figma.string('Label'), }, example: ({ variant, size, disabled, children }) => ( <Button variant={variant} size={size} disabled={disabled}>{children}</Button> ), } );
同步报告按日期、Figma 文件、代码位置、汇总统计、需处理组件(生成、更新、建立 Code Connect)及建议组织。
适用场景:设计系统组件在设计与代码间出现漂移,需要盘点差异、补齐缺失组件、对齐变体或建立映射时。
限制与注意:资料未提供安装命令、具体调用命令、依赖版本或收费信息;保持组件命名与变体名大小写一致,尽量向后兼容,必要时验证编译、可访问性与深色模式;未明确要求时不应改变现有组件行为。