@epoint-testtech/ep-stage-skill 0.0.4-alpha.1 → 0.0.6

package/codex-skill/ep-stage/page-element-scan/scripts/extract-page-elements-eval.mjs

@@ -0,0 +1,233 @@
+/**
+ * extract-page-elements-eval.mjs
+ *
+ * 专供 playwright-cli eval 注入使用的浏览器端扫描内核。
+ * ！！！此文件无任何 import/export，仅包含纯 JavaScript 函数。
+ * ！！！不要在 Node.js 环境中 import 此文件，会报 SyntaxError。
+ *
+ * 用法（shell 注入）：
+ *   playwright-cli -s=$SESSION eval "< $(cat extract-page-elements-eval.mjs) ; print(JSON.stringify(extractPageElements()))"
+ *
+ * 函数签名：
+ *   extractPageElements()           当前 frame 扫描，返回 { title, elements[] }
+ *   extractAllFramesElementMap()    所有 frame（含子 iframe）聚合，返回 { [label]: { locator, controlType, visible } }
+ */
+
+/* ─────────────────────────────────────────────────────────────────────────── */
+
+function norm(s) { return (s || '').replace(/\s+/g, ' ').trim(); }
+
+function isVisible(el) {
+  const st = window.getComputedStyle(el);
+  if (st.display === 'none' || st.visibility === 'hidden') return false;
+  const r = el.getBoundingClientRect();
+  return r.width > 0 && r.height > 0;
+}
+
+function isEnabled(el) {
+  const cls = el.className || '';
+  return !el.disabled
+    && el.getAttribute('aria-disabled') !== 'true'
+    && !String(cls).includes('mini-disabled')
+    && !String(cls).includes('disabled');
+}
+
+function fieldLabel(el) {
+  // 分页控件不在表单字段采集范围内
+  if (el.classList.contains('pagination-number')) return '';
+  if (el.closest('.mini-pagination, .pagination-pagerchange')) return '';
+  const wrapper = el.closest('[label]');
+  if (wrapper) return norm(wrapper.getAttribute('label'));
+  if (el.getAttribute('aria-label')) return norm(el.getAttribute('aria-label'));
+  if (el.id) {
+    const lab = document.querySelector('label[for="' + el.id + '"]');
+    if (lab) return norm(lab.innerText);
+  }
+  const containerLabel = el.closest('div, td').querySelector('label');
+  if (containerLabel) return norm(containerLabel.innerText).replace(/[:：]$/, '');
+  const prev = el.closest('td, div').previousElementSibling;
+  if (prev && /label|td/.test(prev.tagName.toLowerCase())) return norm(prev.innerText).replace(/[:：]$/, '');
+  return norm(el.placeholder || el.getAttribute('bind') || el.name || el.id || '').replace(/^[　 ]+|[　 ]+$/g, '') || '';
+}
+
+function controlType(el) {
+  const cls = String(el.className || '');
+  const mini = cls.match(/mini-[a-z]+/);
+  if (mini) return mini[0];
+  if (el.tagName === 'SELECT') return 'html-select';
+  if (el.tagName === 'TEXTAREA') return 'html-textarea';
+  return 'html-' + (el.type || 'input');
+}
+
+function hiddenInputLocator(el, label) {
+  const itemDiv = el.closest('.mini-radiobuttonlist-item, .mini-checkbox');
+  if (itemDiv && itemDiv.id) return '#' + itemDiv.id.replace(/[!\\#$%&'()*+,/:;<=>?@[\\]^`{|}~]/g, '\\$&');
+  if (label) {
+    const type = el.type === 'radio' ? 'mini-radiobuttonlist-item' : 'mini-checkbox';
+    return "xpath=//div[contains(@class,'" + type + "')][normalize-space()='" + label + "']";
+  }
+  return null;
+}
+
+function fieldLocator(el, label) {
+  const type = controlType(el);
+  const tag = el.tagName.toLowerCase();
+  if (label && type.startsWith('mini-')) {
+    const exact = "xpath=//div[@label='" + label + "']//" + tag + "[contains(@class,'" + type + "') or contains(@class,'" + type + "-input')]";
+    if (document.querySelector("div[label='" + label + "']")) return exact;
+    var bareLabel = label.replace(/\d+/g, '').replace(/\s+/g, ' ').trim();
+    return "xpath=//div[@label and contains(@label,'" + bareLabel.replace(/[^一-龥a-zA-Z]/g, '') + "')]//" + tag + "[contains(@class,'" + type + "') or contains(@class,'" + type + "-input')]";
+  }
+  if (el.id) {
+    if (el.id.includes('$')) {
+      var prev = hiddenInputLocator(el, label);
+      if (prev) return prev;
+    }
+    return '#' + el.id.replace(/[!\\#$%&'()*+,/:;<=>?@[\\]^`{|}~]/g, '\\$&');
+  }
+  if (el.name) return tag + '[name="' + el.name + '"]';
+  if (label) return "xpath=//div[@label='" + label + "']//" + tag;
+  return tag;
+}
+
+function buttonLocator(el, label) {
+  var tag = el.tagName.toLowerCase();
+  var cls = String(el.className || '');
+  if (cls.includes('mini-button')) return 'xpath=//' + tag + "[contains(@class,'mini-button')][normalize-space()='" + label + "']";
+  if (cls.includes('cond-srh-btn')) return "xpath=//a[contains(@class,'cond-srh-btn')][normalize-space()='" + label + "']";
+  if (el.id) return '#' + el.id;
+  return 'role=button[name="' + label + '"]';
+}
+
+/* ─── extractPageElements() ─── */
+
+function extractPageElements() {
+  var elements = [];
+  var seen = new Set();
+  function push(el) {
+    var key = el.type + '|' + el.label + '|' + el.locator;
+    if (seen.has(key)) return;
+    seen.add(key);
+    elements.push(el);
+  }
+
+  /* 按钮 */
+  document.querySelectorAll('a.mini-button, button, input[type=button], input[type=submit], input[type=reset], [role=button], a.cond-srh-btn, a.mini-tools, span.mini-tools').forEach(function(el) {
+    var label = norm(el.innerText || el.value || el.getAttribute('data-tooltip') || el.title || '');
+    if (!label) return;
+    push({ type: 'button', label: label, locator: buttonLocator(el, label), visible: isVisible(el), enabled: isEnabled(el) });
+  });
+
+  /* 表单字段 */
+  document.querySelectorAll('input:not([type=button]):not([type=submit]):not([type=reset]):not([type=hidden]), textarea, select').forEach(function(el) {
+    if (!isVisible(el) && el.closest('.mini-textbox, .mini-combobox, .mini-datepicker, .mini-spinner')) return;
+    if ((el.type === 'radio' || el.type === 'checkbox') && !isVisible(el)) return;
+    var label = fieldLabel(el);
+    if (!label) return;
+    push({ type: 'field', label: label, controlType: controlType(el), locator: fieldLocator(el, label), visible: isVisible(el), enabled: isEnabled(el) });
+  });
+
+  /* MiniUI RadioButtonList / CheckBox 独立控件 */
+  document.querySelectorAll('.mini-radiobuttonlist-item, .mini-checkbox').forEach(function(el) {
+    var input = el.querySelector('input[type=radio], input[type=checkbox]');
+    if (!input) return;
+    var label = norm(input.labels && input.labels[0] ? input.labels[0].innerText : el.innerText || '').replace(/[:：]$/, '');
+    if (!label) return;
+    var numInput = el.querySelector('.mini-export-num');
+    if (numInput) label = label.replace(/\d+/g, '');
+    var isRadio = input.type === 'radio';
+    var itemId = el.id;
+    var locator = itemId ? ('#' + itemId.replace(/[!\\#$%&'()*+,/:;<=>?@[\\]^`{|}~]/g, '\\$&'))
+      : "xpath=//div[contains(@class,'" + (isRadio ? 'mini-radiobuttonlist-item' : 'mini-checkbox') + "')][contains(normalize-space(),'" + label + "')]";
+    push({ type: 'field', label: label, controlType: isRadio ? 'mini-radiobuttonlist' : 'mini-checkbox', locator: locator, visible: isVisible(el), enabled: isEnabled(el) });
+  });
+
+  /* 列表 */
+  document.querySelectorAll('.mini-datagrid').forEach(function(grid) {
+    var gridId = grid.id || 'datagrid';
+    var headers = [].map.call(grid.querySelectorAll('.mini-grid-headertxt, .mini-grid-headerText, th'), function(h) { return norm(h.innerText); }).filter(Boolean);
+    var rowActions = [].map.call(grid.querySelectorAll('[data-tooltip]'), function(a) { return norm(a.getAttribute('data-tooltip')); }).filter(Boolean);
+    push({ type: 'grid', label: gridId, locator: '#' + gridId, visible: isVisible(grid), enabled: true, columns: headers, rowActions: rowActions });
+  });
+
+  /* 标签页 */
+  document.querySelectorAll('.mini-tabs li, [role=tab]').forEach(function(el) {
+    var label = norm(el.innerText);
+    if (!label) return;
+    push({ type: 'tab', label: label, locator: 'role=tab[name="' + label + '"]', visible: isVisible(el), enabled: isEnabled(el) });
+  });
+
+  /* 普通链接 */
+  document.querySelectorAll('a[href]:not(.mini-button)').forEach(function(el) {
+    var label = norm(el.innerText);
+    if (!label || !isVisible(el)) return;
+    push({ type: 'link', label: label, locator: 'role=link[name="' + label + '"]', visible: true, enabled: isEnabled(el), href: el.getAttribute('href') });
+  });
+
+  /* MiniUI 分页控件 */
+  document.querySelectorAll('.mini-grid-pager').forEach(function(pager) {
+    var parentGrid = pager.closest('.mini-datagrid');
+    var gridId = (parentGrid && parentGrid.id) ? parentGrid.id : 'datagrid';
+    var prefix = parentGrid ? ('#' + gridId.replace(/[!\\#$%&'()*+,/:;<=>?@[\\]^`{|}~]/g, '\\$&')) : '';
+
+    /* 总条数文本 */
+    var pagerInfo = pager.querySelector('.pagination-pagerinfo');
+    if (pagerInfo) push({ type: 'pagination', label: norm(pagerInfo.innerText), locator: prefix + ' .pagination-pagerinfo', visible: true, enabled: true });
+
+    /* 分页按钮 */
+    var btns = pager.querySelectorAll('.pagination-buttons a');
+    btns.forEach(function(btn) {
+      var action = btn.getAttribute('action');
+      var isEllipsis = btn.classList.contains('pagination-button-ellipsis');
+      var label = norm(btn.innerText) || '';
+      var subType = '', suffix = '';
+      if (action === 'prev') { subType = 'pagination-prev'; label = '上一页'; suffix = '.pagination-buttons a[action=prev]'; }
+      else if (action === 'next') { subType = 'pagination-next'; label = '下一页'; suffix = '.pagination-buttons a[action=next]'; }
+      else if (isEllipsis || action === 'none') { subType = 'pagination-ellipsis'; label = '...'; suffix = '.pagination-button-ellipsis'; }
+      else { subType = 'pagination-page'; label = norm(btn.innerText); suffix = '.pagination-buttons a.pagination-button:not(.pagination-button-ellipsis)'; }
+      push({ type: 'pagination', subType: subType, label: label, locator: prefix + ' ' + suffix, visible: isVisible(btn), enabled: !btn.classList.contains('disabled') });
+    });
+
+    /* 页面尺寸下拉 */
+    var pageSizeBtn = pager.querySelector('.mini-pagination > span.mini-buttonedit');
+    if (pageSizeBtn && isVisible(pageSizeBtn)) {
+      var hiddenVal = pageSizeBtn.querySelector('input[type=hidden]');
+      push({ type: 'pagination', subType: 'pagination-size', label: '页面尺寸', locator: prefix + ' .mini-pagination > span.mini-buttonedit', value: hiddenVal ? hiddenVal.value : '', visible: true, enabled: true });
+    }
+
+    /* 页码跳转输入框 */
+    var jumpInput = pager.querySelector('.pagination-pagerchange input.pagination-number');
+    if (jumpInput && isVisible(jumpInput)) {
+      push({ type: 'pagination', subType: 'pagination-jump', label: '跳至页', locator: prefix + ' .pagination-pagerchange input.pagination-number', visible: true, enabled: isEnabled(jumpInput) });
+    }
+  });
+
+  return { title: document.title, elements: elements };
+}
+
+/* ─── extractAllFramesElementMap() ─── */
+
+function extractAllFramesElementMap() {
+  var result = {};
+  function merge(el) {
+    if (!el.label) return;
+    if (!result[el.label] || el.visible) result[el.label] = { locator: el.locator, controlType: el.controlType, visible: el.visible };
+  }
+
+  /* 主 frame */
+  try { extractPageElements().elements.forEach(merge); } catch(e) {}
+
+  /* 子 frame */
+  try {
+    for (var i = 0; i < window.frames.length; i++) {
+      try {
+        var fr = window.frames[i];
+        if (fr.extractPageElements) {
+          fr.extractPageElements().elements.forEach(merge);
+        }
+      } catch(e) {}
+    }
+  } catch(e) {}
+
+  return result;
+}

package/codex-skill/ep-stage/page-element-scan/scripts/extract-page-elements.mjs

@@ -0,0 +1,298 @@
+/**
+ * extract-page-elements.mjs
+ *
+ * 可在浏览器上下文直接运行的 DOM 扫描内核（无外部依赖）。
+ * 用途：
+ *   1. 被 scan-page.mjs import 复用扫描逻辑
+ *   2. 被 playwright-cli eval "<call>" 注入到已有 session 中实时采集 element map
+ *
+ * playwright-cli eval 使用示例（主 frame）：
+ *   playwright-cli -s=$SESSION eval "< $(cat extract-page-elements.mjs) ; print(JSON.stringify(extractPageElements()))"
+ *
+ * playwright-cli eval 使用示例（遍历所有 frame）：
+ *   playwright-cli -s=$SESSION eval "< $(cat extract-page-elements.mjs) ; print(JSON.stringify(extractAllFramesElementMap()))"
+ *
+ * 导出函数签名：
+ *   extractPageElements()           -> { title, elements[] }          当前 frame 扫描
+ *   extractAllFramesElementMap()    -> { [label]: { locator, controlType, visible } }  所有 frame 聚合
+ */
+
+/**
+ * 单 frame 扫描内核（与 scan-page.mjs 内部逻辑保持同步）。
+ */
+function extractPageElements() {
+  const norm = (s) => (s || '').replace(/\s+/g, ' ').trim();
+
+  function isVisible(el) {
+    const style = window.getComputedStyle(el);
+    if (style.display === 'none' || style.visibility === 'hidden') return false;
+    const rect = el.getBoundingClientRect();
+    return rect.width > 0 && rect.height > 0;
+  }
+
+  function isEnabled(el) {
+    const cls = el.className || '';
+    return !el.disabled
+      && el.getAttribute('aria-disabled') !== 'true'
+      && !String(cls).includes('mini-disabled')
+      && !String(cls).includes('disabled');
+  }
+
+  function fieldLabel(el) {
+    // 分页控件（页码输入框、页面尺寸下拉框）：不在表单字段采集范围内
+    if (el.classList.contains('pagination-number')) return '';
+    if (el.closest('.mini-pagination, .pagination-pagerchange')) return '';
+    const wrapper = el.closest('[label]');
+    if (wrapper) return norm(wrapper.getAttribute('label'));
+    if (el.getAttribute('aria-label')) return norm(el.getAttribute('aria-label'));
+    if (el.id) {
+      const lab = document.querySelector(`label[for="${el.id}"]`);
+      if (lab) return norm(lab.innerText);
+    }
+    const containerLabel = el.closest('div, td')?.querySelector('label');
+    if (containerLabel) return norm(containerLabel.innerText).replace(/[:：]$/, '');
+    const prev = el.closest('td, div')?.previousElementSibling;
+    if (prev && /label|td/.test(prev.tagName.toLowerCase())) return norm(prev.innerText).replace(/[:：]$/, '');
+    return norm(el.placeholder || el.getAttribute('bind') || el.name || el.id || '').replace(/^[　 ]+|[　 ]+$/g, '') || '';
+  }
+
+  function controlType(el) {
+    const cls = String(el.className || '');
+    const mini = cls.match(/mini-[a-z]+/);
+    if (mini) return mini[0];
+    if (el.tagName === 'SELECT') return 'html-select';
+    if (el.tagName === 'TEXTAREA') return 'html-textarea';
+    return `html-${el.type || 'input'}`;
+  }
+
+  function hiddenInputLocator(el, label) {
+    const itemDiv = el.closest('.mini-radiobuttonlist-item, .mini-checkbox');
+    if (itemDiv && itemDiv.id) return `#${CSS.escape(itemDiv.id)}`;
+    if (label) {
+      const type = el.type === 'radio' ? 'mini-radiobuttonlist-item' : 'mini-checkbox';
+      return `xpath=//div[contains(@class,'${type}')][normalize-space()='${label}']`;
+    }
+    return null;
+  }
+
+  function fieldLocator(el, label) {
+    const type = controlType(el);
+    const tag = el.tagName.toLowerCase();
+    if (label && type.startsWith('mini-')) {
+      const exact = `xpath=//div[@label='${label}']//${tag}[contains(@class,'${type}') or contains(@class,'${type}-input')]`;
+      if (document.querySelector(`div[label='${label}']`)) return exact;
+      const bareLabel = label.replace(/\d+/g, '').replace(/\s+/g, ' ').trim();
+      return `xpath=//div[@label and contains(@label,'${bareLabel.replace(/[^一-龥a-zA-Z]/g, '')}')]//${tag}[contains(@class,'${type}') or contains(@class,'${type}-input')]`;
+    }
+    if (el.id) {
+      if (el.id.includes('$')) {
+        const prev = hiddenInputLocator(el, label);
+        if (prev) return prev;
+      }
+      return `#${CSS.escape(el.id)}`;
+    }
+    if (el.name) return `${tag}[name="${el.name}"]`;
+    if (label) return `xpath=//div[@label='${label}']//${tag}`;
+    return tag;
+  }
+
+  function buttonLocator(el, label) {
+    const tag = el.tagName.toLowerCase();
+    const cls = String(el.className || '');
+    if (cls.includes('mini-button')) return `xpath=//${tag}[contains(@class,'mini-button')][normalize-space()='${label}']`;
+    if (cls.includes('cond-srh-btn')) return `xpath=//a[contains(@class,'cond-srh-btn')][normalize-space()='${label}']`;
+    if (el.id) return `#${el.id}`;
+    return `role=button[name="${label}"]`;
+  }
+
+  const elements = [];
+  const seen = new Set();
+  function push(el) {
+    const key = `${el.type}|${el.label}|${el.locator}`;
+    if (seen.has(key)) return;
+    seen.add(key);
+    elements.push(el);
+  }
+
+  // 按钮
+  document.querySelectorAll(
+    'a.mini-button, button, input[type=button], input[type=submit], input[type=reset], [role=button], a.cond-srh-btn, a.mini-tools, span.mini-tools',
+  ).forEach((el) => {
+    const label = norm(el.innerText || el.value || el.getAttribute('data-tooltip') || el.title || '');
+    if (!label) return;
+    push({ type: 'button', label, locator: buttonLocator(el, label), visible: isVisible(el), enabled: isEnabled(el) });
+  });
+
+  // 表单字段
+  document.querySelectorAll(
+    'input:not([type=button]):not([type=submit]):not([type=reset]):not([type=hidden]), textarea, select',
+  ).forEach((el) => {
+    if (!isVisible(el) && el.closest('.mini-textbox, .mini-combobox, .mini-datepicker, .mini-spinner')) return;
+    if ((el.type === 'radio' || el.type === 'checkbox') && !isVisible(el)) return;
+    const label = fieldLabel(el);
+    if (!label) return;
+    push({
+      type: 'field', label, controlType: controlType(el),
+      locator: fieldLocator(el, label),
+      visible: isVisible(el), enabled: isEnabled(el),
+      required: el.required || el.getAttribute('required') === 'true' || !!el.closest('.starred, [starred]'),
+    });
+  });
+
+  // MiniUI RadioButtonList / CheckBox 独立控件（父 div 可点击）
+  document.querySelectorAll('.mini-radiobuttonlist-item, .mini-checkbox').forEach((el) => {
+    const input = el.querySelector('input[type=radio], input[type=checkbox]');
+    if (!input) return;
+    let label = norm(input.labels?.[0]?.innerText || el.innerText || '').replace(/[:：]$/, '');
+    if (!label) return;
+    const numInput = el.querySelector('.mini-export-num');
+    if (numInput) label = label.replace(/\d+/g, '');
+    const isRadio = input.type === 'radio';
+    const itemId = el.id;
+    const locator = itemId ? `#${CSS.escape(itemId)}`
+      : `xpath=//div[contains(@class,'${isRadio ? 'mini-radiobuttonlist-item' : 'mini-checkbox'})][contains(normalize-space(),'${label}')]`;
+    push({ type: 'field', label, controlType: isRadio ? 'mini-radiobuttonlist' : 'mini-checkbox', locator, visible: isVisible(el), enabled: isEnabled(el) });
+  });
+
+  // 列表
+  document.querySelectorAll('.mini-datagrid').forEach((grid) => {
+    const gridId = grid.id || 'datagrid';
+    const headers = [...grid.querySelectorAll('.mini-grid-headertxt, .mini-grid-headerText, th')].map((h) => norm(h.innerText)).filter(Boolean);
+    const rowActions = [...grid.querySelectorAll('[data-tooltip]')].map((a) => norm(a.getAttribute('data-tooltip'))).filter(Boolean);
+    push({ type: 'grid', label: gridId, locator: `#${gridId}`, visible: isVisible(grid), enabled: true, columns: headers, rowActions: [...new Set(rowActions)] });
+  });
+
+  // 标签页
+  document.querySelectorAll('.mini-tabs li, [role=tab]').forEach((el) => {
+    const label = norm(el.innerText);
+    if (!label) return;
+    push({ type: 'tab', label, locator: `role=tab[name="${label}"]`, visible: isVisible(el), enabled: isEnabled(el) });
+  });
+
+  // 普通链接
+  document.querySelectorAll('a[href]:not(.mini-button)').forEach((el) => {
+    const label = norm(el.innerText);
+    if (!label || !isVisible(el)) return;
+    push({ type: 'link', label, locator: `role=link[name="${label}"]`, visible: true, enabled: isEnabled(el), href: el.getAttribute('href') });
+  });
+
+  // MiniUI 分页控件
+  document.querySelectorAll('.mini-grid-pager').forEach((pager) => {
+    // 确定所属 grid 的 id
+    const parentGrid = pager.closest('.mini-datagrid');
+    const gridId = parentGrid?.id || 'datagrid';
+    const prefix = parentGrid ? `#${CSS.escape(gridId)}` : '';
+
+    // 总条数文本
+    const pagerInfo = pager.querySelector('.pagination-pagerinfo');
+    if (pagerInfo) {
+      const label = norm(pagerInfo.innerText); // 如 "共536条"
+      push({ type: 'pagination', label, locator: `${prefix} .pagination-pagerinfo`, visible: true, enabled: true });
+    }
+
+    // 分页按钮组
+    const btns = pager.querySelectorAll('.pagination-buttons a');
+    btns.forEach((btn) => {
+      const action = btn.getAttribute('action');
+      const isEllipsis = btn.classList.contains('pagination-button-ellipsis');
+      let label = norm(btn.innerText) || '';
+      let subType = '';
+      let locatorSuffix = '';
+
+      if (action === 'prev') {
+        subType = 'pagination-prev';
+        label = '上一页';
+        locatorSuffix = `.pagination-buttons a[action=prev]`;
+      } else if (action === 'next') {
+        subType = 'pagination-next';
+        label = '下一页';
+        locatorSuffix = `.pagination-buttons a[action=next]`;
+      } else if (action === 'none' || isEllipsis) {
+        subType = 'pagination-ellipsis';
+        label = '...';
+        locatorSuffix = `.pagination-button-ellipsis`;
+      } else {
+        // 页码数字按钮
+        subType = 'pagination-page';
+        label = norm(btn.innerText); // "1", "2", "49"
+        locatorSuffix = `.pagination-buttons a.pagination-button:not(.pagination-button-ellipsis)`;
+      }
+      push({
+        type: 'pagination',
+        subType,
+        label,
+        locator: `${prefix} ${locatorSuffix}`,
+        visible: isVisible(btn),
+        enabled: !btn.classList.contains('disabled'),
+      });
+    });
+
+    // 页面尺寸下拉（只采集可见的）
+    const pageSizeBtn = pager.querySelector('.mini-pagination > span.mini-buttonedit');
+    if (pageSizeBtn && isVisible(pageSizeBtn)) {
+      const hiddenVal = pageSizeBtn.querySelector('input[type=hidden]');
+      push({
+        type: 'pagination',
+        subType: 'pagination-size',
+        label: '页面尺寸',
+        locator: `${prefix} .mini-pagination > span.mini-buttonedit`,
+        value: hiddenVal?.value || '',
+        visible: true,
+        enabled: true,
+      });
+    }
+
+    // 页码跳转输入框
+    const jumpInput = pager.querySelector('.pagination-pagerchange input.pagination-number');
+    if (jumpInput && isVisible(jumpInput)) {
+      push({
+        type: 'pagination',
+        subType: 'pagination-jump',
+        label: '跳至页',
+        locator: `${prefix} .pagination-pagerchange input.pagination-number`,
+        visible: true,
+        enabled: isEnabled(jumpInput),
+      });
+    }
+  });
+
+  return { title: document.title, elements };
+}
+
+/**
+ * 遍历所有 frame（含子 iframe），对每个 frame 执行 extractPageElements()，
+ * 聚合所有 elements，去重后以 { label → { locator, controlType, visible } } 返回。
+ * 专供 playwright-cli eval 在 O-D-A-V Act 之后使用：捕获弹窗/子表等动态新增元素。
+ */
+function extractAllFramesElementMap() {
+  const result = {};
+  // 主 frame
+  try {
+    const main = extractPageElements();
+    for (const el of main.elements) {
+      if (!result[el.label] || el.visible) result[el.label] = { locator: el.locator, controlType: el.controlType, visible: el.visible };
+    }
+  } catch (_) {}
+
+  // 子 frame（通过 window.frames 枚举）
+  try {
+    for (let i = 0; i < window.frames.length; i++) {
+      const fr = window.frames[i];
+      try {
+        const r = fr.extractPageElements ? fr.extractPageElements() : null;
+        if (!r) continue;
+        for (const el of r.elements) {
+          if (!result[el.label] || el.visible) result[el.label] = { locator: el.locator, controlType: el.controlType, visible: el.visible };
+        }
+      } catch (_) { /* 跨域 frame 跳过 */ }
+    }
+  } catch (_) {}
+
+  return result;
+}
+
+// Node.js 环境：CommonJS 导出（被 scan-page.mjs import）
+// 浏览器 / playwright-cli eval 环境：全局函数直接可用
+if (typeof module !== 'undefined' && module.exports) {
+  module.exports = { extractPageElements, extractAllFramesElementMap };
+}