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

package/dist/src/testcase/button-interaction-inference.js

@@ -0,0 +1,385 @@
+/**
+ * 前端按钮交互行为推理器。
+ *
+ * 职责：
+ * 1. 从 code_list.json5 的 sourceRoot + pages.list.path 定位列表页 HTML；
+ * 2. 解析 HTML 中自定义按钮的 onclick 属性及同页内联脚本中的函数体；
+ * 3. 判断交互模式（确认弹窗 / toast / 异步调用 / 打开弹窗 / 通用）；
+ * 4. 为每个 custom 按钮生成精确的中文步骤与断言；
+ * 5. 当 HTML 不可读、解析失败或模式未知时，回退到通用描述并记录原因。
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import * as cheerio from 'cheerio';
+/**
+ * 归一化文本：去空白、去首尾空格。
+ */
+function normalizeText(value) {
+    return (value ?? '').replace(/\s+/g, ' ').trim();
+}
+/**
+ * 从内联脚本内容中提取指定函数体。
+ *
+ * @param scriptContent - 页面内所有 inline script 拼接文本。
+ * @param functionName - 函数名。
+ * @returns 函数体或 undefined。
+ */
+function extractFunctionBody(scriptContent, functionName) {
+    const pattern = new RegExp(`function\\s+${functionName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\s*\\([^)]*\\)\\s*\\{`, 'g');
+    const match = pattern.exec(scriptContent);
+    if (!match)
+        return undefined;
+    const start = match.index + match[0].length;
+    let depth = 1;
+    let index = start;
+    while (index < scriptContent.length && depth > 0) {
+        const char = scriptContent[index];
+        if (char === '{')
+            depth += 1;
+        else if (char === '}')
+            depth -= 1;
+        index += 1;
+    }
+    return scriptContent.slice(start, index - 1);
+}
+/**
+ * 从合并后的 JS 文本中识别交互模式。
+ *
+ * 优先级：
+ * 1. epoint.confirm -> confirm_then_execute
+ * 2. epoint.openTopDialog / epoint.openDialog -> open_dialog
+ * 3. epoint.execute / epoint.ajax / $.ajax / .ajax( / XMLHttpRequest / fetch( -> async_call
+ * 4. epoint.message / epoint.showTips / epoint.alert -> toast
+ * 5. 其他 -> generic
+ */
+function detectPattern(combinedJs) {
+    const normalized = combinedJs.replace(/\s+/g, ' ');
+    if (/epoint\.confirm\s*\(/.test(normalized))
+        return 'confirm_then_execute';
+    if (/epoint\.(?:openTopDialog|openDialog)\s*\(/.test(normalized))
+        return 'open_dialog';
+    if (/epoint\.(?:execute|ajax)\s*\(/.test(normalized) ||
+        /\$\.ajax\s*\(/.test(normalized) ||
+        /[^a-zA-Z0-9_$]ajax\s*\(/.test(normalized) ||
+        /XMLHttpRequest/.test(normalized) ||
+        /[^a-zA-Z0-9_$]fetch\s*\(/.test(normalized)) {
+        return 'async_call';
+    }
+    if (/epoint\.(?:message|showTips|alert)\s*\(/.test(normalized))
+        return 'toast';
+    return 'generic';
+}
+/**
+ * 尝试提取 epoint.confirm 的第一个参数（提示文案）。
+ *
+ * @param combinedJs - 合并后的 JS 文本。
+ * @returns 提取到的文案或 undefined。
+ */
+function extractConfirmMessage(combinedJs) {
+    const match = combinedJs.match(/epoint\.confirm\s*\(\s*["']([^"']+)["']/);
+    return match?.[1];
+}
+/**
+ * 根据交互模式渲染中文步骤和断言。
+ */
+function renderStepsAndAssertion(label, pattern, confirmMessage) {
+    if (pattern === 'confirm_then_execute') {
+        const confirmStep = confirmMessage
+            ? `2. 页面弹出确认弹窗，文案包含「${confirmMessage}」。`
+            : '2. 页面弹出确认弹窗。';
+        return {
+            steps: [
+                `1. 在列表页定位并点击「${label}」按钮。`,
+                confirmStep,
+                `3. 在确认弹窗中点击「确定」。`,
+                `4. 等待后端请求完成。`,
+                `5. 观察并记录最终反馈（提示信息、弹窗或列表刷新）。`,
+            ].join(' '),
+            assertion: `点击「${label}」并确认后，系统应调用对应接口并给出可见成功反馈；若接口返回错误，应展示错误提示。`,
+        };
+    }
+    if (pattern === 'toast') {
+        return {
+            steps: [
+                `1. 在列表页定位并点击「${label}」按钮。`,
+                `2. 观察页面是否出现 toast / 提示信息。`,
+                `3. 记录提示文案与页面状态变化。`,
+            ].join(' '),
+            assertion: `点击「${label}」按钮后，页面应展示可见的提示信息。`,
+        };
+    }
+    if (pattern === 'async_call') {
+        return {
+            steps: [
+                `1. 在列表页定位并点击「${label}」按钮。`,
+                `2. 等待异步请求完成。`,
+                `3. 观察并记录页面反馈（提示信息、列表刷新等）。`,
+            ].join(' '),
+            assertion: `点击「${label}」按钮后，系统应发起异步请求并给出成功或错误反馈。`,
+        };
+    }
+    if (pattern === 'open_dialog') {
+        return {
+            steps: [
+                `1. 在列表页定位并点击「${label}」按钮。`,
+                `2. 等待弹窗或新页面打开。`,
+                `3. 确认弹窗/页面标题与内容符合预期。`,
+            ].join(' '),
+            assertion: `点击「${label}」按钮后，应打开对应的弹窗或页面。`,
+        };
+    }
+    return {
+        steps: [
+            `1. 在列表页定位并点击「${label}」按钮。`,
+            `2. 观察并记录页面反馈（如弹窗、提示信息、列表刷新等）。`,
+            `3. 确认页面状态与按钮功能预期一致。`,
+        ].join(' '),
+        assertion: `点击「${label}」按钮后，页面应出现与该功能对应的可见响应（如提示信息、弹窗确认或数据刷新）。`,
+    };
+}
+/**
+ * 从 code_list.pages[list].buttons 中提取 action='custom' 的按钮。
+ */
+function collectCustomButtons(codeList) {
+    const listPage = codeList.pages.find((p) => p.role === 'list');
+    if (!listPage)
+        return [];
+    return (listPage.buttons ?? []).reduce((acc, raw) => {
+        const anyB = raw;
+        if (anyB.action === 'custom' && anyB.label) {
+            acc.push({
+                label: anyB.label,
+                customAction: anyB.customAction ?? anyB.label,
+                backendMethod: anyB.backendMethod,
+            });
+        }
+        return acc;
+    }, []);
+}
+/**
+ * 解析 HTML 中 .mini-button 按钮，按 label 建立映射。
+ */
+function buildHtmlButtonMap(html) {
+    const $ = cheerio.load(html);
+    const map = new Map();
+    $('.mini-button').each((_, element) => {
+        const button = $(element);
+        const label = normalizeText(button.text());
+        if (!label)
+            return;
+        map.set(label, {
+            label,
+            onclick: button.attr('onclick') ?? undefined,
+        });
+    });
+    return map;
+}
+/**
+ * 收集页面中所有 inline script 内容。
+ */
+function collectInlineScripts(html) {
+    const $ = cheerio.load(html);
+    return $('script')
+        .toArray()
+        .map((element) => $(element).html() ?? '')
+        .join('\n');
+}
+/**
+ * 收集页面中外部 script src 的内容。
+ *
+ * @param html - HTML 文本。
+ * @param htmlDir - HTML 文件所在目录，用于解析相对 src。
+ * @returns 所有可读外部脚本内容拼接。
+ */
+function collectExternalScripts(html, htmlDir) {
+    const $ = cheerio.load(html);
+    const contents = [];
+    $('script[src]').each((_, element) => {
+        const src = $(element).attr('src');
+        if (!src)
+            return;
+        // 忽略远程脚本和 data URI。
+        if (/^(https?:|data:|\/\/)/i.test(src))
+            return;
+        const scriptPath = path.resolve(htmlDir, src);
+        if (!existsSync(scriptPath))
+            return;
+        try {
+            contents.push(readFileSync(scriptPath, 'utf8'));
+        }
+        catch {
+            // 忽略无法读取的外部脚本。
+        }
+    });
+    return contents.join('\n');
+}
+/**
+ * 从 onclick 值中提取可能调用的函数名。
+ *
+ * 兼容形式：
+ * - `openAdd()`
+ * - `syncWindowSystem`
+ * - `epoint.confirm('...', cb)`（返回 epoint，会被过滤）
+ *
+ * @param onclick - onclick 属性值。
+ * @returns 函数名或 undefined。
+ */
+function extractFunctionNameFromOnclick(onclick) {
+    const trimmed = onclick.trim();
+    // 1. 优先匹配 functionName(...)
+    const callMatch = trimmed.match(/^([A-Za-z_$][A-Za-z0-9_$]*)\s*\(/);
+    if (callMatch)
+        return callMatch[1];
+    // 2. 兼容裸函数名赋值，如 onclick="syncWindowSystem"
+    const bareMatch = trimmed.match(/^([A-Za-z_$][A-Za-z0-9_$]*)$/);
+    if (bareMatch)
+        return bareMatch[1];
+    return undefined;
+}
+/**
+ * 选择并返回可用的源码根目录。
+ *
+ * 优先级：options.sourceRootOverride -> process.env.EP_STAGE_SOURCE_ROOT -> codeList.sourceRoot.root
+ */
+function resolveSourceRoot(codeList, options) {
+    const candidates = [
+        options?.sourceRootOverride,
+        process.env.EP_STAGE_SOURCE_ROOT,
+        codeList.sourceRoot?.root,
+    ].filter((item) => Boolean(item));
+    return candidates[0];
+}
+/**
+ * 推理所有 custom 按钮的交互行为。
+ *
+ * @param codeList - 解析后的 code_list.json5。
+ * @param options - 可选覆盖。
+ * @returns label -> 推理结果 的映射。
+ */
+export function inferButtonInteractions(codeList, options) {
+    const customButtons = collectCustomButtons(codeList);
+    const result = new Map();
+    if (customButtons.length === 0)
+        return result;
+    const listPage = codeList.pages.find((p) => p.role === 'list');
+    const listPath = listPage?.path;
+    const sourceRoot = resolveSourceRoot(codeList, options);
+    if (!listPath || !sourceRoot) {
+        const reason = !listPath
+            ? 'code_list.json5 缺少 pages[role=list].path'
+            : '未提供可用的源码根目录（sourceRoot.root / EP_STAGE_SOURCE_ROOT / --source-root）';
+        for (const btn of customButtons) {
+            const generic = renderStepsAndAssertion(btn.label, 'generic');
+            result.set(btn.label, {
+                label: btn.label,
+                pattern: 'generic',
+                steps: generic.steps,
+                assertion: generic.assertion,
+                evidence: [],
+                fallbackReason: reason,
+            });
+        }
+        return result;
+    }
+    const htmlPath = path.resolve(sourceRoot, listPath);
+    if (!existsSync(htmlPath)) {
+        const reason = `列表页 HTML 不存在: ${htmlPath}`;
+        for (const btn of customButtons) {
+            const generic = renderStepsAndAssertion(btn.label, 'generic');
+            result.set(btn.label, {
+                label: btn.label,
+                pattern: 'generic',
+                steps: generic.steps,
+                assertion: generic.assertion,
+                evidence: [],
+                fallbackReason: reason,
+            });
+        }
+        return result;
+    }
+    let html;
+    try {
+        html = readFileSync(htmlPath, 'utf8');
+    }
+    catch (err) {
+        const reason = `读取列表页 HTML 失败: ${err instanceof Error ? err.message : String(err)}`;
+        for (const btn of customButtons) {
+            const generic = renderStepsAndAssertion(btn.label, 'generic');
+            result.set(btn.label, {
+                label: btn.label,
+                pattern: 'generic',
+                steps: generic.steps,
+                assertion: generic.assertion,
+                evidence: [],
+                fallbackReason: reason,
+            });
+        }
+        return result;
+    }
+    let htmlButtonMap;
+    let scriptContent;
+    try {
+        htmlButtonMap = buildHtmlButtonMap(html);
+        const inlineScripts = collectInlineScripts(html);
+        const externalScripts = collectExternalScripts(html, path.dirname(htmlPath));
+        scriptContent = `${inlineScripts}\n${externalScripts}`;
+    }
+    catch (err) {
+        const reason = `解析 HTML 失败: ${err instanceof Error ? err.message : String(err)}`;
+        for (const btn of customButtons) {
+            const generic = renderStepsAndAssertion(btn.label, 'generic');
+            result.set(btn.label, {
+                label: btn.label,
+                pattern: 'generic',
+                steps: generic.steps,
+                assertion: generic.assertion,
+                evidence: [],
+                fallbackReason: reason,
+            });
+        }
+        return result;
+    }
+    for (const btn of customButtons) {
+        const htmlBtn = htmlButtonMap.get(btn.label);
+        if (!htmlBtn || !htmlBtn.onclick) {
+            const generic = renderStepsAndAssertion(btn.label, 'generic');
+            result.set(btn.label, {
+                label: btn.label,
+                pattern: 'generic',
+                steps: generic.steps,
+                assertion: generic.assertion,
+                evidence: [],
+                fallbackReason: !htmlBtn
+                    ? `HTML 中未找到 label 为「${btn.label}」的按钮`
+                    : `HTML 中按钮「${btn.label}」缺少 onclick 属性`,
+            });
+            continue;
+        }
+        const onclick = htmlBtn.onclick;
+        const functionName = extractFunctionNameFromOnclick(onclick);
+        let functionBody = '';
+        if (functionName && functionName !== 'epoint') {
+            functionBody = extractFunctionBody(scriptContent, functionName) ?? '';
+        }
+        const combinedJs = `${onclick}\n${functionBody}`;
+        const pattern = detectPattern(combinedJs);
+        const confirmMessage = pattern === 'confirm_then_execute' ? extractConfirmMessage(combinedJs) : undefined;
+        const rendered = renderStepsAndAssertion(btn.label, pattern, confirmMessage);
+        const evidence = [onclick];
+        if (functionName)
+            evidence.push(`functionName=${functionName}`);
+        if (functionBody)
+            evidence.push(functionBody.slice(0, 500));
+        if (confirmMessage)
+            evidence.push(`confirmMessage=${confirmMessage}`);
+        result.set(btn.label, {
+            label: btn.label,
+            pattern,
+            functionName,
+            steps: rendered.steps,
+            assertion: rendered.assertion,
+            evidence,
+        });
+    }
+    return result;
+}

package/dist/src/testcase/contract-testcase-assembler.d.ts

@@ -0,0 +1,44 @@
+/**
+ * JSON5 新协议产线的 contract + testcase 装配器（Task 3）。
+ *
+ * 职责：
+ * 把 {@link ExtractedCodeListJson5}（code_list.json5 解析产出）装配成
+ * - {@link EpStageContractV1Draft}：含 scenario.skeletonSlots.crud（形态对齐
+ *   generators/stage-skeleton-script.ts 的 StageSkeletonCrudFlowSlots）
+ * - {@link EpStageTestcaseV1Draft}：10 条 glue cases + uncoveredCandidates
+ *
+ * 填充策略（brief + 交接文档 §4.2）：
+ * - queryFields：input/listbox 二分；input 取 entities 中 dataKey 字段作 seed 来源
+ *   （placename 为 dataKey），listbox 取第一项作 value
+ * - frames：code_list 不提供 iframe keyword → 用模块名相关 keyword 占位（014 为 directUrl 模式），
+ *   默认策略，不进 unresolvedSlots，在 inference-trace 记账
+ * - locators：用 014 草案已确认的框架默认（MiniUI 默认规则 + text=确定 等），不进 unresolvedSlots
+ * - assertions.deletePolicy='success_delete'（MiniUI 默认删除成功策略）
+ */
+import type { ExtractedCodeListJson5 } from '../extractors/code-list-json5.js';
+import type { EpStageContractV1Draft } from '../contracts/glue-contract-v1.js';
+import type { EpStageTestcaseV1Draft } from './testcase-v1-draft.js';
+/** assembler 输入。 */
+export type AssembleInput = {
+    /** code_list.json5 解析后的强类型产出。 */
+    codeList: ExtractedCodeListJson5;
+    /** 待测列表页直达地址，由 skill 交互或运行配置显式传入。 */
+    directUrl?: string;
+    /** 源码根目录覆盖（可选），用于解析 pages.list.path。 */
+    sourceRoot?: string;
+};
+/** assembler 输出：契约 + 用例 + 推理过程账本（后两者供 generate-testcase 落盘）。 */
+export type AssembleResult = {
+    contract: EpStageContractV1Draft;
+    testcase: EpStageTestcaseV1Draft;
+    /** inference-trace 的 reasoningSummary + skeletonSlots 默认策略来源账本。 */
+    inferenceTrace: Record<string, unknown>;
+};
+/**
+ * 装配 contract + testcase + inference-trace 账本。
+ *
+ * @param input - 含 code_list 解析产出的输入。
+ * @returns contract / testcase / inferenceTrace。
+ */
+export declare function assembleJson5ContractAndTestcase(input: AssembleInput): AssembleResult;
+//# sourceMappingURL=contract-testcase-assembler.d.ts.map

package/dist/src/testcase/contract-testcase-assembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-testcase-assembler.d.ts","sourceRoot":"","sources":["../../../src/testcase/contract-testcase-assembler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAA2E,MAAM,kCAAkC,CAAC;AACxJ,OAAO,KAAK,EAAE,sBAAsB,EAAqB,MAAM,kCAAkC,CAAC;AAElG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AASrE,oBAAoB;AACpB,MAAM,MAAM,aAAa,GAAG;IAC1B,iCAAiC;IACjC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,gEAAgE;AAChE,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,sBAAsB,CAAC;IACjC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,mEAAmE;IACnE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC,CAAC;AAyyBF;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CAiKrF"}