用途:从 Figma URL 导出指定 frame 的 PNG 截图,常用于取得设计稿静态截图,并在设计稿与实现比对前使用。
主要能力:支持 Figma 文件或 frame 的 URL,可指定 node ID、输出文件名与缩放倍数(默认 2x 分辨率)。
使用方式:需先设置环境变量 FIGMA_ACCESS_TOKEN,并安装依赖 pip install requests。运行命令:python scripts/figma-export.py "<figma_url>" --output design.png [--scale 2] [--node-id <id>]。参数中 figma_url 必填;--output 默认 figma-export.png;--scale 默认 2;--node-id 可从 URL 的 node-id= 参数取得。支持的 URL 格式包括 https://www.figma.com/file/XXXXX/FileName?node-id=1-2 与 https://www.figma.com/design/XXXXX/FileName?node-id=1-2。
限制与替代方案:必须配置 FIGMA_ACCESS_TOKEN。若没有 Token,可请使用者手动从 Figma 导出截图,或使用 Playwright 打开 Figma URL 截图(需使用者已登录 Figma)。