@epoint-testtech/ep-stage-skill 0.0.7 → 0.0.9

package/dist/src/generators/stage-skeleton-script.js

@@ -385,18 +385,18 @@ function renderSearchCondition(condition, level) {
         if (condition.searchAssertion !== undefined) {
             lines.push(`${innerIndent}searchAssertion: ${singleQuoted(condition.searchAssertion)},`);
         }
-        return `${indent}{
-${lines.join('\n')}
+        return `${indent}{
+${lines.join('\n')}
 ${renderListboxSelections(condition.createSelections, level + 4)}${indent}}`;
     }
-    return `${indent}{
-${innerIndent}component: 'input',
-${innerIndent}field: ${singleQuoted(condition.field)},
-${innerIndent}label: ${singleQuoted(condition.label)},
-${innerIndent}seedValue: ${singleQuoted(condition.seedValue)},
-${renderOptionalStringProperty('strategy', condition.strategy, level + 4)}${renderOptionalStringProperty('fixedValue', condition.fixedValue, level + 4)}${renderOptionalStringProperty('updatePrefix', condition.updatePrefix, level + 4)}${renderOptionalStringProperty('searchSeedValue', condition.searchSeedValue, level + 4)}${innerIndent}addLocator: ${locatorLiteral(condition.addLocator)},
-${innerIndent}editLocator: ${locatorLiteral(condition.editLocator)},
-${innerIndent}listLocator: ${locatorLiteral(condition.listLocator)},
+    return `${indent}{
+${innerIndent}component: 'input',
+${innerIndent}field: ${singleQuoted(condition.field)},
+${innerIndent}label: ${singleQuoted(condition.label)},
+${innerIndent}seedValue: ${singleQuoted(condition.seedValue)},
+${renderOptionalStringProperty('strategy', condition.strategy, level + 4)}${renderOptionalStringProperty('fixedValue', condition.fixedValue, level + 4)}${renderOptionalStringProperty('updatePrefix', condition.updatePrefix, level + 4)}${renderOptionalStringProperty('searchSeedValue', condition.searchSeedValue, level + 4)}${innerIndent}addLocator: ${locatorLiteral(condition.addLocator)},
+${innerIndent}editLocator: ${locatorLiteral(condition.editLocator)},
+${innerIndent}listLocator: ${locatorLiteral(condition.listLocator)},
 ${indent}}`;
 }
 function renderSearchConditions(conditions, level) {
@@ -411,28 +411,28 @@ function renderSearchConditions(conditions, level) {
  * @returns TypeScript 对象源码
  */
 export function renderStageSkeletonCrudSlots(slots) {
-    return `{
-        moduleId: ${singleQuoted(slots.moduleId)},
-${renderSearchConditions(slots.searchConditions, 8)}
-        frames: {
-            listIframeSrcKeyword: ${singleQuoted(slots.frames.listIframeSrcKeyword)},
-            addIframeSrcKeyword: ${singleQuoted(slots.frames.addIframeSrcKeyword)},
-            editIframeSrcKeyword: ${singleQuoted(slots.frames.editIframeSrcKeyword)},
-        },
-        locators: {
-            createButton: ${locatorLiteral(slots.locators.createButton)},
-${renderOptionalStringProperty('addAutofillTrigger', slots.locators.addAutofillTrigger, 12)}
-            addSaveButton: ${locatorLiteral(slots.locators.addSaveButton)},
-            listSearchSubmit: ${locatorLiteral(slots.locators.listSearchSubmit)},
-            listResultValueLocatorTemplate: ${locatorLiteral(slots.locators.listResultValueLocatorTemplate)},
-            listEditActionLocatorTemplate: ${locatorLiteral(slots.locators.listEditActionLocatorTemplate)},
-            editSaveButton: ${locatorLiteral(slots.locators.editSaveButton)},
-            listRowSelectLocatorTemplate: ${locatorLiteral(slots.locators.listRowSelectLocatorTemplate)},
-            listDeleteButton: ${locatorLiteral(slots.locators.listDeleteButton)},
-${renderOptionalStringProperty('deleteConfirmButton', slots.locators.deleteConfirmButton, 12)}        },
-        assertions: {
-            deletePolicy: ${singleQuoted(slots.assertions.deletePolicy)},
-${renderOptionalStringProperty('blockedDeleteMessage', slots.assertions.blockedDeleteMessage, 12)}        },
+    return `{
+        moduleId: ${singleQuoted(slots.moduleId)},
+${renderSearchConditions(slots.searchConditions, 8)}
+        frames: {
+            listIframeSrcKeyword: ${singleQuoted(slots.frames.listIframeSrcKeyword)},
+            addIframeSrcKeyword: ${singleQuoted(slots.frames.addIframeSrcKeyword)},
+            editIframeSrcKeyword: ${singleQuoted(slots.frames.editIframeSrcKeyword)},
+        },
+        locators: {
+            createButton: ${locatorLiteral(slots.locators.createButton)},
+${renderOptionalStringProperty('addAutofillTrigger', slots.locators.addAutofillTrigger, 12)}
+            addSaveButton: ${locatorLiteral(slots.locators.addSaveButton)},
+            listSearchSubmit: ${locatorLiteral(slots.locators.listSearchSubmit)},
+            listResultValueLocatorTemplate: ${locatorLiteral(slots.locators.listResultValueLocatorTemplate)},
+            listEditActionLocatorTemplate: ${locatorLiteral(slots.locators.listEditActionLocatorTemplate)},
+            editSaveButton: ${locatorLiteral(slots.locators.editSaveButton)},
+            listRowSelectLocatorTemplate: ${locatorLiteral(slots.locators.listRowSelectLocatorTemplate)},
+            listDeleteButton: ${locatorLiteral(slots.locators.listDeleteButton)},
+${renderOptionalStringProperty('deleteConfirmButton', slots.locators.deleteConfirmButton, 12)}        },
+        assertions: {
+            deletePolicy: ${singleQuoted(slots.assertions.deletePolicy)},
+${renderOptionalStringProperty('blockedDeleteMessage', slots.assertions.blockedDeleteMessage, 12)}        },
     }`;
 }
 function renderChildGridColumns(columns, level) {
@@ -479,13 +479,13 @@ function renderChildGridLocators(locators, level) {
 export function renderChildGridSlots(slots) {
     if (slots.length === 0)
         return '[]';
-    const items = slots.map((slot) => `{
-        gridId: ${singleQuoted(slot.gridId)},
-        label: ${singleQuoted(slot.label)},
-        pageRole: ${singleQuoted(slot.pageRole)},
-        editMode: ${singleQuoted(slot.editMode)},
-        columns: ${renderChildGridColumns(slot.columns, 8).trimStart()},
-        locators: ${renderChildGridLocators(slot.locators, 8).trimStart()},
+    const items = slots.map((slot) => `{
+        gridId: ${singleQuoted(slot.gridId)},
+        label: ${singleQuoted(slot.label)},
+        pageRole: ${singleQuoted(slot.pageRole)},
+        editMode: ${singleQuoted(slot.editMode)},
+        columns: ${renderChildGridColumns(slot.columns, 8).trimStart()},
+        locators: ${renderChildGridLocators(slot.locators, 8).trimStart()},
     }`).join(',\n');
     return `[\n${items}\n]`;
 }
@@ -501,10 +501,10 @@ function renderChildGridFillSteps(slot, valuePrefix, indent = 10) {
     const spaces = ' '.repeat(indent);
     return slot.columns.map((col) => {
         if (col.component === 'input') {
-            return `${spaces}await childGridPage.editCell(1, ${singleQuoted(col.field)});
+            return `${spaces}await childGridPage.editCell(1, ${singleQuoted(col.field)});
 ${spaces}await childGridPage.fillInputCell(${singleQuoted(`${valuePrefix}${col.label}`)});`;
         }
-        return `${spaces}await childGridPage.editCell(1, ${singleQuoted(col.field)});
+        return `${spaces}await childGridPage.editCell(1, ${singleQuoted(col.field)});
 ${spaces}await childGridPage.selectListboxCell(childGridSlots[0].columns.find((c) => c.field === ${singleQuoted(col.field)})!);`;
     }).join('\n');
 }
@@ -528,95 +528,95 @@ function renderChildGridVerifyAssertions(slot, valuePrefix) {
 /**
  * 渲染单个子表的新增行测试。
  */
-function renderChildGridCreateTest(slot, crudSlots, moduleLabel, moduleId) {
+function renderChildGridCreateTest(slot, crudSlots, moduleLabel, moduleId, caseRef) {
     const label = slot.label;
     const fillSteps = renderChildGridFillSteps(slot, '测试');
     const verifyAssertions = renderChildGridVerifyAssertions(slot, '测试');
-    return `  test(${singleQuoted(`${label}-新增行并随主表保存`)}, async ({ page }) => {
-    test.slow();
-
-    await runRecordedWorkflow(
-      recorder,
-      workflowMeta({
-        workflowId: ${singleQuoted(`${moduleId}.childGrid.${slot.gridId}.create`)},
-        workflowKind: 'create',
-        workflowName: ${singleQuoted(`${label}-新增行`)},
-        businessIntent: ${singleQuoted(`在新增${moduleLabel}时维护${label}子表，验证子表数据随主表保存并持久化。`)},
-        elementActions: ['进入新增页', '点击子表新增行', '填写子表单元格', '保存主表', '返回列表搜索并校验子表数据'],
-        assertionExpectation: ${singleQuoted(`保存后重新打开编辑页，${label}子表应显示新增的行数据。`)},
-        playwrightTestTitle: ${singleQuoted(`${label}-新增行并随主表保存`)},
-      }),
-      async () => {
-        await openModule(page);
-        const crudPage = new CrudPage(page, crudSlots);
-        const childWorkflowData = crudPage.prepareWorkflowData();
-        await crudPage.runCreateWorkflowWithChildGrid(childWorkflowData, async (addContext) => {
-          const childGridPage = new ChildGridPage(page, addContext, childGridSlots[0]);
-          await childGridPage.addRow();
-${fillSteps}
-        });
-
-        // 验证子表数据持久化：搜索主记录并重新打开编辑页
-        const editActionLocator = ${locatorLiteral(crudSlots.locators.listEditActionLocatorTemplate)}.replace('{{value}}', childWorkflowData.searchValue);
-        await page.locator(editActionLocator).click();
-        const editFrame = page.locator(\`iframe[src*="${crudSlots.frames.editIframeSrcKeyword}"]\`).contentFrame();
-        const verifyChildGridPage = new ChildGridPage(page, editFrame, childGridSlots[0]);
-${verifyAssertions}
-      },
-    );
+    return `  test(${singleQuoted(caseRef ? `${caseRef.caseId} ${caseRef.title}` : `${label}-新增行并随主表保存`)}, async ({ page }) => {
+    test.slow();
+
+    await runRecordedWorkflow(
+      recorder,
+      workflowMeta({
+        workflowId: ${singleQuoted(`${moduleId}.childGrid.${slot.gridId}.create`)},
+        workflowKind: 'create',
+        workflowName: ${singleQuoted(caseRef?.title ?? `${label}-新增行`)},
+        businessIntent: ${singleQuoted(`在新增${moduleLabel}时维护${label}子表，验证子表数据随主表保存并持久化。`)},
+        elementActions: ['进入新增页', '点击子表新增行', '填写子表单元格', '保存主表', '返回列表搜索并校验子表数据'],
+        assertionExpectation: ${singleQuoted(`保存后重新打开编辑页，${label}子表应显示新增的行数据。`)},
+        playwrightTestTitle: ${singleQuoted(caseRef ? `${caseRef.caseId} ${caseRef.title}` : `${label}-新增行并随主表保存`)},
+      }),
+      async () => {
+        await openModule(page);
+        const crudPage = new CrudPage(page, crudSlots);
+        const childWorkflowData = crudPage.prepareWorkflowData();
+        await crudPage.runCreateWorkflowWithChildGrid(childWorkflowData, async (addContext) => {
+          const childGridPage = new ChildGridPage(page, addContext, childGridSlots[0]);
+          await childGridPage.addRow();
+${fillSteps}
+        });
+
+        // 验证子表数据持久化：搜索主记录并重新打开编辑页
+        const editActionLocator = ${locatorLiteral(crudSlots.locators.listEditActionLocatorTemplate)}.replace('{{value}}', childWorkflowData.searchValue);
+        await page.locator(editActionLocator).click();
+        const editFrame = page.locator(\`iframe[src*="${crudSlots.frames.editIframeSrcKeyword}"]\`).contentFrame();
+        const verifyChildGridPage = new ChildGridPage(page, editFrame, childGridSlots[0]);
+${verifyAssertions}
+      },
+    );
   });`;
 }
 /**
  * 渲染单个子表的编辑行测试。
  */
-function renderChildGridUpdateTest(slot, crudSlots, moduleLabel, moduleId) {
+function renderChildGridUpdateTest(slot, crudSlots, moduleLabel, moduleId, caseRef) {
     const label = slot.label;
     const createFillSteps = renderChildGridFillSteps(slot, '测试');
     const verifyAssertions = renderChildGridVerifyAssertions(slot, '修改后');
-    return `  test(${singleQuoted(`${label}-编辑行并随主表保存`)}, async ({ page }) => {
-    test.slow();
-
-    await runRecordedWorkflow(
-      recorder,
-      workflowMeta({
-        workflowId: ${singleQuoted(`${moduleId}.childGrid.${slot.gridId}.update`)},
-        workflowKind: 'update',
-        workflowName: ${singleQuoted(`${label}-编辑行`)},
-        businessIntent: ${singleQuoted(`在修改${moduleLabel}时维护${label}子表，验证子表数据随主表保存并持久化。`)},
-        elementActions: ['进入列表页', '创建带窗口信息子表的主记录', '打开编辑页', '修改子表单元格', '保存主表', '重新搜索并校验子表数据'],
-        assertionExpectation: ${singleQuoted(`保存后重新打开编辑页，${label}子表应显示更新后的行数据。`)},
-        playwrightTestTitle: ${singleQuoted(`${label}-编辑行并随主表保存`)},
-      }),
-      async () => {
-        await openModule(page);
-        const crudPage = new CrudPage(page, crudSlots);
-        const childWorkflowData = crudPage.prepareWorkflowData();
-
-        // 前置：创建带${label}子表的主记录
-        await crudPage.runCreateWorkflowWithChildGrid(childWorkflowData, async (addContext) => {
-          const childGridPage = new ChildGridPage(page, addContext, childGridSlots[0]);
-          await childGridPage.addRow();
-${createFillSteps}
-        });
-
-        // 打开编辑页并修改子表行
-        const editActionLocator = ${locatorLiteral(crudSlots.locators.listEditActionLocatorTemplate)}.replace('{{value}}', childWorkflowData.searchValue);
-        await page.locator(editActionLocator).click();
-        const editFrame = page.locator(\`iframe[src*="${crudSlots.frames.editIframeSrcKeyword}"]\`).contentFrame();
-        const childGridPage = new ChildGridPage(page, editFrame, childGridSlots[0]);
-${renderChildGridFillSteps(slot, '修改后', 8)}
-
-        // 保存主表
-        await editFrame.locator(crudSlots.locators.editSaveButton).click();
-
-        // 验证子表数据持久化：重新搜索主记录并打开编辑页
-        const verifyEditActionLocator = ${locatorLiteral(crudSlots.locators.listEditActionLocatorTemplate)}.replace('{{value}}', childWorkflowData.searchValue);
-        await page.locator(verifyEditActionLocator).click();
-        const verifyEditFrame = page.locator(\`iframe[src*="${crudSlots.frames.editIframeSrcKeyword}"]\`).contentFrame();
-        const verifyChildGridPage = new ChildGridPage(page, verifyEditFrame, childGridSlots[0]);
-${verifyAssertions}
-      },
-    );
+    return `  test(${singleQuoted(caseRef ? `${caseRef.caseId} ${caseRef.title}` : `${label}-编辑行并随主表保存`)}, async ({ page }) => {
+    test.slow();
+
+    await runRecordedWorkflow(
+      recorder,
+      workflowMeta({
+        workflowId: ${singleQuoted(`${moduleId}.childGrid.${slot.gridId}.update`)},
+        workflowKind: 'update',
+        workflowName: ${singleQuoted(caseRef?.title ?? `${label}-编辑行`)},
+        businessIntent: ${singleQuoted(`在修改${moduleLabel}时维护${label}子表，验证子表数据随主表保存并持久化。`)},
+        elementActions: ['进入列表页', '创建带窗口信息子表的主记录', '打开编辑页', '修改子表单元格', '保存主表', '重新搜索并校验子表数据'],
+        assertionExpectation: ${singleQuoted(`保存后重新打开编辑页，${label}子表应显示更新后的行数据。`)},
+        playwrightTestTitle: ${singleQuoted(caseRef ? `${caseRef.caseId} ${caseRef.title}` : `${label}-编辑行并随主表保存`)},
+      }),
+      async () => {
+        await openModule(page);
+        const crudPage = new CrudPage(page, crudSlots);
+        const childWorkflowData = crudPage.prepareWorkflowData();
+
+        // 前置：创建带${label}子表的主记录
+        await crudPage.runCreateWorkflowWithChildGrid(childWorkflowData, async (addContext) => {
+          const childGridPage = new ChildGridPage(page, addContext, childGridSlots[0]);
+          await childGridPage.addRow();
+${createFillSteps}
+        });
+
+        // 打开编辑页并修改子表行
+        const editActionLocator = ${locatorLiteral(crudSlots.locators.listEditActionLocatorTemplate)}.replace('{{value}}', childWorkflowData.searchValue);
+        await page.locator(editActionLocator).click();
+        const editFrame = page.locator(\`iframe[src*="${crudSlots.frames.editIframeSrcKeyword}"]\`).contentFrame();
+        const childGridPage = new ChildGridPage(page, editFrame, childGridSlots[0]);
+${renderChildGridFillSteps(slot, '修改后', 8)}
+
+        // 保存主表
+        await editFrame.locator(crudSlots.locators.editSaveButton).click();
+
+        // 验证子表数据持久化：重新搜索主记录并打开编辑页
+        const verifyEditActionLocator = ${locatorLiteral(crudSlots.locators.listEditActionLocatorTemplate)}.replace('{{value}}', childWorkflowData.searchValue);
+        await page.locator(verifyEditActionLocator).click();
+        const verifyEditFrame = page.locator(\`iframe[src*="${crudSlots.frames.editIframeSrcKeyword}"]\`).contentFrame();
+        const verifyChildGridPage = new ChildGridPage(page, verifyEditFrame, childGridSlots[0]);
+${verifyAssertions}
+      },
+    );
   });`;
 }
 /**
@@ -625,100 +625,100 @@ ${verifyAssertions}
  * 注意：本测试会断言删除成功后子表行被真正移除。若系统存在 confirm 确定后仍删除失败的 bug，
  * 该断言将失败，从而暴露问题，而不是为了绕过 bug 而降低断言标准。
  */
-function renderChildGridDeleteTest(slot, crudSlots, moduleLabel, moduleId) {
+function renderChildGridDeleteTest(slot, crudSlots, moduleLabel, moduleId, caseRef) {
     const label = slot.label;
     const createFillSteps = renderChildGridFillSteps(slot, '测试');
-    return `  test(${singleQuoted(`${label}-删除行`)}, async ({ page }) => {
-    test.slow();
-
-    await runRecordedWorkflow(
-      recorder,
-      workflowMeta({
-        workflowId: ${singleQuoted(`${moduleId}.childGrid.${slot.gridId}.delete`)},
-        workflowKind: 'delete',
-        workflowName: ${singleQuoted(`${label}-删除行`)},
-        businessIntent: ${singleQuoted(`验证${moduleLabel}的${label}子表删除选中行后，数据应被真正移除。`)},
-        elementActions: ['进入列表页', '创建带窗口信息子表的主记录', '打开编辑页', '勾选子表行', '点击删除选中', '确认删除', '校验子表行已移除'],
-        assertionExpectation: ${singleQuoted(`确认删除后，${label}子表的数据行数应为 0，被删除的数据不再存在。`)},
-        playwrightTestTitle: ${singleQuoted(`${label}-删除行`)},
-      }),
-      async () => {
-        await openModule(page);
-        const crudPage = new CrudPage(page, crudSlots);
-        const childWorkflowData = crudPage.prepareWorkflowData();
-
-        // 前置：创建带${label}子表的主记录
-        await crudPage.runCreateWorkflowWithChildGrid(childWorkflowData, async (addContext) => {
-          const childGridPage = new ChildGridPage(page, addContext, childGridSlots[0]);
-          await childGridPage.addRow();
-${createFillSteps}
-        });
-
-        // 打开编辑页
-        const editActionLocator = ${locatorLiteral(crudSlots.locators.listEditActionLocatorTemplate)}.replace('{{value}}', childWorkflowData.searchValue);
-        await page.locator(editActionLocator).click();
-        const editFrame = page.locator(\`iframe[src*="${crudSlots.frames.editIframeSrcKeyword}"]\`).contentFrame();
-
-        const childGridPage = new ChildGridPage(page, editFrame, childGridSlots[0]);
-        const confirmPromise = childGridPage.acceptCustomConfirm('确定要删除');
-        await childGridPage.selectRow(1);
-        await childGridPage.deleteSelected();
-
-        await confirmPromise;
-
-        // 断言删除成功：子表数据行数应为 0
-        await page.waitForTimeout(500);
-        await childGridPage.assertRowCount(0);
-      },
-    );
+    return `  test(${singleQuoted(caseRef ? `${caseRef.caseId} ${caseRef.title}` : `${label}-删除行`)}, async ({ page }) => {
+    test.slow();
+
+    await runRecordedWorkflow(
+      recorder,
+      workflowMeta({
+        workflowId: ${singleQuoted(`${moduleId}.childGrid.${slot.gridId}.delete`)},
+        workflowKind: 'delete',
+        workflowName: ${singleQuoted(caseRef?.title ?? `${label}-删除行`)},
+        businessIntent: ${singleQuoted(`验证${moduleLabel}的${label}子表删除选中行后，数据应被真正移除。`)},
+        elementActions: ['进入列表页', '创建带窗口信息子表的主记录', '打开编辑页', '勾选子表行', '点击删除选中', '确认删除', '校验子表行已移除'],
+        assertionExpectation: ${singleQuoted(`确认删除后，${label}子表的数据行数应为 0，被删除的数据不再存在。`)},
+        playwrightTestTitle: ${singleQuoted(caseRef ? `${caseRef.caseId} ${caseRef.title}` : `${label}-删除行`)},
+      }),
+      async () => {
+        await openModule(page);
+        const crudPage = new CrudPage(page, crudSlots);
+        const childWorkflowData = crudPage.prepareWorkflowData();
+
+        // 前置：创建带${label}子表的主记录
+        await crudPage.runCreateWorkflowWithChildGrid(childWorkflowData, async (addContext) => {
+          const childGridPage = new ChildGridPage(page, addContext, childGridSlots[0]);
+          await childGridPage.addRow();
+${createFillSteps}
+        });
+
+        // 打开编辑页
+        const editActionLocator = ${locatorLiteral(crudSlots.locators.listEditActionLocatorTemplate)}.replace('{{value}}', childWorkflowData.searchValue);
+        await page.locator(editActionLocator).click();
+        const editFrame = page.locator(\`iframe[src*="${crudSlots.frames.editIframeSrcKeyword}"]\`).contentFrame();
+
+        const childGridPage = new ChildGridPage(page, editFrame, childGridSlots[0]);
+        const confirmPromise = childGridPage.acceptCustomConfirm('确定要删除');
+        await childGridPage.selectRow(1);
+        await childGridPage.deleteSelected();
+
+        await confirmPromise;
+
+        // 断言删除成功：子表数据行数应为 0
+        await page.waitForTimeout(500);
+        await childGridPage.assertRowCount(0);
+      },
+    );
   });`;
 }
 /**
  * 渲染单个子表的必填校验测试。
  */
-function renderChildGridRequiredTest(slot, moduleLabel, moduleId) {
+function renderChildGridRequiredTest(slot, moduleLabel, moduleId, caseRef) {
     const label = slot.label;
     const requiredFields = slot.columns.filter((c) => c.required);
     const requiredLabels = requiredFields.map((c) => c.label).join('、');
-    return `  test(${singleQuoted(`${label}-必填校验`)}, async ({ page }) => {
-    test.slow();
-
-    await runRecordedWorkflow(
-      recorder,
-      workflowMeta({
-        workflowId: ${singleQuoted(`${moduleId}.childGrid.${slot.gridId}.required`)},
-        workflowKind: 'create',
-        workflowName: ${singleQuoted(`${label}-必填校验`)},
-        businessIntent: ${singleQuoted(`验证${label}子表必填字段未填写时，主表保存应被阻断并给出校验提示。`)},
-        elementActions: ['进入新增页', '点击子表新增行', '不填必填字段', '保存主表', '观察校验提示'],
-        assertionExpectation: ${singleQuoted(`系统应阻断保存并提示「${requiredLabels}不能为空」。`)},
-        playwrightTestTitle: ${singleQuoted(`${label}-必填校验`)},
-      }),
-      async () => {
-        await openModule(page);
-        const crudPage = new CrudPage(page, crudSlots);
-        const childWorkflowData = crudPage.prepareWorkflowData();
-
-        let alertPromise: Promise<void> | undefined;
-
-        await crudPage.runCreateWorkflowWithChildGridWithoutSearch(childWorkflowData, async (addContext) => {
-          const childGridPage = new ChildGridPage(page, addContext, childGridSlots[0]);
-          alertPromise = childGridPage.assertAlert('不能为空');
-          await childGridPage.addRow();
-        });
-
-        if (!alertPromise) {
-          throw new Error('alertPromise 未初始化');
-        }
-        await alertPromise;
-      },
-    );
+    return `  test(${singleQuoted(caseRef ? `${caseRef.caseId} ${caseRef.title}` : `${label}-必填校验`)}, async ({ page }) => {
+    test.slow();
+
+    await runRecordedWorkflow(
+      recorder,
+      workflowMeta({
+        workflowId: ${singleQuoted(`${moduleId}.childGrid.${slot.gridId}.required`)},
+        workflowKind: 'create',
+        workflowName: ${singleQuoted(caseRef?.title ?? `${label}-必填校验`)},
+        businessIntent: ${singleQuoted(`验证${label}子表必填字段未填写时，主表保存应被阻断并给出校验提示。`)},
+        elementActions: ['进入新增页', '点击子表新增行', '不填必填字段', '保存主表', '观察校验提示'],
+        assertionExpectation: ${singleQuoted(`系统应阻断保存并提示「${requiredLabels}不能为空」。`)},
+        playwrightTestTitle: ${singleQuoted(caseRef ? `${caseRef.caseId} ${caseRef.title}` : `${label}-必填校验`)},
+      }),
+      async () => {
+        await openModule(page);
+        const crudPage = new CrudPage(page, crudSlots);
+        const childWorkflowData = crudPage.prepareWorkflowData();
+
+        let alertPromise: Promise<void> | undefined;
+
+        await crudPage.runCreateWorkflowWithChildGridWithoutSearch(childWorkflowData, async (addContext) => {
+          const childGridPage = new ChildGridPage(page, addContext, childGridSlots[0]);
+          alertPromise = childGridPage.assertAlert('不能为空');
+          await childGridPage.addRow();
+        });
+
+        if (!alertPromise) {
+          throw new Error('alertPromise 未初始化');
+        }
+        await alertPromise;
+      },
+    );
   });`;
 }
 /**
  * 渲染所有子表测试块（新增行、编辑行、删除行、必填校验）。
  */
-function renderChildGridTests(slots, crudSlots, moduleLabel, moduleId) {
+function renderChildGridTests(slots, crudSlots, moduleLabel, moduleId, glueCases) {
     if (slots.length === 0)
         return '';
     return slots
@@ -729,15 +729,126 @@ function renderChildGridTests(slots, crudSlots, moduleLabel, moduleId) {
         if (slot.editMode === 'row_button_dialog') {
             return [`  // TODO: ${slot.label} 子表为行按钮弹窗编辑模式，测试待实现`];
         }
+        // 子表用例标题（如「窗口信息-新增行」）→ caseId 引用，供测试标题带用例ID。
+        const caseRefOf = (suffix) => glueCases?.find((testCase) => testCase.title === `${slot.label}-${suffix}`);
         return [
-            renderChildGridCreateTest(slot, crudSlots, moduleLabel, moduleId),
-            renderChildGridUpdateTest(slot, crudSlots, moduleLabel, moduleId),
-            renderChildGridDeleteTest(slot, crudSlots, moduleLabel, moduleId),
-            renderChildGridRequiredTest(slot, moduleLabel, moduleId),
+            renderChildGridCreateTest(slot, crudSlots, moduleLabel, moduleId, caseRefOf('新增行')),
+            renderChildGridUpdateTest(slot, crudSlots, moduleLabel, moduleId, caseRefOf('编辑行')),
+            renderChildGridDeleteTest(slot, crudSlots, moduleLabel, moduleId, caseRefOf('删除行')),
+            renderChildGridRequiredTest(slot, moduleLabel, moduleId, caseRefOf('必填校验')),
         ];
     })
         .join('\n\n');
 }
+/** 解析 glue CRUD 用例标题：`${moduleName} ${actionKind}（${queryKey}）`。 */
+function parseCrudCaseTitle(title) {
+    const match = title.match(/\s(create|read|update|delete)（(.+)）\s*$/);
+    if (!match)
+        return null;
+    return {
+        actionKind: match[1],
+        queryKeyLabel: match[2],
+    };
+}
+/** 把用例 steps 文本（"1. …。 2. …。"）拆成 elementActions 数组。 */
+function splitCaseSteps(steps, fallback) {
+    if (!steps)
+        return fallback;
+    const parts = steps
+        .split(/(?=\d+\.\s)/)
+        .map((part) => part.replace(/^\d+\.\s*/, '').trim())
+        .filter(Boolean);
+    return parts.length > 0 ? parts : fallback;
+}
+/**
+ * 按用例逐条渲染主表 CRUD 测试（一用例一脚本）。
+ *
+ * 串行 describe 内用 workflowDataByKey 按查询主键分组共享记录：
+ * create 用例新建记录；同键 read/update/delete 复用；只读键（如系统管理的状态字段）
+ * 挂靠最近一个 create 组的记录。用例顺序即装配器产出顺序。
+ */
+function renderCrudCaseTests(cases, context) {
+    const { moduleId, componentForLabel } = context;
+    const createKeys = new Set(cases.filter((c) => c.actionKind === 'create').map((c) => c.queryKeyLabel));
+    let lastCreateKey = '';
+    const blocks = cases.map((testCase) => {
+        const fullTitle = `${testCase.caseId} ${testCase.title}`;
+        const key = testCase.queryKeyLabel;
+        if (testCase.actionKind === 'create') {
+            lastCreateKey = key;
+        }
+        const dataKey = createKeys.has(key) ? key : lastCreateKey;
+        const workflowKind = testCase.actionKind;
+        const elementActions = splitCaseSteps(testCase.steps, ['按用例步骤执行']).map((a) => singleQuoted(a)).join(', ');
+        const businessIntent = testCase.steps ?? `按用例「${testCase.title}」步骤执行。`;
+        const assertionExpectation = testCase.assertion ?? '按用例断言验证执行结果。';
+        let body;
+        switch (testCase.actionKind) {
+            case 'create':
+                body = `        await openModule(page);
+        const crudPage = new CrudPage(page, crudSlots);
+        const data = crudPage.prepareWorkflowData();
+        workflowDataByKey[${singleQuoted(key)}] = data;
+        await crudPage.runCreateWorkflow(data);`;
+                break;
+            case 'read':
+                body = `        await openModule(page);
+        const data = workflowDataByKey[${singleQuoted(dataKey)}];
+        if (!data) {
+          throw new Error(${singleQuoted(`${testCase.title} 依赖 create（${dataKey}）用例先行生成 workflowData`)});
+        }
+        const crudPage = new CrudPage(page, crudSlots);
+        await crudPage.runReadWorkflowByField(data, ${singleQuoted(key)});`;
+                break;
+            case 'update':
+                body = `        await openModule(page);
+        const data = workflowDataByKey[${singleQuoted(dataKey)}];
+        if (!data) {
+          throw new Error(${singleQuoted(`${testCase.title} 依赖 create（${dataKey}）用例先行生成 workflowData`)});
+        }
+        const crudPage = new CrudPage(page, crudSlots);
+${componentForLabel(key) === 'listbox'
+                    ? `        await crudPage.runUpdateListboxWorkflow(data, ${singleQuoted(key)});`
+                    : `        await crudPage.runUpdateWorkflow(data);`}`;
+                break;
+            case 'delete':
+                body = `        await openModule(page);
+        const data = workflowDataByKey[${singleQuoted(dataKey)}];
+        if (!data) {
+          throw new Error(${singleQuoted(`${testCase.title} 依赖 create（${dataKey}）用例先行生成 workflowData`)});
+        }
+        const crudPage = new CrudPage(page, crudSlots);
+        await crudPage.runDeleteWorkflow(data);`;
+                break;
+        }
+        return `    test(${singleQuoted(fullTitle)}, async ({ page }) => {
+    test.slow();
+
+    await runRecordedWorkflow(
+      recorder,
+      workflowMeta({
+        workflowId: ${singleQuoted(`${moduleId}.${testCase.caseId}`)},
+        workflowKind: '${workflowKind}',
+        workflowName: ${singleQuoted(testCase.title)},
+        businessIntent: ${singleQuoted(businessIntent)},
+        elementActions: [${elementActions}],
+        assertionExpectation: ${singleQuoted(assertionExpectation)},
+        playwrightTestTitle: ${singleQuoted(fullTitle)},
+      }),
+      async () => {
+${body}
+      },
+    );
+  });`;
+    });
+    return `  test.describe('主表 CRUD 流程', () => {
+    test.describe.configure({ mode: 'serial' });
+    const workflowDataByKey: Record<string, CrudWorkflowData | undefined> = {};
+
+${blocks.join('\n\n')}
+
+  });`;
+}
 /**
  * 渲染导出骨架槽位对象。
  *
@@ -745,18 +856,18 @@ function renderChildGridTests(slots, crudSlots, moduleLabel, moduleId) {
  * @returns TypeScript 对象字面量源码
  */
 function renderExportSlots(contract) {
-    return `{
-        moduleId: ${singleQuoted(contract.module.id)},
-        frames: {
-            listIframeSrcKeyword: ${singleQuoted(iframeKeyword(contract.pages.list.iframeSrcKeyword, true))},
-        },
-        locators: {
-            exportButton: '.mini-button.mini-dataexport',
-        },
-        export: {
-            label: '导出',
-            mode: 'all' as const,
-        },
+    return `{
+        moduleId: ${singleQuoted(contract.module.id)},
+        frames: {
+            listIframeSrcKeyword: ${singleQuoted(iframeKeyword(contract.pages.list.iframeSrcKeyword, true))},
+        },
+        locators: {
+            exportButton: '.mini-button.mini-dataexport',
+        },
+        export: {
+            label: '导出',
+            mode: 'all' as const,
+        },
     }`;
 }
 /**
@@ -772,18 +883,18 @@ function renderExportSlots(contract) {
  * @returns TypeScript 对象字面量源码
  */
 function renderExportSlotsFromSlot(exportSlot, listIframeSrcKeyword) {
-    return `{
-        moduleId: ${singleQuoted(exportSlot.moduleId)},
-        frames: {
-            listIframeSrcKeyword: ${singleQuoted(listIframeSrcKeyword)},
-        },
-        locators: {
-            exportButton: '.mini-button.mini-dataexport',
-        },
-        export: {
-            label: ${singleQuoted(exportSlot.label)},
-            mode: ${exportSlot.mode === 'all' ? "'all' as const" : singleQuoted(exportSlot.mode)},
-        },
+    return `{
+        moduleId: ${singleQuoted(exportSlot.moduleId)},
+        frames: {
+            listIframeSrcKeyword: ${singleQuoted(listIframeSrcKeyword)},
+        },
+        locators: {
+            exportButton: '.mini-button.mini-dataexport',
+        },
+        export: {
+            label: ${singleQuoted(exportSlot.label)},
+            mode: ${exportSlot.mode === 'all' ? "'all' as const" : singleQuoted(exportSlot.mode)},
+        },
     }`;
 }
 /**
@@ -802,219 +913,129 @@ function renderExportSlotsFromSlot(exportSlot, listIframeSrcKeyword) {
  * @returns 完整的 `.spec.ts` 源码
  */
 export function generateStageSkeletonCrudSpecFromSlots(options) {
-    const { moduleId, moduleLabel, directUrl, primaryRole, requirementName, crudSlots, exportSlot, childGridSlots } = options;
+    const { moduleId, moduleLabel, directUrl, primaryRole, requirementName, crudSlots, exportSlot, childGridSlots, glueCases } = options;
     const suiteTitle = `${moduleLabel} CRUD + Export`;
-    const deletePolicy = crudSlots.assertions.deletePolicy;
-    const blockedDeleteMessage = crudSlots.assertions.blockedDeleteMessage;
-    // 删除工作流的业务意图和断言取决于 deletePolicy
-    const deleteIntent = deletePolicy === 'blocked_by_business_rule'
-        ? `在列表页选择${moduleLabel}记录后点击删除，验证业务规则拦截删除操作${blockedDeleteMessage ? `（${blockedDeleteMessage}）` : ''}。`
-        : `在列表页选择${moduleLabel}记录后点击删除并确认，验证列表中不再存在该记录。`;
-    const deleteAssertion = deletePolicy === 'blocked_by_business_rule'
-        ? `删除操作应被业务规则拦截${blockedDeleteMessage ? `，提示「${blockedDeleteMessage}」` : ''}，列表保留该记录。`
-        : '删除成功后，列表中不再存在该记录，搜索结果为空。';
     const childGridImport = childGridSlots?.length
         ? ', ChildGridPage, type ChildGridFlowSlots'
         : '';
-    return `import { test, expect, type Page } from '@playwright/test';
-import { loadCredentials, StagePath, type Credential } from '@epoint-testtech/stage-core';
-import { CrudPage, ExportPage, LoginPage${childGridImport}, type CrudFlowSlots, type ExportFlowSlots, type CrudWorkflowData } from '../../skeletons';
-import { GlueWorkflowRecorder, runRecordedWorkflow, type GlueWorkflowRecordInput } from '../../report/glue-report';
-
-test.describe(${singleQuoted(suiteTitle)}, () => {
-  const directListUrl = ${singleQuoted(directUrl)};
-  const credentialsPath = \`\${StagePath.projectRootDirPath}/src/tests/${requirementName}/credentials.json5\`;
-  const primaryRole = ${singleQuoted(primaryRole)};
-  const crudSlots: CrudFlowSlots = ${renderStageSkeletonCrudSlots(crudSlots)};
-  const exportSlots = ${renderExportSlotsFromSlot(exportSlot, crudSlots.frames.listIframeSrcKeyword)};
-${childGridSlots?.length ? `  const childGridSlots: ChildGridFlowSlots[] = ${renderChildGridSlots(childGridSlots)};` : ''}
-
-  const recorder = new GlueWorkflowRecorder({
-    outputRoot: StagePath.projectRootDirPath,
-    moduleId: ${singleQuoted(moduleId)},
-    moduleName: ${singleQuoted(moduleLabel)},
-    suiteTitle: ${singleQuoted(suiteTitle)},
-    generatedSpecFile: import.meta.url,
-  });
-
-  test.beforeAll(async ({ browser }) => {
-    recorder.updateEnvironment({
-      browserName: browser.browserType().name(),
-      browserVersion: browser.version(),
-    });
-  });
-
-  test.afterAll(() => {
-    recorder.writeReport();
-  });
-
-  function resolveCredential(role: string): Credential {
-    const [credential] = loadCredentials(credentialsPath, role);
-    if (!credential) {
-      throw new Error(\`credentials.json5 中未找到角色: \${role}\`);
-    }
-    return credential;
-  }
-
-  function applyLoginCredential(credential: Credential): void {
-    process.env.LOGIN_SYSTEM_URL = credential.url;
-    process.env.LOGIN_USERNAME = credential.username;
-    process.env.LOGIN_PASSWORD = credential.password;
-  }
-
-  async function openModule(page: Page): Promise<void> {
-    applyLoginCredential(resolveCredential(primaryRole));
-    const loginPage = new LoginPage(page);
-    await loginPage.login();
-    await loginPage.gotoDirectUrl(directListUrl);
-  }
-
-  function workflowMeta(
-    input: Omit<
-      GlueWorkflowRecordInput,
-      'moduleId' | 'executionSource' | 'evidenceSources' | 'evidenceRefs' | 'playwrightSuiteTitle'
-    >,
-  ): GlueWorkflowRecordInput {
-    return {
-      moduleId: ${singleQuoted(moduleId)},
-      executionSource: 'glue_code' as const,
-      evidenceSources: ['crud_flow_slots'],
-      evidenceRefs: [],
-      playwrightSuiteTitle: ${singleQuoted(suiteTitle)},
-      ...input,
-    };
-  }
-
-  test.describe('主表 CRUD 流程', () => {
-    test.describe.configure({ mode: 'serial' });
-    let workflowData: CrudWorkflowData | undefined;
-
-    test('Create：新增${moduleLabel}并校验列表存在对应记录', async ({ page }) => {
-    test.slow();
-
-    await runRecordedWorkflow(
-      recorder,
-      workflowMeta({
-        workflowId: ${singleQuoted(`${moduleId}.create`)},
-        workflowKind: 'create',
-        workflowName: '新增${moduleLabel}',
-        businessIntent: '在列表页点击新增按钮，填写表单并保存，验证列表中存在新增的记录。',
-        elementActions: ['点击列表页新增按钮打开新增弹框', '在新增弹框中填写表单字段', '点击保存并关闭提交表单', '在列表页搜索并验证记录存在'],
-        assertionExpectation: '新增成功后，列表页应能通过搜索找到刚新增的记录。',
-        playwrightTestTitle: 'Create：新增${moduleLabel}并校验列表存在对应记录',
-      }),
-      async () => {
-        await openModule(page);
-        const crudPage = new CrudPage(page, crudSlots);
-        workflowData = crudPage.prepareWorkflowData();
-        await crudPage.runCreateWorkflow(workflowData);
-      },
-    );
-  });
-
-    test('Read：搜索${moduleLabel}并校验搜索结果', async ({ page }) => {
-    test.slow();
-
-    await runRecordedWorkflow(
-      recorder,
-      workflowMeta({
-        workflowId: ${singleQuoted(`${moduleId}.read`)},
-        workflowKind: 'read',
-        workflowName: '搜索${moduleLabel}',
-        businessIntent: '使用搜索条件查询记录，验证搜索结果与搜索条件匹配。',
-        elementActions: ['在搜索区域填写搜索条件', '点击搜索按钮提交查询', '在结果列表中校验搜索结果'],
-        assertionExpectation: '搜索结果列表中应包含符合搜索条件的记录。',
-        playwrightTestTitle: 'Read：搜索${moduleLabel}并校验搜索结果',
-      }),
-      async () => {
-        await openModule(page);
-        if (!workflowData) {
-          throw new Error('Read 工作流依赖 Create 工作流先行生成 workflowData');
-        }
-        const crudPage = new CrudPage(page, crudSlots);
-        await crudPage.runReadWorkflow(workflowData);
-      },
-    );
-  });
-
-    test('Update：修改${moduleLabel}并校验修改结果', async ({ page }) => {
-    test.slow();
-
-    await runRecordedWorkflow(
-      recorder,
-      workflowMeta({
-        workflowId: ${singleQuoted(`${moduleId}.update`)},
-        workflowKind: 'update',
-        workflowName: '修改${moduleLabel}',
-        businessIntent: '定位目标记录行，点击修改按钮进入编辑弹框，修改字段后保存，验证修改生效。',
-        elementActions: ['在列表中定位目标记录行', '点击行操作中的修改按钮打开编辑弹框', '修改表单字段', '点击保存并关闭提交修改'],
-        assertionExpectation: '修改成功后，列表页应显示修改后的字段值。',
-        playwrightTestTitle: 'Update：修改${moduleLabel}并校验修改结果',
-      }),
-      async () => {
-        await openModule(page);
-        if (!workflowData) {
-          throw new Error('Update 工作流依赖 Create 工作流先行生成 workflowData');
-        }
-        const crudPage = new CrudPage(page, crudSlots);
-        await crudPage.runUpdateWorkflow(workflowData);
-      },
-    );
-  });
-
-    test('Delete：删除${moduleLabel}并校验${deletePolicy === 'blocked_by_business_rule' ? '业务规则拦截' : '删除结果'}', async ({ page }) => {
-    test.slow();
-
-    await runRecordedWorkflow(
-      recorder,
-      workflowMeta({
-        workflowId: ${singleQuoted(`${moduleId}.delete`)},
-        workflowKind: 'delete',
-        workflowName: '删除${moduleLabel}',
-        businessIntent: ${singleQuoted(deleteIntent)},
-        elementActions: ['在列表中选择目标记录', '点击删除按钮触发删除确认', ${deletePolicy === 'blocked_by_business_rule' ? "'确认删除操作并验证拦截提示'" : "'确认删除操作'"}],
-        assertionExpectation: ${singleQuoted(deleteAssertion)},
-        playwrightTestTitle: 'Delete：删除${moduleLabel}并校验${deletePolicy === 'blocked_by_business_rule' ? '业务规则拦截' : '删除结果'}',
-      }),
-      async () => {
-        await openModule(page);
-        if (!workflowData) {
-          throw new Error('Delete 工作流依赖 Create 工作流先行生成 workflowData');
-        }
-        const crudPage = new CrudPage(page, crudSlots);
-        await crudPage.runDeleteWorkflow(workflowData);
-      },
-    );
-  });
-
-  });
-
-  test('Export：导出${moduleLabel}列表并校验下载文件', async ({ page }, testInfo) => {
-    test.slow();
-
-    await runRecordedWorkflow(
-      recorder,
-      workflowMeta({
-        workflowId: ${singleQuoted(`${moduleId}.export`)},
-        workflowKind: 'export',
-        workflowName: '导出${moduleLabel}列表',
-        businessIntent: '在列表页触发全部导出，验证导出弹框可驱动并成功下载数据文件。',
-        elementActions: ['点击列表页数据导出按钮打开导出弹框', '在导出弹框选择「全部」并确认导出', '等待 download 事件并断言下载文件存在且非空'],
-        assertionExpectation: '导出操作应触发下载，落盘文件存在且大小大于 0。',
-        playwrightTestTitle: 'Export：导出${moduleLabel}列表并校验下载文件',
-      }),
-      async () => {
-        await openModule(page);
-        const exportPage = new ExportPage(page, exportSlots);
-        await exportPage.runExportWorkflow(testInfo);
-      },
-    );
-  });
-
-${childGridSlots?.length ? renderChildGridTests(childGridSlots, crudSlots, moduleLabel, moduleId) : ''}
-
-  // @stage-gap-append
-});
+    // 一用例一脚本：按 glue 用例逐条渲染 CRUD 测试，保证报告结果数 == 用例数。
+    const componentForLabel = (label) => crudSlots.searchConditions.find((c) => c.label === label)?.component ?? 'input';
+    const crudCases = (glueCases ?? []).flatMap((testCase) => {
+        const parsed = parseCrudCaseTitle(testCase.title);
+        return parsed ? [{ ...testCase, ...parsed }] : [];
+    });
+    // 子表用例标题形如「窗口信息-新增行」，export 用例以「 export」结尾，均不参与主表 CRUD 映射。
+    const childGridTitles = new Set((childGridSlots ?? []).flatMap((slot) => [
+        `${slot.label}-新增行`,
+        `${slot.label}-编辑行`,
+        `${slot.label}-删除行`,
+        `${slot.label}-必填校验`,
+    ]));
+    const unmappable = (glueCases ?? []).filter((testCase) => !parseCrudCaseTitle(testCase.title) &&
+        !testCase.title.endsWith(' export') &&
+        !childGridTitles.has(testCase.title));
+    if (unmappable.length > 0) {
+        throw new Error(`glue 用例标题无法映射到 CRUD 阶段：${unmappable.map((c) => `${c.caseId}(${c.title})`).join('、')}。` +
+            '期望格式「<模块名> create|read|update|delete（<查询主键>）」。');
+    }
+    const crudCaseTests = renderCrudCaseTests(crudCases, { moduleId, moduleLabel, componentForLabel });
+    const exportCaseRef = (glueCases ?? []).find((testCase) => testCase.title.endsWith(' export'));
+    return `import { test, expect, type Page } from '@playwright/test';
+import { loadCredentials, StagePath, type Credential } from '@epoint-testtech/stage-core';
+import { CrudPage, ExportPage, LoginPage${childGridImport}, type CrudFlowSlots, type ExportFlowSlots, type CrudWorkflowData } from '../../skeletons';
+import { GlueWorkflowRecorder, runRecordedWorkflow, type GlueWorkflowRecordInput } from '../../report/glue-report';
+
+test.describe(${singleQuoted(suiteTitle)}, () => {
+  const directListUrl = ${singleQuoted(directUrl)};
+  const credentialsPath = \`\${StagePath.projectRootDirPath}/src/tests/${requirementName}/credentials.json5\`;
+  const primaryRole = ${singleQuoted(primaryRole)};
+  const crudSlots: CrudFlowSlots = ${renderStageSkeletonCrudSlots(crudSlots)};
+  const exportSlots = ${renderExportSlotsFromSlot(exportSlot, crudSlots.frames.listIframeSrcKeyword)};
+${childGridSlots?.length ? `  const childGridSlots: ChildGridFlowSlots[] = ${renderChildGridSlots(childGridSlots)};` : ''}
+
+  const recorder = new GlueWorkflowRecorder({
+    outputRoot: StagePath.projectRootDirPath,
+    moduleId: ${singleQuoted(moduleId)},
+    moduleName: ${singleQuoted(moduleLabel)},
+    suiteTitle: ${singleQuoted(suiteTitle)},
+    generatedSpecFile: import.meta.url,
+  });
+
+  test.beforeAll(async ({ browser }) => {
+    recorder.updateEnvironment({
+      browserName: browser.browserType().name(),
+      browserVersion: browser.version(),
+    });
+  });
+
+  test.afterAll(() => {
+    recorder.writeReport();
+  });
+
+  function resolveCredential(role: string): Credential {
+    const [credential] = loadCredentials(credentialsPath, role);
+    if (!credential) {
+      throw new Error(\`credentials.json5 中未找到角色: \${role}\`);
+    }
+    return credential;
+  }
+
+  function applyLoginCredential(credential: Credential): void {
+    process.env.LOGIN_SYSTEM_URL = credential.url;
+    process.env.LOGIN_USERNAME = credential.username;
+    process.env.LOGIN_PASSWORD = credential.password;
+  }
+
+  async function openModule(page: Page): Promise<void> {
+    applyLoginCredential(resolveCredential(primaryRole));
+    const loginPage = new LoginPage(page);
+    await loginPage.login();
+    await loginPage.gotoDirectUrl(directListUrl);
+  }
+
+  function workflowMeta(
+    input: Omit<
+      GlueWorkflowRecordInput,
+      'moduleId' | 'executionSource' | 'evidenceSources' | 'evidenceRefs' | 'playwrightSuiteTitle'
+    >,
+  ): GlueWorkflowRecordInput {
+    return {
+      moduleId: ${singleQuoted(moduleId)},
+      executionSource: 'glue_code' as const,
+      evidenceSources: ['crud_flow_slots'],
+      evidenceRefs: [],
+      playwrightSuiteTitle: ${singleQuoted(suiteTitle)},
+      ...input,
+    };
+  }
+${crudCaseTests}
+
+  test(${singleQuoted(exportCaseRef ? `${exportCaseRef.caseId} ${exportCaseRef.title}` : `Export：导出${moduleLabel}列表并校验下载文件`)}, async ({ page }, testInfo) => {
+    test.slow();
+
+    await runRecordedWorkflow(
+      recorder,
+      workflowMeta({
+        workflowId: ${singleQuoted(exportCaseRef ? `${moduleId}.${exportCaseRef.caseId}` : `${moduleId}.export`)},
+        workflowKind: 'export',
+        workflowName: ${singleQuoted(exportCaseRef ? exportCaseRef.title : `导出${moduleLabel}列表`)},
+        businessIntent: '在列表页触发全部导出，验证导出弹框可驱动并成功下载数据文件。',
+        elementActions: ['点击列表页数据导出按钮打开导出弹框', '在导出弹框选择「全部」并确认导出', '等待 download 事件并断言下载文件存在且非空'],
+        assertionExpectation: '导出操作应触发下载，落盘文件存在且大小大于 0。',
+        playwrightTestTitle: ${singleQuoted(exportCaseRef ? `${exportCaseRef.caseId} ${exportCaseRef.title}` : `Export：导出${moduleLabel}列表并校验下载文件`)},
+      }),
+      async () => {
+        await openModule(page);
+        const exportPage = new ExportPage(page, exportSlots);
+        await exportPage.runExportWorkflow(testInfo);
+      },
+    );
+  });
+
+${childGridSlots?.length ? renderChildGridTests(childGridSlots, crudSlots, moduleLabel, moduleId, glueCases) : ''}
+
+  // @stage-gap-append
+});
 `;
 }
 /**