技能介绍

解决免费账号的写入死局

在 Figma 中让 Agent 自动生成或修改设计稿时，免费账号（Free Plan）通常会直接撞墙。官方远程 MCP（mcp.figma.com）强制要求付费席位和 OAuth 白名单，普通客户端基本连不上；而桌面端本地 MCP Server 藏在付费的 Dev Mode 中，免费账号同样无权使用。

本技能的核心思路是利用 Figma Console MCP。由于它走的是 Plugin API 进行写操作，这在包括免费套餐在内的所有套餐中都可用，完美绕过了席位与白名单限制。

核心工作流与关键步骤

要跑通这套方案，需要一次性配置环境并建立本地桥梁。

预装与配置：提前安装 Console MCP 二进制文件（避免 npx 现场下载超时），并在 mcp.json 中直接调用该二进制路径。重启 WorkBuddy 并信任连接器后，系统会加载 100+ 个工具。
桌面端桥接：每次写设计前，需在 Figma 桌面端的目标文件中手动运行 Bridge 插件。插件会扫描本地端口（9223–9232），将 MCP 服务与当前文件连接。
节点创建与校验：Agent 通过 figma_execute 传入创建节点（如 frame、text）的代码执行写入。

适用边界与避坑指南

在实际工程落地中，有几个明显的坑需要注意：

异步返回值陷阱：如果在 figma_execute 中使用了 await figma.loadFontAsync(...)，MCP 会因为不等异步返回值而报错 returned undefined，但节点其实已经创建成功。判断成败必须用 findChild(...) 或 findAll(...) 进行二次查询，千万别依赖执行的 return 值。
端口与进程残留：如果 Bridge 插件已运行但状态接口报 No active file connected，通常是早前残留的 node.exe 占用了端口，需要清理进程。
Cloud Mode 兜底：如果不想折腾桌面端插件，可以改用 HTTP 模式的云端服务，但这仅提供约 44 个写工具，能力有所缩减。