pageqa 0.5.1 → 0.7.0

package/dist/index.js

@@ -1,9 +1,11 @@
 #!/usr/bin/env node
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { basename, dirname, extname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { runAgent, runSuite } from "./agent.js";
 import { ensureConfigDir, CONFIG_PATH, loadConfig } from "./config.js";
-import { expandVars, VAR_HELP } from "./vars.js";
+import { buildReplayScript, loadReplayScript, runReplayScript, sourceDriftNotice, writeReplayScript, } from "./replay.js";
+import { captureRunVars, expandVars, VAR_HELP } from "./vars.js";
 import { info, setDebug } from "./log.js";
 function parseArgs(argv) {
     const args = {
@@ -12,6 +14,9 @@ function parseArgs(argv) {
         initConfig: false,
         help: false,
         debug: false,
+        emitScript: false,
+        semantic: false,
+        failFast: false,
     };
     for (let i = 0; i < argv.length; i++) {
         const a = argv[i];
@@ -20,9 +25,15 @@ function parseArgs(argv) {
             case "--help":
                 args.help = true;
                 break;
-            case "--session":
-                args.session = argv[++i];
+            case "--session": {
+                const v = argv[++i];
+                if (v === undefined) {
+                    args.error = "--session 需要一个 session id 参数";
+                    return args;
+                }
+                args.session = v;
                 break;
+            }
             case "--json":
                 args.json = true;
                 break;
@@ -32,19 +43,78 @@ function parseArgs(argv) {
             case "--init-config":
                 args.initConfig = true;
                 break;
-            case "--out":
-                args.out = argv[++i];
+            case "--out": {
+                const v = argv[++i];
+                if (v === undefined) {
+                    args.error = "--out 需要一个文件路径参数";
+                    return args;
+                }
+                args.out = v;
                 break;
+            }
             case "--debug":
                 args.debug = true;
                 break;
+            case "--replay": {
+                const v = argv[++i];
+                if (v === undefined) {
+                    args.error = "--replay 需要一个回放脚本路径";
+                    return args;
+                }
+                args.replay = v;
+                break;
+            }
+            case "--emit-script": {
+                args.emitScript = true;
+                // 路径可选：只有「看起来像路径」的后一个 token 才被当作输出路径消费，
+                // 否则（如 `pageqa --emit-script examples/smoke.md`）留给用例输入位。
+                const next = argv[i + 1];
+                if (next && looksLikeScriptPath(next)) {
+                    args.emitScriptPath = next;
+                    i++;
+                }
+                break;
+            }
+            case "--semantic":
+                args.semantic = true;
+                break;
+            case "--fail-fast":
+                args.failFast = true;
+                break;
             default:
-                if (!a.startsWith("-"))
+                if (!a.startsWith("-")) {
+                    // 只接受一个用例输入。此前是「后者覆盖前者」，`--emit-script ./replay`
+                    // 这类写法一旦没被识别成输出路径，就会静默把用例换成 `./replay` 去跑，
+                    // 看起来像正常启动、实际测的是完全无关的文本。这里改为直接报错。
+                    if (args.input !== undefined) {
+                        args.error =
+                            `多余的位置参数：${a}（只接受一个用例输入` +
+                                `；路径含空格请用引号包裹，输出路径请放在 --emit-script 之后）`;
+                        return args;
+                    }
                     args.input = a;
+                }
         }
     }
     return args;
 }
+/**
+ * 判断 `--emit-script` 后面的 token 是否应被当作输出路径。
+ *
+ * 判据是「像不像一个路径」而不是「是不是 .json 结尾」：用户完全可能想写成
+ * `--emit-script ./replay`（不带扩展名）。因此：
+ * - 以 `-` 开头 → 是下一个选项，不是路径；
+ * - 以 .md/.txt 结尾 → 是用例文件，留给输入位（支持 `--emit-script 用例.md` 的写法）；
+ * - 含空白或中文 → 是内联用例文本，留给输入位；
+ * - 其余（`./replay`、`out.json`、`reports/run1`）→ 当作输出路径。
+ */
+function looksLikeScriptPath(token) {
+    if (token.startsWith("-"))
+        return false;
+    if (/\.(md|txt)$/i.test(token))
+        return false;
+    return /^[A-Za-z0-9_./\\-]+$/.test(token);
+}
 const HELP = `pageqa - 自然语言驱动的页面测试工具（pi-agent-core + browserskill）
 
 用法:
@@ -52,6 +122,7 @@ const HELP = `pageqa - 自然语言驱动的页面测试工具（pi-agent-core +
 
   <input>          自然语言脚本文件(.md/.txt，路径含空格请用引号包裹)，
                    或用引号包裹的内联文本
+                  只接受一个用例输入；多给一个会直接报错
                   脚本中可用『## 场景名』分隔多个测试场景，自动批量运行
                   路径中粘贴带来的不可见字符（Bidi/零宽）会被自动清理；
                   若路径以 .md/.txt 结尾但文件不存在，会直接报错而非当作内联文本
@@ -62,11 +133,30 @@ const HELP = `pageqa - 自然语言驱动的页面测试工具（pi-agent-core +
                   并关掉它对应的浏览器窗口（Agent Window）
   --json           输出 JSON 报告
   --suite          强制按多场景套件运行（即使只有一个场景）
+  --emit-script [path]
+                   运行结束后把本次成功的操作序列固化成回放脚本（Replay Script）
+                  不给 path 时写到源用例同目录 <用例名>.replay.json
+                  （内联文本写 ./pageqa.replay.json）
+                  path 建议写成路径形式（如 ./replay、reports/run1.json），
+                  含空白请用引号包裹；紧跟其后的若是 .md/.txt 或含空白的文本，
+                  会被当作用例输入而不是输出路径
+                  无论 PASS/FAIL 都会生成，便于排查与续写
+  --replay <file>  零模型回放已有的回放脚本（详见下方「回放脚本」）
+  --semantic       回放时断言改用 Jev 语义判断（默认字符串包含）
   --init-config    在用户目录创建/重置配置文件
   --out <file>     将报告写入文件
   --debug          显示调试日志（bsk 命令、快照体积、上下文裁剪、Jev 请求详情）
   -h, --help       显示帮助
 
+回放脚本（零模型重跑同一用例）:
+  pageqa --replay <file.replay.json> [--session <id>] [--json] [--semantic] [--fail-fast]
+                   按脚本逐步驱动浏览器，**不调用任何大模型**，断言默认走字符串包含
+                   --semantic 可改用 Jev 语义判断（需已在配置里启用 Jev）
+                   元素定位用录制时的语义定位符在当次快照里重新解析，
+                   因此页面小幅调整后脚本仍可命中；源用例变更会在 stderr 提示
+                   --fail-fast 任一失败即停止该场景；默认会跑完剩余步骤，
+                   以便一次拿到整条用例的完整健康报告（失败仍会让退出码非零）
+
 进度日志:
   - 运行进度会带时间戳实时输出到 stderr（bsk daemon 启动、session、每一步工具调用、
     续跑与最终结论等），stdout 只输出最终报告，两者互不干扰；长流程可据此判断进行到哪一步。
@@ -124,8 +214,60 @@ function cleanInput(raw) {
 function looksLikeScriptFile(input) {
     return !/[\r\n]/.test(input) && /\.(md|txt)$/i.test(input);
 }
+/**
+ * 默认的回放脚本落盘位置：贴着源用例（同名 + `.replay.json`），便于和用例一起进 git 评审。
+ * 内联文本没有源文件，落到当前工作目录。
+ */
+function defaultScriptPath(rawInput, isFile) {
+    if (!isFile)
+        return "pageqa.replay.json";
+    return join(dirname(rawInput), basename(rawInput, extname(rawInput)) + ".replay.json");
+}
+/**
+ * 回放模式入口：加载脚本、提示源用例漂移，然后零模型逐步执行。
+ * 退出码语义与自然语言模式一致（全部断言通过 0，否则 1），可直接接 CI。
+ */
+async function replayMode(args) {
+    const path = args.replay;
+    let script;
+    try {
+        script = loadReplayScript(path);
+    }
+    catch (err) {
+        process.stderr.write(`${err instanceof Error ? err.message : String(err)}\n`);
+        return 1;
+    }
+    info("[pageqa] ===== 回放启动 =====");
+    const drift = sourceDriftNotice(script);
+    if (drift)
+        info(`[pageqa] 警告：${drift}`);
+    try {
+        const result = await runReplayScript(script, {
+            session: args.session,
+            semantic: args.semantic,
+            debug: args.debug,
+            scriptPath: path,
+            now: new Date(),
+            failFast: args.failFast,
+        });
+        const out = args.json ? result.json : result.text;
+        if (args.out)
+            writeFileSync(args.out, out + "\n");
+        process.stdout.write(out + "\n");
+        return result.report.status === "pass" ? 0 : 1;
+    }
+    catch (err) {
+        process.stderr.write(`回放失败: ${err instanceof Error ? err.stack : String(err)}\n`);
+        return 1;
+    }
+}
 async function main() {
     const args = parseArgs(process.argv.slice(2));
+    if (args.error) {
+        process.stderr.write(`参数错误：${args.error}\n\n`);
+        process.stdout.write(HELP + "\n");
+        return 1;
+    }
     if (args.help) {
         process.stdout.write(HELP + "\n");
         return 0;
@@ -137,6 +279,19 @@ async function main() {
         process.stdout.write(`当前生效配置：${JSON.stringify(loadConfig(), null, 2)}\n`);
         return 0;
     }
+    // ── 回放模式：零模型执行已有脚本（与用例输入互斥）──
+    if (args.replay) {
+        if (args.input) {
+            process.stderr.write("参数错误：--replay 不能与用例输入同时使用\n\n");
+            return 1;
+        }
+        if (args.emitScript) {
+            process.stderr.write("参数错误：--emit-script 用于生成回放脚本，不能与 --replay 同时使用\n\n");
+            return 1;
+        }
+        setDebug(args.debug);
+        return await replayMode(args);
+    }
     if (!args.input) {
         process.stdout.write(HELP + "\n");
         return 1;
@@ -152,23 +307,52 @@ async function main() {
             `  - 若只想跑内联文本，请不要让文本以 .md/.txt 结尾\n`);
         return 1;
     }
-    const input = isFile
-        ? expandVars(readFileSync(rawInput, "utf8"))
-        : expandVars(rawInput);
+    const sourceText = isFile ? readFileSync(rawInput, "utf8") : rawInput;
+    // 展开占位符与「反查占位符」必须共用同一时刻：
+    // 生成回放脚本时才能把模型看到的具体值（202609191146）还原成 ${timestamp}。
+    const now = new Date();
+    const input = expandVars(sourceText, now);
+    const vars = captureRunVars(now);
     const hasScenarios = /^##\s+/m.test(input);
     const suiteMode = hasScenarios || args.suite;
+    const scriptPath = args.emitScript
+        ? (args.emitScriptPath ?? defaultScriptPath(rawInput, isFile))
+        : undefined;
     info("[pageqa] ===== 启动 =====");
     info(`[pageqa] 已读取${isFile ? `脚本文件 ${rawInput}` : "内联用例"}（${input.length} 字符）`);
     info(`[pageqa] 运行模式：${suiteMode ? "多场景套件" : "单场景"}` +
         `${args.session ? `，session=${args.session}` : ""}` +
         `${args.debug ? "，debug=on（stderr 含调试明细）" : ""}`);
+    if (scriptPath) {
+        info(`[pageqa] 运行结束将生成回放脚本：${scriptPath}`);
+    }
     try {
         const result = suiteMode
-            ? await runSuite(input, { session: args.session, debug: args.debug })
-            : await runAgent(input, { session: args.session, debug: args.debug });
+            ? await runSuite(input, {
+                session: args.session,
+                debug: args.debug,
+                vars,
+                scriptPath,
+            })
+            : await runAgent(input, {
+                session: args.session,
+                debug: args.debug,
+                vars,
+                scriptPath,
+            });
+        if (scriptPath) {
+            const script = buildReplayScript(result.recordings, {
+                sourcePath: isFile ? rawInput : null,
+                sourceText,
+            });
+            writeReplayScript(scriptPath, script);
+            const steps = script.scenarios.reduce((n, s) => n + s.steps.length, 0);
+            info(`[pageqa] 回放脚本已生成：${scriptPath}` +
+                `（${script.scenarios.length} 个场景，共 ${steps} 步）`);
+            info(`[pageqa] 下次可零模型回放：pageqa --replay ${scriptPath}`);
+        }
         const out = args.json ? result.json : result.text;
         if (args.out) {
-            const { writeFileSync } = await import("node:fs");
             writeFileSync(args.out, out + "\n");
         }
         process.stdout.write(out + "\n");
@@ -185,4 +369,15 @@ main()
     process.stderr.write(`执行失败: ${err instanceof Error ? err.stack : String(err)}\n`);
     process.exit(1);
 });
+// 兜底：main() 的 catch 只能捕获其 Promise 链内的错误。
+// 工具执行、事件订阅回调等异步路径上抛出的异常不会被它捕获，
+// 若不处理会直接静默崩溃（进程退出码非 0 但无任何报错信息）。
+process.on("uncaughtException", (err) => {
+    process.stderr.write(`执行失败（未捕获异常）: ${err instanceof Error ? err.stack : String(err)}\n`);
+    process.exit(1);
+});
+process.on("unhandledRejection", (reason) => {
+    process.stderr.write(`执行失败（未处理的 Promise rejection）: ${reason instanceof Error ? reason.stack : String(reason)}\n`);
+    process.exit(1);
+});
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/llm.js

@@ -13,6 +13,27 @@ const MODELS = [
     { id: "hy3", name: "Hy3", contextWindow: 192000, maxOutput: 64000 },
     { id: "deepseek-v4.1-flash", name: "Deepseek-V4.1-Flash", contextWindow: 1_000_000, maxOutput: 128_000 },
 ];
+/** 预设之外的模型使用的保守上下文窗口/输出上限（未知模型按最小预设处理，避免超出端点实际限制）。 */
+const FALLBACK_CONTEXT_WINDOW = 32_000;
+const FALLBACK_MAX_OUTPUT = 64_000;
+/**
+ * 解析实际要注册的模型清单：预设模型沿用精确的 contextWindow/maxOutput；
+ * 用户配置了预设之外的模型时，动态补一条保守条目，使「改配置即用」成立
+ * （README 承诺 baseUrl/apiKey/model 均可配置、无需改代码）。
+ */
+function resolveModels(modelId) {
+    if (MODELS.some((m) => m.id === modelId))
+        return MODELS;
+    return [
+        ...MODELS,
+        {
+            id: modelId,
+            name: modelId,
+            contextWindow: FALLBACK_CONTEXT_WINDOW,
+            maxOutput: FALLBACK_MAX_OUTPUT,
+        },
+    ];
+}
 /** 构造一个静态解析的 ApiKeyAuth（避免交互式 env 探测）。 */
 function staticApiKeyAuth(apiKey, baseUrl) {
     return {
@@ -26,11 +47,12 @@ export function createLlmBackend() {
     const DEFAULT_API_KEY = cfg.apiKey;
     const DEFAULT_MODEL = cfg.model;
     const models = createModels();
+    const registered = resolveModels(DEFAULT_MODEL);
     const provider = createProvider({
         id: PROVIDER_ID,
         name: "OpenAI Compatible (自定义端点)",
         auth: { apiKey: staticApiKeyAuth(DEFAULT_API_KEY, DEFAULT_BASE_URL) },
-        models: MODELS.map((m) => ({
+        models: registered.map((m) => ({
             id: m.id,
             name: m.name,
             api: "openai-completions",

package/dist/llm.js.map

@@ -1 +1 @@
-{"version":3,"file":"llm.js","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAwB,MAAM,uBAAuB,CAAC;AAC3F,OAAO,KAAK,iBAAiB,MAAM,8CAA8C,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;GAKG;AAEH,MAAM,WAAW,GAAG,QAAQ,CAAC;AAS7B,MAAM,MAAM,GAAqB;IAC/B,EAAE,EAAE,EAAE,sBAAsB,EAAE,IAAI,EAAE,sBAAsB,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE;IACpG,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE;IACnE,EAAE,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE,qBAAqB,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;CACzG,CAAC;AAEF,0CAA0C;AAC1C,SAAS,gBAAgB,CAAC,MAAc,EAAE,OAAe;IACvD,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;KACvE,CAAC;AACJ,CAAC;AAOD,MAAM,UAAU,gBAAgB;IAC9B,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,MAAM,gBAAgB,GAAG,GAAG,CAAC,OAAO,CAAC;IACrC,MAAM,eAAe,GAAG,GAAG,CAAC,MAAM,CAAC;IACnC,MAAM,aAAa,GAAG,GAAG,CAAC,KAAK,CAAC;IAChC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,cAAc,CAAC;QAC9B,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,2BAA2B;QACjC,IAAI,EAAE,EAAE,MAAM,EAAE,gBAAgB,CAAC,eAAe,EAAE,gBAAgB,CAAC,EAAE;QACrE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzB,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,GAAG,EAAE,oBAAoB;YACzB,QAAQ,EAAE,WAAW;YACrB,OAAO,EAAE,gBAAgB;YACzB,KAAK,EAAE,CAAC,MAAM,CAAC;YACf,SAAS,EAAE,KAAK;YAChB,aAAa,EAAE,CAAC,CAAC,aAAa;YAC9B,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE;YAC1D,MAAM,EAAE;gBACN,aAAa,EAAE,KAAK;gBACpB,qBAAqB,EAAE,KAAK;gBAC5B,uBAAuB,EAAE,KAAK;gBAC9B,cAAc,EAAE,YAAY;gBAC5B,0BAA0B,EAAE,KAAK;aAClC;SACF,CAAC,CAAC;QACH,GAAG,EAAE,iBAAiB;KACvB,CAAC,CAAC;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAE7B,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAC1D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,SAAS,aAAa,aAAa,WAAW,oDAAoD,CACnG,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"llm.js","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":"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"}

package/dist/locator.d.ts

@@ -0,0 +1,91 @@
+/**
+ * 元素定位符（Locator）：把「这次点的是哪个元素」表达成跨快照可复用的语义描述。
+ *
+ * 背景：bsk 的 `@eN` 引用只在**产生它的那次快照**内有效，下一次 snapshot 编号会重排，
+ * 因此回放脚本不能直接存 `@eN`。bsk 快照文本是一棵缩进的 aria 树，每个可交互节点形如：
+ *
+ *     @e1 link "Learn more" [→ iana.org]
+ *
+ * 其中的「角色 + 可访问名」（role + name）才是稳定的语义信息：页面微调后仍能重新命中。
+ * 本模块负责在**录制时**把 target 解析成定位符，并在**回放时**用新的快照把它解析回 `@eN`。
+ *
+ * 定位符不保证唯一：同名元素可能有多个（列表每行都有「操作」按钮、页面级与区域级各有一个
+ * 「操作」下拉）。因此还记录两样东西：
+ * - `nth`：录制时在所有同名候选中排第几；
+ * - `path`：录制时该节点的**祖先路径**（只保留有名字的祖先）。
+ * 回放时优先用祖先路径消歧——「同名第几个」在页面里同类元素数量变化后会指错，
+ * 而「在哪个区域下」是更强、更抗漂移的信号。
+ */
+/** bsk 快照中带有 `@eN` 引用的一行。 */
+export interface SnapshotRef {
+    /** 引用本身，形如 `@e1`。 */
+    ref: string;
+    /** 角色（link / button / textbox …），取不到时为空串。 */
+    role: string;
+    /** 可访问名（按钮文案、链接文字等），取不到时为空串。 */
+    name: string;
+    /** 祖先路径（从浅到深，只保留有名字的祖先），如 `tabpanel "结构"`。 */
+    path: string[];
+}
+/**
+ * 元素定位符：语义定位（role + name + 祖先路径 + 同名序号）+ 录制时的原始 target 作为兜底。
+ */
+export interface Locator {
+    role: string;
+    name: string;
+    /** 在所有 role+name 相同的候选中排第几（0 起）；无法判定时为 -1。 */
+    nth: number;
+    /** 录制时的原始 target（`@eN` 或 CSS 选择器）。 */
+    target: string;
+    /** 录制时的祖先路径，用于同名元素消歧。 */
+    path: string[];
+}
+/** 是否为 bsk 快照引用（`@e1` 或 `e1`）。回放时引用必须重新解析，CSS 选择器则可直接用。 */
+export declare function isRef(target: string): boolean;
+/** 归一化引用写法：`e1` -> `@e1`。 */
+export declare function normalizeRef(target: string): string;
+/**
+ * 解析 bsk 快照文本里所有带引用的行，得到「引用 -> 角色/可访问名/祖先路径」。
+ *
+ * 缩进即层级：维护一个缩进栈，遇到更浅或同级的新行就弹出更深/同级的节点，
+ * 因此每个引用都能拿到「它在哪个区域（tabpanel / dialog / 某个标题）之下」。
+ * `@vom` / `@view` / `@layers` / `L1 page` 等元信息行不参与树。
+ */
+export declare function parseSnapshotRefs(snapshotText: string): SnapshotRef[];
+/**
+ * 录制时构造定位符：从当时的快照里查出该引用对应的角色/可访问名、同名序号与祖先路径。
+ *
+ * target 是 CSS 选择器（或快照里查不到的引用）时，定位符退化为「只有 target 兜底」，
+ * 回放时直接按原 target 操作。
+ */
+export declare function buildLocator(target: string, snapshotText: string): Locator;
+/**
+ * 回放时用**新的**快照把定位符解析回 `@eN`。
+ *
+ * 匹配策略逐级放宽，都不中则返回 null（由调用方决定退回 target 还是报错）：
+ *   1. role + name 全等（最常见，页面没变时必然命中）
+ *   2. role 相同且 name 包含（文案被加了前后缀，如「操作」→「操作 更多」）
+ *   3. 只看 name（角色被前端改过，如 button 变 a）
+ *
+ * 命中多个候选时，先按**祖先路径**消歧（「结构」tab 下的「操作」与产品级的「操作」
+ * 名字完全一样，只有所属区域能区分），路径也无法区分时才退回录制的同名序号 `nth`。
+ */
+export declare function resolveLocator(locator: Locator, snapshotText: string): string | null;
+/** 定位失败时给出的线索类型。 */
+export interface LocatorHint {
+    /** similar-name：有名字相近的同角色元素；role-only：有该角色元素但名字都不同；no-role：该角色元素一个都没有。 */
+    kind: "similar-name" | "role-only" | "no-role";
+    /** 可读的候选元素（最多若干个）。 */
+    items: string[];
+    /** 页面上该角色的元素总数。 */
+    roleCount: number;
+}
+/**
+ * 定位不到时给出「当前页面里有什么」的线索。
+ *
+ * 「元素未找到」本身是条死路，用户只知道某步挂了。区分三种情况后，报告能直接回答
+ * 「是弹窗没打开」「是菜单点错了一个」还是「元素改名了」，用户据此就能判断该改脚本还是改用例。
+ */
+export declare function locatorHint(locator: Locator, snapshotText: string, limit?: number): LocatorHint;
+/** 定位符的可读描述，用于报告与日志（说明「当时点的是什么、在哪个区域」）。 */
+export declare function describeLocator(locator: Locator | null): string;