iter(g326): ua search 补同义词回退

.ua/backlog.json

@@ -3320,6 +3320,15 @@
       "motivation": "avatar 有 src 时直接渲染 img，加载失败（404 / 网络断开 / 权限过期）会露出浏览器默认碎图标，圆形容器里一块灰裂图比没有头像更难看；image 组件已有 error 兜底，avatar 没跟，同类组件口径不一致。",
       "acceptance": "① avatar img 注册 error 监听：加载失败就地替换为与无 src 时同款的文字头像（名称首字 + role=img + aria-label），尺寸与语义底色不变；② 正常加载路径零变化（不加多余请求）；③ manifest 文档 avatar props/步骤同步补一条兜底说明，verify 双向校验过；④ npm run check 通过。",
       "notes": ""
+    },
+    {
+      "id": "g326",
+      "domain": "tooling",
+      "status": "open",
+      "title": "ua search 同义词回退：中文口语词不再搜不到组件",
+      "motivation": "库内 id 全是英文（modal / select / spinner），而人和 Agent 张口就是「走马灯」「悬浮按钮」「分格输入」。这类词在 id / 标题 / 参数名 / 参数说明 / 步骤五层与配方三层里都没有原文，search 只剩 editDistance ≤ 3 的英文近似——对中文完全无效，于是「没有这个组件」的错误结论被反复得出，实际 carousel / floatButton / pinInput 都在库里。",
+      "acceptance": "① 新增 lib/synonyms.mjs：中文口语词 → 组件 id 的一组映射，一词只许归一组；② ua search 在五层 + 配方三层全空时按表回退（多词取交集，交集空退并集），命中行标「← 同义词「走马灯」」、页脚注明「按同义词表回退」，正常命中路径零变化不掺水；③ MCP search_components 共用同一份 fallbackBySynonym，返回项 matched.field 为「同义词」，CLI 与 MCP 口径不漂移；④ ua verify 校验表内每个 id 真实存在、同一个词不归两组，组件改名后残留即门禁红；⑤ npm run check 全绿。",
+      "notes": ""
     }
   ]
 }