SuperAPI AI 工具集

figma-kiwi-protocol-decode

设计与创作

查看项目

更新于 10-16 09:48

技能介绍

用途:解码 Figma 使用的 Kiwi 二进制序列化协议(基于 WebSocket 的实时同步帧),绕过 REST API 速率限制,无需付费计划即可读取场景图、SVG 矢量与 CSS,并能将变更写回正在编辑的文件。

主要能力:读取路径通过 Chrome DevTools Protocol 拦截 WebSocket 帧并解码;写入路径通过独立 Node WebSocket 连接 Figma 多人协作端点,应用实时生效的变更。支持捕获全部页面、解码为 JSON 场景图、提取 SVG、提取评论(含线程回复)、按 guid 重命名图层、启用自动布局、深克隆组件、从 JSON 批量变更。库导出 commandsBlobToPath、vectorNetworkBlobToPath、extractSvgs、extractCSSFromKiwi、isFigWireFrame、mergePages、buildTree 等函数,另有 FigmaSession、cloneSubtree、FigmaBuilder 模块。

使用方式:安装 npm install figma-kiwi-protocol。读取需以 --remote-debugging-port=9222 启动 Chrome,并设置 CDP_WS_URL、FIGMA_TOKEN、FIGMA_FILE_KEY,再运行 npx figma-kiwi-protocol capture-all-pages、decode、extract-svgs 等命令。写入前需先运行 recon-handshake 抓取握手信息(写入 /tmp/figma_handshake.json),再执行 write rename、write enable-al、clone、write batch 等命令。MCP 服务器工具包括 figma_pages、figma_page、figma_node、figma_search、figma_css、figma_texts、figma_components。

适用场景:需要程序化读取 Figma 设计数据、批量重命名图层、批量应用自动布局、克隆组件子树或在代码中从头构建节点的设计与开发流程。

限制:已知复合图标需变换组合,SVG 路径可能不正确;cookie 会过期,写入失败需重新运行 recon;guid 为 sessionID:localID 格式且随会话变化;变更需 Figma 文件在浏览器中保持 WebSocket 连接;部分属性仅适用于特定节点类型(如 stackMode 仅限 FRAME)。具体收费与平台信息资料未提供。