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

package/dist/src/extractors/code-list-json5.js

@@ -0,0 +1,91 @@
+/**
+ * code_list.json5 输入读取器
+ *
+ * 职责：
+ * 1. assertCodeListJson5Path — 路径硬校验，拒绝非 .json5 文件（含 .md）
+ * 2. extractCodeListJson5 — 读取并解析 JSON5 文件，校验必填字段，返回强类型产出
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import JSON5 from 'json5';
+import { normalizeTestAccessConfig, } from '../testcase/test-access.js';
+/* ──────── 路径硬校验 ──────── */
+/**
+ * 校验 filePath 是否为合法的 code_list.json5 路径。
+ * 拒绝非 .json5 后缀的文件（包括 .md）。
+ *
+ * @param filePath - 待校验的文件路径
+ * @throws Error 当文件后缀不是 .json5 时抛出中文错误
+ */
+export function assertCodeListJson5Path(filePath) {
+    if (!filePath.endsWith('.json5')) {
+        throw new Error('glue-generate-testcase 只接受 _docs/code_list.json5');
+    }
+}
+/* ──────── JSON5 读取与解析 ──────── */
+/**
+ * 读取并解析 code_list.json5 文件，返回强类型产出。
+ * 校验必填字段 module / moduleName / systems / pages，缺失时抛出中文错误。
+ *
+ * @param filePath - code_list.json5 文件的绝对路径
+ * @returns 解析后的强类型数据
+ * @throws Error 路径非法 / 文件不存在 / 必填字段缺失
+ */
+export function extractCodeListJson5Object(raw) {
+    if (!raw || typeof raw !== 'object') {
+        throw new Error('code_list.json5 顶层必须为对象');
+    }
+    const data = raw;
+    // 必填字段校验
+    if (!data.module) {
+        throw new Error('code_list.json5 缺少必填字段: module');
+    }
+    if (!data.moduleName) {
+        throw new Error('code_list.json5 缺少必填字段: moduleName');
+    }
+    if (!Array.isArray(data.systems)) {
+        throw new Error('code_list.json5 缺少必填字段: systems');
+    }
+    if (!Array.isArray(data.pages)) {
+        throw new Error('code_list.json5 缺少必填字段: pages');
+    }
+    return {
+        module: data.module,
+        moduleName: data.moduleName,
+        description: data.description,
+        requirement: data.requirement,
+        sourceRoot: data.sourceRoot,
+        systems: data.systems,
+        roles: (data.roles ?? []),
+        pages: data.pages,
+        dataModels: data.dataModels,
+        entities: data.entities,
+        businessRules: data.businessRules,
+        testAccess: data.testAccess === undefined
+            ? undefined
+            : normalizeTestAccessConfig(data.testAccess, 'code_list.json5.testAccess'),
+    };
+}
+/**
+ * 读取并解析 code_list.json5 文件，返回强类型产出。
+ * 校验必填字段 module / moduleName / systems / pages，缺失时抛出中文错误。
+ *
+ * @param filePath - code_list.json5 文件的绝对路径
+ * @returns 解析后的强类型数据
+ * @throws Error 路径非法 / 文件不存在 / 必填字段缺失
+ */
+export function extractCodeListJson5(filePath) {
+    assertCodeListJson5Path(filePath);
+    const absPath = path.resolve(filePath);
+    if (!existsSync(absPath)) {
+        throw new Error(`code_list.json5 文件不存在: ${absPath}`);
+    }
+    const raw = readFileSync(absPath, 'utf-8');
+    const parsed = JSON5.parse(raw);
+    const extracted = extractCodeListJson5Object(parsed);
+    return {
+        path: absPath,
+        requirementDir: path.dirname(absPath),
+        ...extracted,
+    };
+}

package/dist/src/extractors/html-page.d.ts

@@ -23,6 +23,8 @@ export type ExtractedHtmlGridColumn = {
     field: string;
     headerText: string;
     columnType: string;
+    editorType?: string;
+    editorAction?: string;
 };
 export type ExtractedHtmlRowAction = {
     label: string;
@@ -36,6 +38,13 @@ export type ExtractedHtmlGrid = {
     selectionColumn?: ExtractedHtmlGridColumn;
     indexColumn?: ExtractedHtmlGridColumn;
     rowActions: ExtractedHtmlRowAction[];
+    /** MiniUI cell-edit 信号 */
+    allowCellEdit?: boolean;
+    cellEditAction?: string;
+    allowCellSelect?: boolean;
+    editNextOnEnterKey?: boolean;
+    oncellbeginedit?: boolean;
+    onrowdblclick?: boolean;
 };
 export type ExtractedPageStructureSignal = {
     staticPresent: boolean;

package/dist/src/extractors/html-page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html-page.d.ts","sourceRoot":"","sources":["../../../src/extractors/html-page.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,uBAAuB,EAAE,CAAC;IACnC,WAAW,EAAE,uBAAuB,EAAE,CAAC;IACvC,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAC1C,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACtC,UAAU,EAAE,sBAAsB,EAAE,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,QAAQ,EAAE,4BAA4B,CAAC;IACvC,eAAe,EAAE,4BAA4B,CAAC;IAC9C,KAAK,EAAE,4BAA4B,CAAC;IACpC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,eAAe,EAAE,OAAO,CAAC;IACzB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,oBAAoB,EAAE,6BAA6B,CAAC;CACrD,CAAC;AAgFF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CA0InE"}
+{"version":3,"file":"html-page.d.ts","sourceRoot":"","sources":["../../../src/extractors/html-page.ts"],"names":[],"mappings":"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"}

package/dist/src/extractors/html-page.js

@@ -38,6 +38,17 @@ function buildButtonLocator(label, tagName) {
     }
     return `xpath=//a[contains(@class,'mini-button')][normalize-space()='${label}'] | //button[contains(@class,'mini-button')][normalize-space()='${label}']`;
 }
+function parseEditorAttribute(editorAttribute) {
+    const normalized = normalizeAttribute(editorAttribute);
+    if (!normalized)
+        return {};
+    const typeMatch = normalized.match(/type\s*:\s*['"]([^'"]+)['"]/i);
+    const actionMatch = normalized.match(/action\s*:\s*['"]([^'"]+)['"]/i);
+    return {
+        type: typeMatch?.[1],
+        action: actionMatch?.[1],
+    };
+}
 function buildFieldLocator(label, controlType) {
     if (controlType === 'mini-textbox') {
         return `//div[@label='${label}']//input[@class='mini-textbox-input']`;
@@ -116,7 +127,14 @@ export function extractHtmlPage(filePath) {
             const field = column.attr('field') ?? '';
             const columnType = column.attr('type') ?? (field ? 'data' : 'unknown');
             const headerText = normalizeText(column.clone().children().remove().end().text());
-            const extractedColumn = { field, headerText, columnType };
+            const editor = parseEditorAttribute(column.attr('editor'));
+            const extractedColumn = {
+                field,
+                headerText,
+                columnType,
+                editorType: editor.type,
+                editorAction: editor.action,
+            };
             if (columnType === 'checkcolumn') {
                 selectionColumn = extractedColumn;
                 return;
@@ -149,7 +167,13 @@ export function extractHtmlPage(filePath) {
             dataColumns,
             selectionColumn,
             indexColumn,
-            rowActions
+            rowActions,
+            allowCellEdit: booleanAttribute(grid.attr('allowCellEdit')) || undefined,
+            cellEditAction: normalizeAttribute(grid.attr('cellEditAction')) || undefined,
+            allowCellSelect: booleanAttribute(grid.attr('allowCellSelect')) || undefined,
+            editNextOnEnterKey: booleanAttribute(grid.attr('editNextOnEnterKey')) || undefined,
+            oncellbeginedit: normalizeAttribute(grid.attr('oncellbeginedit')) ? true : undefined,
+            onrowdblclick: normalizeAttribute(grid.attr('onrowdblclick')) ? true : undefined,
         });
     });
     const scriptContent = $('script')

package/dist/src/extractors/prd-extractor.d.ts

@@ -0,0 +1,70 @@
+/**
+ * PRD markdown 解析器。
+ *
+ * 职责：
+ * 1. 在需求目录中发现 PRD markdown 文件。
+ * 2. 解析 PRD 章节 4.1（功能列表）和 4.2.x（功能详细说明）。
+ * 3. 输出结构化的 PrdFunctionEntry[]，供 testcase 装配阶段确定性使用。
+ *
+ * 设计取舍：
+ * - 全程使用正则/行解析，不调用 LLM，保证幂等性。
+ * - 只识别当前观察到的 PRD 结构（`4.1` 表格 + `4.2.x` 子章节 + 粗体字段标题）。
+ * - 解析失败时返回空数组并在 inferenceTrace 中记录，不阻断 pipeline。
+ */
+/** PRD 中的单个功能条目。 */
+export type PrdFunctionEntry = {
+    /** 功能编号，如 F001。 */
+    featureId: string;
+    /** 功能名称，如「同步窗口管理系统」。 */
+    featureName: string;
+    /** 功能模块，如「大厅地址管理」。 */
+    featureModule?: string;
+    /** 功能描述。 */
+    description: string;
+    /** 输入条件。 */
+    inputConditions?: string;
+    /** 处理逻辑，保留列表顺序。 */
+    processingLogic: string[];
+    /** 输出结果，保留列表顺序。 */
+    outputResult: string[];
+    /** 业务规则，保留列表顺序。 */
+    businessRules: string[];
+    /** 约束条件，保留列表顺序。 */
+    constraints: string[];
+};
+/** PRD 提取产物。 */
+export type PrdExtraction = {
+    /** PRD 文件绝对路径。 */
+    prdPath: string;
+    /** 解析出的功能条目，按 PRD 顺序排列。 */
+    functions: PrdFunctionEntry[];
+    /** 解析时间 ISO 字符串，仅用于审计，不影响 testcase 生成。 */
+    generatedAt: string;
+};
+/**
+ * 在目录中查找 PRD markdown 文件。
+ *
+ * 规则（满足任一即返回）：
+ * 1. 文件名包含 `prd`（大小写不敏感）且以 `.md` 结尾。
+ * 2. 文件正文包含 `## 4. 功能需求` 标题。
+ *
+ * @param dir - 需求文档目录。
+ * @returns PRD 文件绝对路径；不存在时返回 undefined。
+ */
+export declare function findPrdMarkdown(dir: string): string | undefined;
+/**
+ * 读取 PRD 文件并提取功能条目。
+ *
+ * @param prdPath - PRD markdown 文件绝对路径。
+ * @param now - 可选的解析时间戳，用于测试冻结。
+ * @returns PRD 提取产物。
+ */
+export declare function loadPrdExtraction(prdPath: string, now?: string): PrdExtraction;
+/**
+ * 解析 PRD markdown 文本，提取功能列表 + 功能详细说明。
+ *
+ * @param markdown - PRD 完整 markdown 文本。
+ * @returns 按 PRD 顺序排列的功能条目数组。
+ */
+export declare function extractPrdFunctions(markdown: string): PrdFunctionEntry[];
+//# sourceMappingURL=prd-extractor.d.ts.map

package/dist/src/extractors/prd-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prd-extractor.d.ts","sourceRoot":"","sources":["../../../src/extractors/prd-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,oBAAoB;AACpB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,mBAAmB;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY;IACZ,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,mBAAmB;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,mBAAmB;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,mBAAmB;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,gBAAgB;AAChB,MAAM,MAAM,aAAa,GAAG;IAC1B,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAsB/D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,SAA2B,GAAG,aAAa,CAIhG;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAqBxE"}

package/dist/src/extractors/prd-extractor.js

@@ -0,0 +1,248 @@
+/**
+ * PRD markdown 解析器。
+ *
+ * 职责：
+ * 1. 在需求目录中发现 PRD markdown 文件。
+ * 2. 解析 PRD 章节 4.1（功能列表）和 4.2.x（功能详细说明）。
+ * 3. 输出结构化的 PrdFunctionEntry[]，供 testcase 装配阶段确定性使用。
+ *
+ * 设计取舍：
+ * - 全程使用正则/行解析，不调用 LLM，保证幂等性。
+ * - 只识别当前观察到的 PRD 结构（`4.1` 表格 + `4.2.x` 子章节 + 粗体字段标题）。
+ * - 解析失败时返回空数组并在 inferenceTrace 中记录，不阻断 pipeline。
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+/**
+ * 在目录中查找 PRD markdown 文件。
+ *
+ * 规则（满足任一即返回）：
+ * 1. 文件名包含 `prd`（大小写不敏感）且以 `.md` 结尾。
+ * 2. 文件正文包含 `## 4. 功能需求` 标题。
+ *
+ * @param dir - 需求文档目录。
+ * @returns PRD 文件绝对路径；不存在时返回 undefined。
+ */
+export function findPrdMarkdown(dir) {
+    if (!existsSync(dir)) {
+        return undefined;
+    }
+    const candidates = readdirSync(dir).filter((file) => file.endsWith('.md'));
+    for (const file of candidates) {
+        const fullPath = path.join(dir, file);
+        if (/prd/i.test(file)) {
+            return fullPath;
+        }
+    }
+    for (const file of candidates) {
+        const fullPath = path.join(dir, file);
+        const content = readFileSync(fullPath, 'utf8');
+        if (/##\s*4\.\s*功能需求/.test(content)) {
+            return fullPath;
+        }
+    }
+    return undefined;
+}
+/**
+ * 读取 PRD 文件并提取功能条目。
+ *
+ * @param prdPath - PRD markdown 文件绝对路径。
+ * @param now - 可选的解析时间戳，用于测试冻结。
+ * @returns PRD 提取产物。
+ */
+export function loadPrdExtraction(prdPath, now = new Date().toISOString()) {
+    const markdown = readFileSync(prdPath, 'utf8');
+    const functions = extractPrdFunctions(markdown);
+    return { prdPath, functions, generatedAt: now };
+}
+/**
+ * 解析 PRD markdown 文本，提取功能列表 + 功能详细说明。
+ *
+ * @param markdown - PRD 完整 markdown 文本。
+ * @returns 按 PRD 顺序排列的功能条目数组。
+ */
+export function extractPrdFunctions(markdown) {
+    const functionList = parseFunctionList(markdown);
+    const details = parseFunctionDetails(markdown);
+    const detailMap = new Map(details.map((d) => [d.featureId, d]));
+    // 以功能列表为基准顺序，合并详细说明；若详细说明缺失则使用列表中的描述兜底。
+    return functionList.map((listItem) => {
+        const detail = detailMap.get(listItem.featureId);
+        return {
+            featureId: listItem.featureId,
+            featureName: listItem.featureName,
+            featureModule: listItem.featureModule,
+            description: detail?.description ?? listItem.description,
+            inputConditions: detail?.inputConditions,
+            processingLogic: detail?.processingLogic ?? [],
+            outputResult: detail?.outputResult ?? [],
+            businessRules: detail?.businessRules ?? [],
+            constraints: detail?.constraints ?? [],
+        };
+    });
+}
+/**
+ * 解析 4.1 功能列表表格。
+ *
+ * 表格列（按当前 PRD 约定）：
+ * | 功能模块 | 功能编号 | 功能名称 | 功能描述 | 功能类型 | ... |
+ */
+function parseFunctionList(markdown) {
+    const result = [];
+    const sectionMatch = markdown.match(/###\s*4\.1\s*功能列表[\s\S]*?(?=###\s*4\.2|##\s+5|\n##\s)/);
+    if (!sectionMatch) {
+        return result;
+    }
+    const lines = sectionMatch[0].split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith('|'))
+            continue;
+        if (trimmed.includes('功能编号'))
+            continue; // header / separator
+        if (/^\|\s*-+/.test(trimmed))
+            continue; // markdown separator
+        const cells = trimmed
+            .split('|')
+            .map((c) => c.trim())
+            .filter((c) => c.length > 0);
+        if (cells.length < 4)
+            continue;
+        const featureModule = cells[0];
+        const featureId = cells[1];
+        const featureName = cells[2];
+        const description = cells[3];
+        if (!/^F\d{3,}$/i.test(featureId))
+            continue;
+        result.push({ featureId: featureId.toUpperCase(), featureName, featureModule, description });
+    }
+    return result;
+}
+/**
+ * 解析 4.2.x 功能详细说明。
+ */
+function parseFunctionDetails(markdown) {
+    const result = [];
+    // 匹配每个 4.2.x 子章节：#### 4.2.x Fxxx 功能名称
+    const sectionRegex = /####\s*4\.2\.(\d+)\s+((F\d{3,})\s+(.+?))\s*(?=\n)/g;
+    let match;
+    const sections = [];
+    while ((match = sectionRegex.exec(markdown)) !== null) {
+        sections.push({
+            start: match.index,
+            featureId: match[3].toUpperCase(),
+            featureName: match[4].trim(),
+            end: match.index + match[0].length,
+        });
+    }
+    for (let i = 0; i < sections.length; i++) {
+        const current = sections[i];
+        const nextSection = sections[i + 1];
+        const sectionEnd = findSectionEnd(current.end, markdown, nextSection?.start);
+        const sectionBody = markdown.slice(current.end, sectionEnd);
+        result.push(parseFunctionDetailSection(current.featureId, current.featureName, sectionBody));
+    }
+    return result;
+}
+/**
+ * 计算子章节结束位置。
+ *
+ * 结束位置取以下候选的最小值：
+ * 1. 下一个同层 `####` 子章节的开始位置。
+ * 2. 下一个更高层标题（`###` 或 `##`）的开始位置。
+ * 3. markdown 末尾。
+ */
+function findSectionEnd(start, markdown, nextSectionStart) {
+    const nextHeadingMatch = markdown.slice(start).match(/\n#{1,3}\s/m);
+    const nextHeadingStart = nextHeadingMatch
+        ? start + nextHeadingMatch.index + 1 // +1 跳过前面的换行
+        : undefined;
+    const candidates = [nextSectionStart, nextHeadingStart].filter((n) => n !== undefined);
+    return candidates.length > 0 ? Math.min(...candidates) : markdown.length;
+}
+/**
+ * 解析单个 4.2.x 子章节内容。
+ */
+function parseFunctionDetailSection(featureId, featureName, sectionBody) {
+    const fields = splitDetailFields(sectionBody);
+    return {
+        featureId,
+        featureName,
+        description: fields['功能描述']?.join('\n').trim() ?? '',
+        inputConditions: fields['输入条件']?.join('\n').trim() || undefined,
+        processingLogic: extractListItems(fields['处理逻辑']),
+        outputResult: extractListItems(fields['输出结果']),
+        businessRules: extractListItems(fields['业务规则']),
+        constraints: extractListItems(fields['约束条件']),
+    };
+}
+/**
+ * 按粗体字段标题把子章节内容切分成多个字段块。
+ *
+ * 字段标题形如 `**功能描述**:` 或 `**功能描述**：`（注意中文冒号）。
+ */
+function splitDetailFields(body) {
+    const lines = body.split('\n');
+    const fields = {};
+    let currentField;
+    const fieldHeaderRegex = /^\*\*([^*]+)\*\*[:：]\s*(.*)$/;
+    for (const rawLine of lines) {
+        const line = rawLine.trimEnd();
+        const headerMatch = line.trim().match(fieldHeaderRegex);
+        if (headerMatch) {
+            currentField = headerMatch[1].trim();
+            const rest = headerMatch[2].trim();
+            fields[currentField] = [];
+            if (rest) {
+                fields[currentField].push(rest);
+            }
+            continue;
+        }
+        if (currentField && line.trim().length > 0) {
+            // 跳过空行，但保留列表项和缩进内容
+            fields[currentField].push(line);
+        }
+    }
+    return fields;
+}
+/**
+ * 从字段块中提取列表项。
+ *
+ * 支持：
+ * - 有序列表 `1. ...`
+ * - 无序列表 `- ...`
+ * - 缩进列表（二级列表作为前一项的延续，不单独拆分）
+ *
+ * 过滤：
+ * - 空项
+ * - 纯 `--` 等表格/排版分隔符
+ */
+function extractListItems(lines) {
+    if (!lines || lines.length === 0)
+        return [];
+    const items = [];
+    for (const rawLine of lines) {
+        const line = rawLine.trim();
+        if (line.length === 0)
+            continue;
+        if (/^-+$/.test(line))
+            continue; // 过滤 '--' 分隔符
+        const listMatch = line.match(/^(?:\d+\.|-)\s+(.+)$/);
+        if (listMatch) {
+            const content = listMatch[1].trim();
+            if (content)
+                items.push(content);
+        }
+        else if (line.startsWith('-')) {
+            const content = line.replace(/^-\s*/, '').trim();
+            if (content)
+                items.push(content);
+        }
+        else if (items.length > 0 && rawLine.startsWith('   ')) {
+            // 缩进内容追加到前一项
+            items[items.length - 1] += ' ' + line;
+        }
+        // 非列表行（如普通段落）忽略，避免把标题残留混入
+    }
+    return items;
+}

package/dist/src/generators/agent-inferred-workflow-script.js

@@ -104,20 +104,20 @@ function renderGapFindingBlock(workflow, label, assertion) {
     const kind = /暂未实现|未实现|未配置|联系管理员/.test(observed)
         ? 'feature_incomplete'
         : 'behavior_mismatch';
-    return `
-        gapFinding: {
-          kind: ${singleQuoted(kind)},
-          summary: ${singleQuoted(`运行态推理发现「${label}」未满足业务预期。`)},
-          observed: ${singleQuoted(observed)},
+    return `
+        gapFinding: {
+          kind: ${singleQuoted(kind)},
+          summary: ${singleQuoted(`运行态推理发现「${label}」未满足业务预期。`)},
+          observed: ${singleQuoted(observed)},
         },`;
 }
 function renderRuntimeAwareAssertionBlock(input) {
     const exploration = input.workflow.resolvedRuntime?.exploration;
     if (!exploration) {
-        return `
-        await expect(${input.repoVariable}).toBeVisible();
-        await ${input.repoVariable}.click();
-
+        return `
+        await expect(${input.repoVariable}).toBeVisible();
+        await ${input.repoVariable}.click();
+
         await expect(page.getByText(${singleQuoted(input.assertion)})).toBeVisible({ timeout: 30000 });`;
     }
     const confirmVariable = confirmButtonVariableName(input.label);
@@ -125,33 +125,33 @@ function renderRuntimeAwareAssertionBlock(input) {
     const actualVariable = actualFeedbackVariableName(input.label);
     const runtimeObserved = exploration.observedMessage?.replace(/\s+/g, ' ').trim() ?? '';
     const confirmBlock = exploration.confirmDialogPresent
-        ? `
-
-        const ${confirmVariable} = ${input.locatorOwner}
-          .locator("xpath=//*[contains(@class,'mini-messagebox')]//a[normalize-space()='确定' or normalize-space()='确认']")
-          .first();
-        await expect(${confirmVariable}).toBeVisible({ timeout: 15000 });
+        ? `
+
+        const ${confirmVariable} = ${input.locatorOwner}
+          .locator("xpath=//*[contains(@class,'mini-messagebox')]//a[normalize-space()='确定' or normalize-space()='确认']")
+          .first();
+        await expect(${confirmVariable}).toBeVisible({ timeout: 15000 });
         await ${confirmVariable}.click();`
         : '';
-    return `
-        await expect(${input.repoVariable}).toBeVisible();
-        await ${input.repoVariable}.click();${confirmBlock}
-
-        const runtimeObserved反馈文案 = ${singleQuoted(runtimeObserved)};
-        const ${feedbackVariable} = ${input.locatorOwner}.locator("xpath=//*[contains(@class,'mini-messagebox') or contains(@class,'mini-tips')]");
-        await page.waitForTimeout(1000);
-        const 反馈文本列表 = (await ${feedbackVariable}.allInnerTexts())
-          .map((text) => text.replace(/\\s+/g, ' ').trim())
-          .filter(Boolean);
-        const ${actualVariable} =
-          反馈文本列表.find((text) => runtimeObserved反馈文案 && text.includes(runtimeObserved反馈文案)) ??
-          反馈文本列表.find((text) => text.includes(${singleQuoted(input.assertion)})) ??
-          runtimeObserved反馈文案 ??
-          反馈文本列表.sort((a, b) => b.length - a.length)[0] ??
-          '';
-        expect(
-          ${actualVariable}.includes(${singleQuoted(input.assertion)}),
-          ${singleQuoted(`${input.label}未达成业务预期：期望出现「${input.assertion}」，系统实际反馈「`)} + ${actualVariable} + '」',
+    return `
+        await expect(${input.repoVariable}).toBeVisible();
+        await ${input.repoVariable}.click();${confirmBlock}
+
+        const runtimeObserved反馈文案 = ${singleQuoted(runtimeObserved)};
+        const ${feedbackVariable} = ${input.locatorOwner}.locator("xpath=//*[contains(@class,'mini-messagebox') or contains(@class,'mini-tips')]");
+        await page.waitForTimeout(1000);
+        const 反馈文本列表 = (await ${feedbackVariable}.allInnerTexts())
+          .map((text) => text.replace(/\\s+/g, ' ').trim())
+          .filter(Boolean);
+        const ${actualVariable} =
+          反馈文本列表.find((text) => runtimeObserved反馈文案 && text.includes(runtimeObserved反馈文案)) ??
+          反馈文本列表.find((text) => text.includes(${singleQuoted(input.assertion)})) ??
+          runtimeObserved反馈文案 ??
+          反馈文本列表.sort((a, b) => b.length - a.length)[0] ??
+          '';
+        expect(
+          ${actualVariable}.includes(${singleQuoted(input.assertion)}),
+          ${singleQuoted(`${input.label}未达成业务预期：期望出现「${input.assertion}」，系统实际反馈「`)} + ${actualVariable} + '」',
         ).toBe(true);`;
 }
 export function renderAgentWorkflowTest(options) {
@@ -176,40 +176,40 @@ export function renderAgentWorkflowTest(options) {
         workflow,
     });
     const iframeSetup = iframeSrcKeyword
-        ? `
-        const ${frameVariable} = page.locator(${singleQuoted(`iframe[src*="${iframeSrcKeyword}"]`)}).contentFrame();
+        ? `
+        const ${frameVariable} = page.locator(${singleQuoted(`iframe[src*="${iframeSrcKeyword}"]`)}).contentFrame();
 `
         : '';
-    return `
-  test(${singleQuoted(title)}, async ({ page }) => {
-    test.slow();
-
-    await runRecordedWorkflow(
-      recorder,
-      {
-        moduleId: ${singleQuoted(options.moduleId)},
-        workflowId: ${singleQuoted(workflow.workflowId)},
-        workflowKind: 'custom',
-        workflowName: ${singleQuoted(label)},
-        executionSource: 'agent_inferred',
-        businessIntent: ${singleQuoted(intent)},
-        elementActions: ${arrayLiteral(actions)},
-        assertionExpectation: ${singleQuoted(assertion)},
-        evidenceSources: ${arrayLiteral(evidenceSources(workflow))},
-        evidenceRefs: ${renderEvidenceRefs(workflow)},
-        reviewReason: ${singleQuoted(workflow.reviewReason ?? '该工作流由 gap-planner 识别为自定义业务动作。')},
-        playwrightSuiteTitle: ${singleQuoted(options.suiteTitle)},
-        playwrightTestTitle: ${singleQuoted(title)},
-${gapFindingBlock}
-      },
-      async () => {
-        await openModule(page);
-${iframeSetup}
-        const ${repoVariable} = ${locatorOwner}.locator(${locatorLiteral(locator)});
-${assertionBlock}
-      },
-    );
-  });
+    return `
+  test(${singleQuoted(title)}, async ({ page }) => {
+    test.slow();
+
+    await runRecordedWorkflow(
+      recorder,
+      {
+        moduleId: ${singleQuoted(options.moduleId)},
+        workflowId: ${singleQuoted(workflow.workflowId)},
+        workflowKind: 'custom',
+        workflowName: ${singleQuoted(label)},
+        executionSource: 'agent_inferred',
+        businessIntent: ${singleQuoted(intent)},
+        elementActions: ${arrayLiteral(actions)},
+        assertionExpectation: ${singleQuoted(assertion)},
+        evidenceSources: ${arrayLiteral(evidenceSources(workflow))},
+        evidenceRefs: ${renderEvidenceRefs(workflow)},
+        reviewReason: ${singleQuoted(workflow.reviewReason ?? '该工作流由 gap-planner 识别为自定义业务动作。')},
+        playwrightSuiteTitle: ${singleQuoted(options.suiteTitle)},
+        playwrightTestTitle: ${singleQuoted(title)},
+${gapFindingBlock}
+      },
+      async () => {
+        await openModule(page);
+${iframeSetup}
+        const ${repoVariable} = ${locatorOwner}.locator(${locatorLiteral(locator)});
+${assertionBlock}
+      },
+    );
+  });
 `;
 }
 export function appendAgentWorkflowTest(options) {