[observe] 嵌套 cursor:pointer 子按钮被去重吞掉，多 CTA 卡片/弹出菜单子项 observe→act 够不到

[benbergg]

⚠️ 根因已订正：真根因是 observe.ts:1406 嵌套去重（非命名 isContainer），见 订正评论。下方原文保留作审计。

[observe] 嵌套 cursor:pointer 子按钮被去重吞掉，多 CTA 卡片/弹出菜单的子项 observe→act 够不到

Labels: bug, observe, P1
发现来源: N0062 vortex 生产能力评测 V3（班牛预发深度复测，2026-06-11，基线 047f3df）

现象

当一个 cursor:pointer 容器内含多个功能不同的 cursor:pointer 子按钮时，vortex_observe 只暴露最外层一个合并 ref，内部子按钮全部丢失。点击合并 ref 命中容器几何中心，往往是插图/描述等非动作区 → 点击无效。agent 仅靠 observe → act 无法触达子按钮，必须 vortex_evaluate 兜底。

复现（班牛，跨环境 3 次稳定复现）

环境：https://newbeta.bytenew.com/app.html（预发，也在 testc.bytenew.com 复现）

实例 1 — 创建工作表卡片

1. 进入空白 applet 首页，observe 中间「创建工作表」卡片
2. observe 仅得一个 ref，名为整片拼接文本 创建工作表…创建空白工作表模板中心创建
3. vortex_act click 该 ref → 命中卡片中心(插图)，effect.domMutations≈8，无导航
4. 但卡片内 创建空白工作表 / 模板中心 / 创建 是 3 个功能不同的子按钮，均未单独暴露

ground-truth 对照：对 创建空白工作表 span 直接 dispatch click（pointerdown/mousedown/.../click）→ location.hash 从 #/applet/appNew/appEmptyNew/12261/0 跳到 #/workCreate/12261，导航成功。证明子按钮才是正确目标。

实例 2 — 弹出菜单：点 addcube(+) 弹出菜单「模板中心创建 / 新建空白小程序」两项被合并成单一 tooltip ref，无法分别 targeting。

DOM 结构

DIV.create-box-list-item.createBox        (cursor:pointer)  ← observe 暴露的合并 ref
 └ DIV.create-box-list-item-box.box1       (cursor:pointer)
    └ SPAN "创建空白工作表"                  (cursor:pointer)  ← 真实点击目标，未暴露
 └ (模板中心 / 创建 ...)                      (cursor:pointer)  ← 同样未暴露

根因（推断，待 bench 实证）

packages/extension/src/handlers/observe.ts 命名逻辑（约 717-730 行）的 isContainer 判定：

const isContainer =
  el.querySelector(
    "a[href],button,input,select,textarea,[tabindex],[contenteditable=true]",
  ) != null;
if (text && !isContainer) return text;   // 非容器 → 用整片 textContent 命名为单一 leaf
...
if (isContainer) return "";              // 容器 → 返空交噪声过滤丢弃，内部交互项另行收集

isContainer 只检查原生交互后代，不含 cursor:pointer 后代。因此"内部只含 cursor:pointer 子按钮"的卡片不被判为容器拆分，而被当作单一 leaf 用整片 textContent 命名，子按钮丢失。

期望

容器内含多个独立 click 行为的 cursor:pointer 子元素时，应分别暴露为可 targeting 的 ref（或将 cursor:pointer 后代纳入 isContainer 判定，让外层卡片被当容器、子按钮单独收集）。

修复注意

• 与 aria-cursor-dedup / 自主发现引擎(子项目 0022)同族，dedup 策略改动易引入噪声回归 → 必须配 bench fixture + 单测（建议新增"多 CTA 卡片"+"弹出菜单多项"两个 fixture）。
• 仅当子 cursor:pointer 元素确有独立 click 行为/导向不同动作时才拆分，避免把"整卡可点"的纯展示卡片拆碎。

复合风险

若该缺陷出现在跨域 iframe 内（如班牛 VOC voc-testc.bytenew.com），vortex_evaluate 兜底不可用（跨域 evaluate 设计禁用），将彻底卡死该路径。

[benbergg]

⚠️ 根因订正（2026-06-11，基线 047f3df 代码追踪 + 经验性复现）

本 issue 原 body 将根因归到命名逻辑 observe.ts:717-730 的 isContainer。经白盒追踪 + MAIN world 经验性复现，该归因有误——子按钮并非"命名"丢失，而是在嵌套 cursor:pointer 去重阶段被 drop。

真根因：observe.ts:1389-1421 嵌套去重的第 1406 行

追踪 DIV.createBox（cursor:pointer，含 3 个 cursor:pointer 子按钮 创建空白工作表 / 模板中心 / 创建）：

1. 收集（1285-1363）：card 与 3 子按钮均 cursor:pointer 且无原生交互后代 → 全部进 cursorPointerExtras。hasInteractiveAncestor（1314）只查 ARIA 池，card 不在其中 → 子按钮不被短路，照常进池。
2. 卡吸收（1364-1387）：仅吸收"含原生交互后代的内容卡"，card 无原生交互后代 → 不触发。
3. 嵌套去重（1400-1421）：子按钮 leaf 上溯到 candidate 祖先 card，命中 1406 行判据
   ancText.length > leafText.length && ancText.includes(leafText) → dropSet.add(leaf) drop 子按钮、保 card。

1406 这条规则本为京东标签 <div>全部<span>96%好评</span></div>（ancestor 是单一语义标签、leaf 是其文本片段）设计。它无法区分另一结构：ancestor 文本 = 多个独立子按钮文本的拼接（createBox）——此时应保 leaves。

经验性证据（MAIN world 原样跑 1400-1421 去重）

{
  "cardText": "创建工作表创建空白工作表模板中心创建",
  "match_1406_for_b1": true,
  "survivors": ["createBox"],
  "dropped": ["SPAN:创建空白工作表", "SPAN:模板中心", "SPAN:创建"]
}

→ 只有外层 card 存活，3 子按钮全 drop。根因锁定 1406，与命名逻辑无关。 原 body 提的"改 isContainer"方向修不好此 bug。

修复方向（订正）

不是改命名，而是改 1406 嵌套去重：引入"多 leaf 计数"判据——若 candidate ancestor 有 ≥2 个独立 candidate 子 leaf（各有文本、互不为子串）→ 判为多 CTA 容器 → 保 leaves、drop ancestor；仅 1 个 leaf 时沿用现有保 ancestor；content-card（isClickableContentCard）豁免保 ancestor。可干净区分 JD 标签 / SKU / 评价卡 / createBox 四类。

同行业差异

Stagehand/Playwright 走真 a11y tree，无 role 的 cursor:pointer div 根本不进树 → 直接漏掉 createBox；vortex 的 cursor:pointer fallback 是领先项，去重是自研薄弱环节。嵌套交互本是 ARIA 反模式，无行业标准答案。

完整设计见知识库 N0062/reports/vortex-prod-eval-V3/解决方案设计.md。

[benbergg]

Task 0 probe 结论（2026-06-11 班牛预发实机白盒）：createBox 与弹出菜单是两个不同根因

本 issue 原文把「createBox 多 CTA 卡片」与「addcube 弹出菜单（模板中心创建/新建空白小程序）」当作同一症状。实机白盒确认它们是两个不同根因：

• 实例1 createBox：容器 + 3 子按钮全 cursor:pointer → 命中嵌套 cursor:pointer 去重 observe.ts:1406。已由 PR fix(extension): observe 嵌套 cursor:pointer 区分多 CTA 容器,保子项不再合并吞 (#42) #45 修复（真扩展 bench fixture multi-cta-card recall=3/3 坐实）。
• 实例2 弹出菜单：白盒 dump 显示子项是 el-popover(role=tooltip) 容器内的 cursor:auto DIV（非 cursor:pointer）：

  host: DIV role=tooltip cursor=auto class="el-popover el-popper"
  kids: DIV cursor=auto text="模板中心创建  新建空白小程序"
  

  observe 把 tooltip 整体按 name-from-content 合并成单一 ref，子项既非 cursor:pointer 也无独立 role → 不在 cursor:pointer 候选池，PR fix(extension): observe 嵌套 cursor:pointer 区分多 CTA 容器,保子项不再合并吞 (#42) #45 的多 CTA 去重不覆盖（且不应覆盖，其修复范围严格限定 cursor:pointer 多 CTA）。

弹出菜单（el-popover/tooltip 内 cursor:auto 菜单项被合并）需独立 follow-up——属另一类「框架弹层菜单项识别」问题（el-popover/el-dropdown menu item 无 role/cursor 信号）。建议另开 issue。