连接、文件绑定与能力边界
Figwright 由本机 MCP 服务、转发连接和 Figma 插件组成。AI 发出工具调用，插件在打开的 Figma 文件中读写。服务存在、插件连接、文件绑定和具备编辑权限，是需要分别确认的条件。
每次工作从确认目标开始
1. ping：确认本机服务与插件端到端连通
2. list_files：列出当前可达文件
3. use_file：用准确 fileName 或 sessionId 绑定 figma-demo
4. get_metadata：确认文件名、当前页和编辑器模式
5. 读取目标节点、现有组件、变量和样式
6. 再执行约定范围内的修改
多个文件同时打开时，默认路由可能跟随前台文件改变。重名文件要用 sessionId 区分。文件绑定是当前连接的路由状态，重启服务后应重新确认。
不要假设子代理有独立文件路由；当前官方 README 说明同一 MCP 客户端的子代理共享 file claim。多人或多代理操作同一文件时，统一写入负责人更容易避免冲突。
先熟悉这些工具分工
| 目的 | 工具 | 使用重点 |
|---|---|---|
| 文件与定位 | ping、list_files、use_file、get_metadata、search_nodes | 先确认身份再写入 |
| 布局读取 | get_design_context、get_node | 限定深度与目标范围 |
| 布局写入 | create_frame、set_auto_layout、set_layout_props | 父容器与子项尺寸分开 |
| 组件 | get_component_api、create_instance、set_instance_properties | 使用真实属性键 |
| 设计值 | get_variable_defs、get_styles、bind_variable_to_node | 检查绑定而不只看数值 |
| 原型 | get_reactions、set_reactions、update_flows | 设置时可能替换旧配置 |
| 验收与资产 | get_screenshot、save_screenshots、save_image_fills | 区分渲染图和原始素材 |
无需把目录里的所有工具背下来。你负责说明意图与验收，AI 负责依据当前 schema 选择参数，并提供读回证据。
看得见不等于所有能力都可用
Figma Design 的权限、Dev Mode、套餐、字体和当前工具版本都会影响能力。Dev Mode 是只读环境；变量原型和额外模式等功能需要核对计划。工具列表存在，也不表示该调用在当前文件一定成功。
Figwright 可以创建布局、组件和原型，也可以导出图片；它没有把任意 Figma 文件自动变成完整微信小游戏的通用保证。Canvas、引擎场景、触控和业务逻辑需要独立实现。
第一条连接提示词
请只做连接与目标核查，暂不写入。
运行 ping、list_files，绑定准确名为 figma-demo 的文件。
报告当前页、编辑器模式及已连接文件，确认未指向“接线小游戏”。
再读取目标 Section 的浅层结构、组件、变量和样式。
若目标缺失或有同名歧义，先报告证据。
文件名、节点 ID 与链接
节点 ID 定位文件内对象；sessionId 定位当前连接；Figma 文件链接还需要 file key。当前插件可能无法提供 file key，不能用 sessionId 拼造公开链接。需要分享原型时，在 Figma 的分享界面按现有权限复制实际链接。
练习与检查
在两个文件同时连接时切换前台标签，再让 AI 读回已绑定文件名。确认它仍是 figma-demo。只在教学文件中做这个实验。
依据：Figwright 官方仓库。核查：2026-10-31；本案例制作时服务与插件版本为 0.7.0，实际可用工具以当前客户端为准。