断开关联的组件实例可通过三种方式修复：一是用figma内置relink instance功能手动重连；二是用ai插件scan & relink批量智能匹配；三是通过figma cli导出json并脚本替换componentid实现底层修复。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在Figma中发现组件实例显示为“断开关联”（Detached），即无法响应主组件更新、图层标签显示为灰色或提示“Instance of missing component”，则可能是由于主组件被移动、重命名、删除或跨文件引用失效所致。以下是使用Figma原生功能与AI增强方式修复断开组件关联的具体操作方法：
一、使用Figma内置Relink Instance功能手动重连
该方法适用于主组件仍存在于当前文件或已导入的共享库中，仅因路径变更导致实例无法自动识别其来源。Figma 133+版本起提供可视化重连入口，无需插件即可定位并绑定正确主组件。
1、在画布或图层面板中选中一个已断开的实例（图层名旁带⚠️图标或显示“Detached”）。
2、右键点击该实例，在弹出菜单中选择Relink Instance选项。
3、系统将自动扫描当前文件所有页面中的组件，列出名称匹配度最高的候选主组件列表。
4、从列表中选择正确的主组件，点击确认，所有同名断开实例将同步完成重连。
5、若未出现匹配项，可点击Browse Components手动导航至目标主组件所在页面并拖入确认区域。
二、通过Figma AI插件Scan & Relink执行智能批量识别
当断开实例数量庞大、主组件分散于多个文件或名称已被修改时，人工逐个Relink效率极低。AI插件可通过语义比对图层结构、文本内容、颜色分布及嵌套逻辑，自动推断最可能的原始主组件，并支持跨文件匹配。
1、在Figma桌面端点击右上角“资源” → “插件”，搜索并安装Scan & Relink插件（需v2.8+）。
2、全选所有标记为Detached的实例（支持跨页面Ctrl/Cmd+A多选）。
3、运行插件后，勾选Enable AI Structure Matching以启用深度图层拓扑分析。
4、点击Analyze & Suggest Sources，插件将在3–8秒内返回每个实例的Top 3匹配主组件及其置信度评分。
5、勾选全部建议项，点击Apply All Relinks，插件将自动执行批量重连并记录操作日志。
三、借助Figma CLI + JSON解析脚本实现底层路径修复
对于因主组件被移至外部共享库或文件ID变更导致的深层断连，Figma界面层无法识别原始引用关系。此时需直接操作文件底层JSON结构，通过比对componentId哈希值与当前库中有效componentKey，重建实例指向。
1、使用Figma CLI执行命令：figma export file --id
2、运行Python脚本加载backup.json，提取所有instances节点的componentId字段及对应name属性。
3、访问目标共享库API端点：https://api.figma.com/v1/files/
4、对每个断开实例的componentId进行模糊哈希匹配，找到key字段最接近的主组件条目。
5、在backup.json中将该实例的componentId字段替换为匹配主组件的key值，保存后执行figma import file --input ./repaired.json重新载入。
