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

package/codex-skill/ep-stage/glue-run-test/references/playwright-cli-odav.md

@@ -0,0 +1,166 @@
+# playwright-cli O-D-A-V
+
+本文件用于 `/glue-run-test` 中的 Agent Runtime 推理阶段。`playwright-cli` 是 Playwright 官方为 coding agent 设计的一次性子命令 + 后台 daemon 工具（`https://playwright.dev/agent-cli/introduction`，v0.1.15+）。Agent 每次跑单个子命令，浏览器状态由后台 daemon 跨命令保持；不是 REPL、不需要长驻 stdin 通道，与 Claude Code 无头 Bash 单次调用模型天然对齐。
+
+`playwright-cli` 不是推理引擎；Agent 读取 `ai-runtime-trace.json5.tasks[]` 后，用它观察和操作真实页面，然后按 dev-rules.md 把原料改写为 `test()` snippet 写入 `ai-snippets.json5`。
+
+## 前置
+
+- 本机全局安装 `playwright-cli`：`which playwright-cli` 有输出。
+- 目标业务系统网络可达（`credentials.json5.loginUrl` / `contract.base.navigation.directUrl`）。
+- 已有 `credentials.json5`，至少一条完整业务角色凭据（`url / username / password` 非空）。
+
+## 输入
+
+- `<caseDir>/.ep-stage/ai-runtime-trace.json5`：CLI `prepare-tasks` 产出的任务包（tasks[]）。
+- `<caseDir>/testcase.json5`：`testAccess.requiredRoles[0]` = primary role，`contract.base.navigation.directUrl` = 列表页直达链接。
+- `<caseDir>/credentials.json5`：按 primary role 取 `loginUrl / username / password`。
+- `docs/00-memory/dev-rules.md`：snippet 代码规范，必须先读。
+- `<caseDir>/crud.spec.ts`：glue 骨架 spec，参考已就位的 `crudSlots / exportSlots / directListUrl / credentialsPath / primaryRole` 常量。
+
+## Session 生命周期
+
+每次 AI runtime 用一个 daemon session 名，建议 `<moduleId>-<timestamp>`（如 `zwplace-20260703011800`）。**所有子命令都必须传 `-s=<name>`**，daemon 会在浏览器进程里保持登录状态 / cookies / localStorage：
+
+- 开始：`playwright-cli -s=<name> open <loginUrl> --headed`。**必须传 `--headed`**：AI runtime 钻探期间要求人工旁观真实浏览器，验证 O-D-A-V 步骤符合业务意图；不允许 headless 默认，避免"看不见的黑盒操作"导致 snippet 幻觉进入 spec。
+- 全程：命名不变，Agent 每步传 `-s=<name>`。
+- 结束：`playwright-cli -s=<name> close`；异常兜底 `playwright-cli kill-all`。
+- 清理：`playwright-cli -s=<name> delete-data` 清 session 存储。
+- 枚举：`playwright-cli list` 查现存 session。
+
+## 执行剧本
+
+### Step 1 — 登录
+
+```bash
+SESSION="<moduleId>-$(date +%Y%m%d%H%M%S)"
+playwright-cli -s="$SESSION" open <loginUrl> --headed  # 强制有头：AI runtime 钻探必须可视化，禁止无头
+playwright-cli -s="$SESSION" snapshot                 # 输出 .playwright-cli/page-*.yml，含 accessibility tree + refs
+# 读 snapshot yml 找账号 / 密码 / 登录按钮的 ref（形如 e12, e13, e15）
+playwright-cli -s="$SESSION" fill e12 "<username>"
+playwright-cli -s="$SESSION" fill e13 "<password>"
+playwright-cli -s="$SESSION" click e15
+playwright-cli -s="$SESSION" snapshot                 # 验证登录成功（URL 或首页 DOM 特征）
+playwright-cli -s="$SESSION" state-save <caseDir>/.ep-stage/auth.json   # 可选：状态保存
+```
+
+### Step 2 — 直达列表页
+
+```bash
+playwright-cli -s="$SESSION" goto <directUrl>
+playwright-cli -s="$SESSION" snapshot                 # 观察列表页 iframe / 表格 / 按钮 refs
+```
+
+### Step 3 — 对每条 AI task 做 O-D-A-V
+
+| 阶段 | Agent 行为 | playwright-cli 原子命令 |
+|---|---|---|
+| Observe | 观察当前页面 / iframe / 控件 / 弹窗 / 列表结构，读 accessibility tree yml 拿 refs | `snapshot` |
+| Decide | 对照 task.businessIntent / assertionExpectation 决定下一动作 + 期望断言 | Agent 推理（不调 CLI） |
+| Act | 在真实页面试操作 | `click <ref>` / `fill <ref> <text>` / `select <ref> <val>` / `check <ref>` / `hover <ref>` / `press <key>` / `drag <src> <dst>` / `upload <ref> <file>` |
+| Verify | 二次 snapshot 或抽取具体值形成断言 | `snapshot` / `eval "<js>"` / `console` / `network` |
+
+关键点：
+
+- **每一步 Act 之后必须 snapshot / eval 验证动作生效**，才能进入下一步 Act。`click` / `fill` / `select` 等 CLI 命令 exit=0 只代表 shell 调用无异常，**不代表页面 state 真的变了**：hover-only 展开的下拉、异步加载的 iframe、表单前置校验拦截、遮罩层拦截都可能让浏览器静默无响应而 CLI 依然 pass。发现动作无生效 → 先补前置动作（`hover` 触发展开、`snapshot` 等待重挂载、`press Tab` 触发 blur）再 snapshot 二次确认，**不要**在假设动作已生效的前提下径直进入下一步 Act，否则会产生"silent no-op"假通过污染 snippet。
+- **refs 每次 snapshot 后重新编号**，不要跨 snapshot 缓存 ref。每次动作前先 snapshot 拿新 ref。
+- `eval "<js>"` 用于抽取具体 DOM 内容作为断言值（如 `document.querySelector('#toast').innerText`）；只用于验证不用于动作。
+- 弹窗遮罩 / iframe 变化 → 必须 snapshot 重新拿 refs。
+- 每条 task 探索完，把当前 snapshot yml 路径记入 result.evidence，支撑可观测性 gate（"无来源不入契约"）。
+
+### Step 3b — 表单填充策略（新增弹框 / 编辑弹框）
+
+弹窗表单在子 iframe 内，**playwright-cli 的 `click <ref>` / `fill <ref>` 够不着 iframe 元素**（snapshot refs 只覆盖主 frame）。iframe 内操作一律走 `run-code` + `page.frames()` 定位：
+
+```bash
+playwright-cli -s=$SESSION run-code "async page => { const f = page.frames().find(fr => fr.url().includes('<addIframeSrcKeyword>')); ... }"
+```
+
+1. **优先策略 — 一键填充（clickIfExist 语义）**：
+   - 读取 `crud.spec.ts` 中 `crudSlots.locators.addAutofillTrigger`（典型值为 `xpath=//*[@title="默认填充"]`）。
+   - 用 run-code 在弹窗 frame 内探测该按钮，**找到才点，找不到（约 2 秒）直接跳过**——与骨架 `clickIfExist({ timeout: 2_000 })` 行为一致；部分页面本来就没有此按钮，不算失败。
+   - 点击后验证字段已自动填入。一键填充能正确触发 MiniUI 组件验证、正确选择下拉 option value。
+
+2. **兜底策略 — run-code + Playwright locator API**（一键填充不存在时使用）：
+   - **文本字段**：`f.locator('xpath=//div[@label="场所名称"]//input[contains(@class,"mini-textbox-input")]').fill(value)`。Playwright `fill` 会触发完整事件链（focus → input → change），MiniUI 验证状态正常。
+   - **下拉框（listbox / combobox）**：`f.locator('//div[@label="场所分类"]//span[@name="trigger"]').filter({ visible: true }).click()` 展开 → 选项定位**必须加 `.filter({ visible: true })`**：`f.locator('//table[contains(@class,"mini-listbox-items")]').filter({ visible: true }).locator('xpath=.//td[...]').first()`。MiniUI 的选项表在 DOM 中有**常驻隐藏副本**，不加 visible 过滤会拿到隐藏副本导致 waitFor 超时（与骨架 `listbox-component.ts` 行为一致）。
+   - **禁止**用 `eval` 直接赋值 `input.value = "xxx"`——这会绕过 MiniUI 内部验证状态，保存时字段被识别为空（实测踩坑：值在 input 里可见，但保存报"不能为空"）。
+   - **禁止**直接填 option text 到 hidden value（如下拉隐藏域 `placecategory$value`）——显示文本与值会脱节。
+   - 所有填写动作后必须验证字段值已生效（run-code 读回或补扫 elementMap），再进入下一步。
+
+### Step 3c — 弹窗与 iframe 操作要点
+
+1. **点击触发按钮（新增/修改/查看）后必须等弹窗 iframe 注册**：`page.waitForTimeout(1500~2000)` 或轮询 `page.frames().find(fr => fr.url().includes('<keyword>'))`。**找不到 frame 不要立即重点触发按钮**——弹窗可能正在打开，重复点击会被遮罩层拦截，造成假超时假象。
+2. **弹窗 frame 定位优先用 contract 关键字**：`crudSlots.frames.addIframeSrcKeyword / editIframeSrcKeyword`（如 `gxhzwplaceadd` / `gxhzwplaceedit`；详情页形如 `gxhzwplace<module>detail`）。不要临时发明泛指关键字（如 `frameUrlSecretParam`）——会同时匹配新增/编辑/详情多个弹窗 frame，定位失真。
+3. **run-code 沙箱能力边界**：沙箱内只有 Playwright API（`page` 及入参），**无 Node 内置模块**——`require` 未定义、dynamic `import()` 报 `ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING`。需要 fs 能力时（如验证下载文件大小）：run-code 内只取 `download.path()` / `download.suggestedFilename()` 返回，文件大小在 bash 侧 `ls -la` 验证。
+4. **弹窗关闭判断**：`!page.frames().some(fr => fr.url().includes('<keyword>'))` 为 true 即弹窗已关。「保存」类按钮业务语义是不关弹窗（草稿继续编辑），「保存并关闭」才关——不要用错预期。
+
+### Step 4 — Snippet 改写
+
+按 `dev-rules.md` 把 playwright-cli 观察 / 动作原料转成 `test()` snippet：
+
+- 不直接照搬 playwright-cli 里的 ref 编号（`e12`）到 spec；spec 里用 Playwright locator API（`page.getByRole` / `page.getByLabel` / `page.locator('xpath=...')`），从 snapshot 里读元素的 role/name/text 语义信息生成稳定 locator。
+- 元素定义变量统一 `repo` 前缀：`repoBtn同步` / `repoInput场所名称` / `repoTable列表`。
+- 用锚点作用域缩小定位范围（列表行、弹框内），避免全页裸定位。
+- 保留 caseId 注释：`// caseId: TC01011`，便于 trace 对齐。
+- 复用 `crud.spec.ts` 已声明的 `directListUrl / credentialsPath / primaryRole / crudSlots / exportSlots` 常量，不重复声明。
+
+## 输出
+
+写 `<caseDir>/.ep-stage/ai-snippets.json5`：
+
+```json5
+{
+  schemaVersion: 'ep-stage-ai-snippets/v1',
+  testcasePath: '<testcase.json5绝对路径>',
+  generatedAt: '<ISO时间>',
+  results: [
+    {
+      caseId: '<task.caseId>',
+      status: 'resolved',
+      observation: { summary: '<观察摘要>' },
+      decision: { action: '<动作决策>' },
+      actionFlow: ['<已验证动作>'],
+      verification: { assertionExpectation: '<断言依据>' },
+      specSnippet: "test('...', async ({ page }) => {\\n  ...\\n});",
+      evidence: [{ source: 'playwright-cli', note: '<证据说明，含 snapshot yml 路径>' }],
+    },
+  ],
+}
+```
+
+> **specSnippet 必须是合法 JSON5 字符串**（单/双引号 + 转义），禁止用反引号模板字符串书写整个值——JSON5 不支持 `` ` ``，`run` 子命令解析 ai-snippets.json5 时会直接抛 `JSON5: invalid character '`'` 崩溃。snippet 代码内部含模板字符串（`` `...${...}...` ``）没问题，它只是字符串内容；建议用脚本 `JSON.stringify` 生成文件而非手写。
+
+无法访问 `playwright-cli`、目标系统网络不通、页面信息不足或断言无法确认时，不强造 snippet：
+
+```json5
+{
+  caseId: '<task.caseId>',
+  status: 'needs_review',
+  observation: { summary: '<无法继续的原因>' },
+  evidence: [{ source: 'agent-runtime', note: '<需要人审补充的信息>' }],
+}
+```
+
+## 附录 A — MiniUI 常见控件定位模式
+
+O-D-A-V 中反复用到的稳定模式，优先于临时推导：
+
+- **行勾选**：`#datagrid tr[<行条件>]//td[contains(@class,'checkcolumn')]//span`。**禁止**用 `td:first-child` / `td.first()`——首列未必是勾选列，点击不落 checkbox 时后续删除按钮静默无反应。勾选生效信号：行 `class` 含 `mini-grid-row-selected`。
+- **下拉弹层**：选项表在 DOM 中有常驻隐藏副本，必须 `.filter({ visible: true })` 锁定展开的那个（见 Step 3b）。
+- **列索引（td nth）**：行结构 = 前导列（勾选列 + 图标列，通常 2 个）+ `grid.columns` 业务列 + 操作列。写 snippet 前查 `elementmap.json` 里 grid 条目的 `columns` 数组做字段→列号映射：`nth = columns.indexOf(字段名) + 前导列数`，并对一行已知值实测验证（本模块实测：nth(3)=场所名称、nth(4)=场所分类、nth(6)=统一对外服务时间、nth(9)=状态、nth(10)=版本号）。不要凭肉眼从 snapshot 数格子。
+- **行内操作按钮**：`#datagrid tr[.//div[text()='<唯一值>']]//i[@data-tooltip='修改'|'查看']`（contract `listEditActionLocatorTemplate` 的 `{{value}}` 替换）。
+- **弹窗按钮**：`xpath=//a[contains(@class,'mini-button')][normalize-space()='保存'|'保存并关闭'|'关闭']` + `.filter({ visible: true })`；确认弹窗按钮 `text=确定`。
+
+## 常用官方命令速查
+
+- Session：`-s=<name>` 前缀 / `list` / `close-all` / `kill-all` / `delete-data`
+- 页面：`open <url>` / `goto <url>` / `close` / `go-back` / `go-forward` / `reload`
+- 观察：`snapshot` / `screenshot` / `console` / `network` / `run-code`
+- 动作：`click / dblclick / hover <ref>` / `fill <ref> <text>` / `type <text>` / `select <ref> <val>` / `check / uncheck <ref>` / `press <key>` / `drag <src> <dst>` / `upload <ref> <file>`
+- 状态：`state-save [file]` / `state-load <file>` / `cookie-*` / `localstorage-*` / `sessionstorage-*`
+- 求值：`eval "<js表达式>"`（仅单行单表达式；CLI 会包成 `() => (参数)`，含顶层 `;` / 多语句 / 函数声明直接报 `Passed function is not well-serializable!`）/ `run-code "page => expr"`（Node 侧函数，参数收到 Playwright `page` 对象；多语句用 `async page => { ... }` 块体，页面内 JS 走 `page.evaluate(() => { ... })`，iframe 走 `page.frames()`）
+- 标签：`tab-list` / `tab-new` / `tab-select` / `tab-close`
+- 对话框：`dialog-accept` / `dialog-dismiss`
+
+如需最新完整命令列表，跑 `playwright-cli --help` 或访问 `https://playwright.dev/agent-cli/introduction`。

package/codex-skill/ep-stage/glue-run-test/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;
+}