使用selection checker插件可自动化识别并清理figma中重复frame：一、安装启用插件；二、配置模糊匹配与类型过滤规则；三、扫描高亮重复组；四、归档后二次确认删除；五、用api+脚本验证残留。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在Figma文件中发现大量命名重复、结构雷同或未被引用的Frame，可能导致图层混乱、协作误解及性能下降，则可能是由于设计迭代过程中未及时归档或删除冗余容器所致。以下是使用Selection Checker插件自动化识别与清理重复Frame的具体操作步骤：
一、安装并启用Selection Checker插件
Selection Checker是一款轻量级Figma社区插件，专用于批量扫描图层命名、类型、嵌套深度及可见性等元数据，支持按名称相似度阈值标记疑似重复Frame。该插件不修改原始结构，仅提供高亮与筛选视图，确保清理过程可控可逆。
1、打开Figma编辑器，点击右上角“Plugins”按钮，选择“Browse plugins”。
2、在搜索框中输入Selection Checker，找到作者为“Figma Community”且评分高于4.7的官方认证版本。
3、点击“Install”完成安装，随后勾选“Allow plugin to access your files”授权选项。
4、重启Figma桌面客户端或刷新网页版，确保插件状态显示为“Enabled”。
二、配置重复Frame识别规则
插件默认按完整名称匹配判定重复，但实际项目中常存在“Header_v2”“Header-copy”“Header-1”等变体。需手动调整匹配逻辑，启用模糊匹配与前缀过滤，避免误删关键变体。
1、在画布任意空白处右键，选择“Plugins → Selection Checker → Run”。
2、在弹出面板中点击“Settings”图标，将“Matching Mode”切换为Fuzzy Match (Levenshtein distance ≤ 3)。
3、在“Filter by Type”下拉菜单中仅勾选Frame，取消勾选Group、Component等其他类型。
4、于“Exclude Patterns”输入框中填入正则表达式^.*-backup$|^.*_archive$，自动排除明确标注为备份的Frame。
三、执行批量筛选与高亮定位
插件将遍历当前页面（Page）内所有Frame，依据设定规则计算名称相似度矩阵，对得分高于阈值的Frame组进行分组着色，便于视觉区分与人工复核。
1、点击面板顶部“Scan Current Page”按钮，等待扫描完成（通常耗时2–8秒）。
2、扫描结果以列表形式呈现，每组重复项顶部显示编号如“Group #7”，右侧标注匹配数（例：“4 Frames matched”）。
3、点击任一组右侧的Highlight All按钮，对应Frame在画布中将以红色半透明遮罩高亮，同时图层面板同步滚动至首个匹配项。
4、使用键盘Shift + 鼠标点击在图层面板中多选同一组内全部Frame，为后续清理做准备。
四、安全批量删除或归档重复Frame
直接删除存在误操作风险，推荐采用“临时归档+二次确认”流程：先将疑似重复Frame移入专用归档页，保留72小时观察期，再执行最终清除。
1、新建一个名为“ARCHIVE_DuplicateFrames”的新Page，通过拖拽方式将高亮选中的Frame整体移入该页。
2、在归档页中，全选所有Frame，右键选择“Rename → Batch Rename”，统一添加前缀[DUPE]_。
3、在归档页顶部添加文本注释框，注明清理时间、操作人及原始所属页面路径，例如："2026-05-11 | @designer | Source: Home_Page_v3"。
4、保存文件后，通知协作成员在24小时内核查归档内容；若无异议，再进入该页执行“Select All → Delete”。
五、通过命令行脚本辅助验证残留
Selection Checker仅作用于UI层，无法检测已隐藏但未删除的Frame。需结合Figma REST API导出JSON结构，用脚本比对命名哈希值，确保深层残留被识别。
1、访问Figma开发者控制台（developers.figma.com），创建Personal Access Token并记录密钥。
2、运行以下curl命令导出当前文件结构（替换FILE_KEY与TOKEN为实际值）：
curl -X GET "https://api.figma.com/v1/files/{FILE_KEY}/nodes?ids={NODE_IDS}" -H "X-Figma-Token: {TOKEN}" > figma_structure.json
3、使用Python脚本解析JSON，提取所有type为“FRAME”的节点name字段，生成MD5哈希值列表。
4、执行去重统计命令：sort hash_list.txt | uniq -d，输出即为服务端确认的真正重复命名Frame ID。
