确认本地Figma客户端已运行且处于激活状态

打开macOS的活动监视器或Windows的任务管理器，搜索“Figma”进程。如果只看到“Figma.app（网页版）”或“Electron”而找不到“Figma Desktop”字样，说明当前使用的是纯网页版——【AI联动功能将完全不可用】。此时应关闭所有Figma标签页，随后双击桌面图标启动原生桌面客户端。

启动后，注意菜单栏右上角的Figma图标：若显示为彩色实心图标，说明状态正常；若为灰色空心图标，则表示后台挂起，需点击唤醒以保持激活。

启用Figma桌面端的AI服务监听端口

在Figma桌面客户端中，按下 Cmd + Shift + P（Mac）或 Ctrl + Shift + P（Win），调出命令面板。

输入“AI Settings”并回车进入设置页面。

找到“Local AI Bridge”开关并开启。此时界面底部会显示绿色提示：“Listening on port 54321”。【注意：若该端口被占用，AI指令将静默失败，既不报错也不执行】

如果遇到端口冲突提示，可手动修改：在设置页点击“Advanced → Change Port”，输入54322后保存，然后重启Figma客户端使更改生效。

在网页端绑定本地客户端实例

第一步：打开Figma官网，登录同一账号，进入任意设计文件。

第二步：点击右上角头像 → “Settings and account” → 左侧菜单选择“AI Integrations”。

第三步：在“Local Desktop Sync”区域，点击“Connect to running instance”。页面将自动检测本地服务，通常在10秒内显示“Connected to Figma Desktop v132.5+”绿色标识。

如果超时未连接成功，可刷新网页端页面，同时在桌面端设置页点击“Refresh Instance ID”按钮，再重新尝试绑定。

执行AI指令并验证双向同步

方法一：在网页端选中一个Frame，右键 → “Ask AI about this selection”，输入“Add hover state with subtle scale transform”。AI返回结果后，点击“Apply to Desktop”，本地Figma中即会立即生成悬停交互原型。

方法二：在桌面端Figma中，对任意文本图层双击编辑，输入“/ai summarize this paragraph”，AI摘要结果会实时出现在网页端同一文件的右侧预览面板中。

验证同步是否成功：在桌面端修改某组件颜色后，网页端对应图层应在3秒内自动高亮边框；反之亦然。如果延迟超过8秒，需检查系统防火墙是否拦截了54321端口的本地回环通信。