SuperAPI AI 工具集

seed-verify-figma-mcp-transports

设计与创作

查看项目

更新于 10-15 20:30

技能介绍

用途:当 Figma MCP 工具的某个实现路径被修改后,用于对比 REST(个人访问令牌)与 WebSocket(Figma 插件)两条传输路径返回的结果,发现静默的传输行为偏差。仅修复一条路径也能通过类型检查,因此需要两条都跑并机械比对。

主要能力与流程:该技能按阶段执行。Phase 0 决定检查对象,从变更 diff 自行推导验证标准,必要时请求用户提供 layer URL;Phase 1 单独跑 REST,不需要人参与;Phase 2 准备 WebSocket(构建插件、后台启动 relay);Phase 3 是硬停止点,需要人工在 Figma 桌面应用中重载插件并连接,端口 3055,channel 固定为 local-default;Phase 4 同时探测并比对两条路径,用退出码判断是否存在差异;Phase 5 报告并清理只由本次启动的 relay。

用法要点:需设置 FIGMA_PERSONAL_ACCESS_TOKEN,安装 Figma 桌面应用,被测工具须已在探测脚本的 PROBES 中注册。REST 探测命令为 bun packages/mcp/scripts/probe-transports.ts --probe <tool> --transport rest --file-key <key> --node-id <id>;两条路径比对使用 --transport both。构建插件用 bun --filter figma-mcp build,启动 relay 用 bun packages/mcp/bin/index.mjs socket。同一文件复用时可将 file key 放入 SEED_MCP_PROBE_FILE_KEY,之后只传 --node-id。

限制:必须在主线程运行,Phase 3 需要真人操作 Figma 桌面应用,不能由子代理替代。不得猜测 WebSocket 结果、复用旧运行结果或从 REST 回填;超时应如实报告为超时。差异分为必须匹配、仅某传输独有、词汇不同、同字段不同渲染四类;词汇不同与渲染差异应报告而非加入 ignore列表,ignore 仅用于仅某传输独有的情况。未提供具体工具名、文件 key 或节点 id,需要用户自行提供。