worsoft-frontend-codegen-local-mcp 0.1.83 → 0.1.85

package/README.md

@@ -9,6 +9,8 @@ This MCP generates Worsoft frontend files from structured JSON metadata.
 - local template rendering
 - single-table runtime generation
 - master-child runtime generation with explicit `children[]`
+- single tree runtime generation with `listByParentId`
+- left-tree-right-list runtime generation with explicit `levels[]`
 - optional write-to-disk
 
 ## Current Inputs
@@ -107,6 +109,8 @@ node plugins/worsoft-codegen-local/smoke_test_mcp.js --scenario single_dialog
 node plugins/worsoft-codegen-local/smoke_test_mcp.js --scenario dict_single
 node plugins/worsoft-codegen-local/smoke_test_mcp.js --scenario master
 node plugins/worsoft-codegen-local/smoke_test_mcp.js --scenario dict_multi
+node plugins/worsoft-codegen-local/smoke_test_mcp.js --scenario single_tree
+node plugins/worsoft-codegen-local/smoke_test_mcp.js --scenario tree_left_list
 ```
 
 Optional overrides:
@@ -160,6 +164,10 @@ Each module must include:
 - `apiPath`
 - `fields`
 
+For `tree_left_list`, level 1 is rendered as the left lazy tree and level 2 is rendered as the right linked list.
+The left module may pass `treeParentField` when the parent field is not `parentId`.
+When the same physical table is split into different logical regions, pass `moduleKey` to keep the UI state independent.
+
 ## Current Outputs
 
 - `src/views/<module>/<function>/index.vue`
@@ -180,6 +188,8 @@ Declared styles:
 - `single_table_dialog`
 - `master_child_jump`
 - `multi_level_dict`
+- `single_tree_table`
+- `tree_left_list`
 
 ## Notes
 

package/assets/style-catalog.json

@@ -90,5 +90,51 @@
         "menuSql": "menu.sql.tpl"
       }
     }
+  },
+  "single_tree_table": {
+    "id": "single_tree_table",
+    "label": "单树形结构模板",
+    "description": "单表树形字典页面，使用 SchemaTreeTable 和 listByParentId 懒加载子节点。",
+    "templateFiles": {
+      "api": "api.md",
+      "options": "options.md",
+      "form": "表单V2025001.md",
+      "list": "树形表格V2025001.md",
+      "menuSql": "权限菜单V2025001.md"
+    },
+    "runtime": {
+      "supported": true,
+      "templateDir": "assets/templates/single_tree_table",
+      "files": {
+        "api": "api.tpl",
+        "options": "options.tpl",
+        "form": "form.tpl",
+        "list": "index.tpl",
+        "menuSql": "menu.sql.tpl"
+      }
+    }
+  },
+  "tree_left_list": {
+    "id": "tree_left_list",
+    "label": "左树右列表模板",
+    "description": "左侧树形表格懒加载，右侧列表根据左侧当前选中节点联动查询。",
+    "templateFiles": {
+      "api": "api.md",
+      "options": "options.md",
+      "form": "表单V2025001.md",
+      "list": "左树右列表V2025001.md",
+      "menuSql": "权限菜单V2025001.md"
+    },
+    "runtime": {
+      "supported": true,
+      "templateDir": "assets/templates/tree_left_list",
+      "files": {
+        "api": "api.tpl",
+        "options": "options.tpl",
+        "form": "form.tpl",
+        "list": "index.tpl",
+        "menuSql": "menu.sql.tpl"
+      }
+    }
   }
 }

package/assets/templates/ledger_master_child_jump/form.tpl

@@ -47,7 +47,7 @@ import { allDictTypes, childFieldGroups, dataMasterEntity } from './options';
 const dictRefs = useDict(...allDictTypes);
 // 国际化方法
 const { t } = useI18n();
-// 子表表格组件：仅用于只读展示，模板中 hide-add/hide-delete 固定启用
+// 子表表格组件：模板默认保留新增/删除按钮，后续可由任务拆分按业务规则移除
 const scFormTable = defineAsyncComponent(() => import('/@/components/FormTable/index.vue'));
 // 当前路由信息
 const route = useRoute();

package/assets/templates/ledger_master_child_jump/index.tpl

@@ -1,28 +1,32 @@
+<!-- 功能名称：{{FEATURE_TITLE}} -->
 <template>
-  <!-- 页面布局：{{FEATURE_TITLE}}主子表台账列表页，只提供查询和查看能力 -->
+  <!-- 页面布局：{{FEATURE_TITLE}}主子表台账列表页 -->
   <div class="layout-padding">
     <div class="layout-padding-auto layout-padding-view flex h-full flex-col">
-      <!-- 台账工具栏：保留关键字查询、重置、高级查询和刷新，隐藏新增、导入、删除、导出 -->
+      <!-- 列表工具栏：搜索、重置、高级查询、导出和刷新，台账页不提供新增、导入、删除入口 -->
       <SchemaListToolbar
         v-bind="toolbarProps"
         @update:keyword="state.queryForm.smartVal = $event"
         @query="handleToolbarQuery"
         @reset="handleToolbarReset"
         @custom-query-confirm="handleToolbarCustomQueryConfirm"
+        @export="handleToolbarExport"
         @refresh="handleToolbarRefresh"
       />
 
-      <!-- 台账列表表格：展示主表列表数据和行内查看按钮，不提供勾选批量操作 -->
+      <!-- 列表表格：展示{{FEATURE_TITLE}}主表台账数据、分页、排序和行内查看操作 -->
       <SchemaListTable
         v-bind="tableProps"
         row-id-key="{{PK_ATTR}}"
         :action-column-width="100"
+        @row-current-change="handleTableRowCurrentChange"
         @sort-change="handleTableSortChange"
         @size-change="handleTableSizeChange"
         @current-change="handleTableCurrentChange"
       >
-        <!-- 行操作按钮：主子表台账只允许查看详情 -->
+        <!-- 行操作按钮：主子表台账页只允许查看详情 -->
         <template #actions="{ row }">
+          <!-- 查看{{FEATURE_TITLE}}主子表台账详情 -->
           <el-button text type="primary" icon="view" v-auth="'{{PERMISSION_PREFIX}}_view'" @click="handleDetail(row.{{PK_ATTR}})">{{ t('common.viewBtn') }}</el-button>
         </template>
       </SchemaListTable>
@@ -31,13 +35,15 @@
 </template>
 
 <script setup lang="ts" name="system{{CLASS_NAME}}">
-// 台账列表接口：只消费分页查询能力
+// 列表接口：台账页只消费分页查询能力
 import { fetchList } from '/@/api/{{API_MODULE_PATH}}';
 // 字典数据加载
 import { useDict } from '/@/hooks/dict';
-// 列表字段元数据能力
+// 列表页字段元数据能力
 import { useCrudPageMeta } from '/@/hooks/useCrudPageMeta';
-// 列表页查询、分页、排序状态管理
+// 列表当前行选中保持能力
+import { useTableCurrentRow } from '/@/hooks/useTableCurrentRow';
+// 列表页查询、分页和排序状态管理
 import { useSchemaListQuery } from '/@/hooks/useSchemaListQuery';
 // 统一列表工具栏组件
 import SchemaListToolbar from '/@/components/schema-list/SchemaListToolbar.vue';
@@ -54,19 +60,26 @@ const dictRefs = useDict(...allDictTypes);
 const { t } = useI18n();
 // 路由跳转能力
 const router = useRouter();
+// 当前高亮行
 
-// 统一管理台账列表查询、分页和排序
-const { state, getDataList, currentChangeHandle, sizeChangeHandle, sortChangeHandle, tableStyle, resetQueryForm } = useSchemaListQuery({
+// 统一管理主子表台账列表查询、分页、排序和导出
+const { state, getDataList, currentChangeHandle, sizeChangeHandle, sortChangeHandle, tableStyle, exportExcel: runExportExcel, resetQueryForm } = useSchemaListQuery({
   schema: crudSchema,
   pageList: fetchList,
   exportUrl: '/{{API_PATH}}/export',
   exportFileName: '{{FUNCTION_NAME}}.xlsx',
 });
 
+// 统一处理台账列表加载后的首行选中，以及刷新后的当前行保持
+const { currentRowKey, handleCurrentChange } = useTableCurrentRow(
+  computed(() => state.dataList),
+  '{{PK_ATTR}}'
+);
+
 // 提供字段标签、字典选项和查询区描述
 const { resolveLabel, getDictOptions, visibleTableColumns, searchKeywordTooltip, queryableDictFields } = useCrudPageMeta(dataMasterEntity, dictRefs);
 
-// 高级查询字典字段配置
+// 自定义查询区的字典字段配置
 const queryableDictOptions = computed(() =>
   queryableDictFields.value.map((field) => ({
     ...field,
@@ -85,7 +98,7 @@ const tableColumns = computed(() =>
   }))
 );
 
-// 台账工具栏透传属性：显式关闭新增、导入、删除和导出入口
+// 工具栏透传属性：显式关闭新增、导入、删除入口，保留导出
 const toolbarProps = computed(() => ({
   keyword: state.queryForm.smartVal,
   searchPlaceholder: searchKeywordTooltip.value,
@@ -95,10 +108,10 @@ const toolbarProps = computed(() => ({
   showAdd: false,
   showImport: false,
   showDelete: false,
-  exportPermission: false,
+  exportPermission: '{{PERMISSION_PREFIX}}_export',
 }));
 
-// 台账表格透传属性：关闭勾选列，仅保留查看操作列
+// 表格透传属性：关闭勾选列，仅保留查看操作列和当前行高亮
 const tableProps = computed(() => ({
   data: state.dataList,
   loading: !!state.loading,
@@ -106,16 +119,24 @@ const tableProps = computed(() => ({
   pagination: state.pagination,
   tableStyle,
   showSelection: false,
+  currentRowKey: currentRowKey.value,
+  highlightCurrentRow: true,
 }));
 
-// 详情页路由路径
+// 列表刷新后恢复当前行：优先恢复原选中行，不存在时选中第一行
+// 表单页路由路径
 const getFormPath = () => '/{{VIEW_MODULE_PATH}}/form';
 
-// 跳转台账详情页，固定 detail=1
+// 跳转主子表台账详情页，固定 detail=1
 const handleDetail = (id: string) => {
   router.push({ path: getFormPath(), query: { id, detail: '1', tagsViewName: t('common.viewBtn') } });
 };
 
+// 导出台账数据
+const exportExcel = () => {
+  runExportExcel([]);
+};
+
 // 应用高级查询条件
 const handleQueryFilterConfirm = (values: Record<string, any>) => {
   queryableDictFields.value.forEach((field) => {
@@ -150,11 +171,21 @@ const handleToolbarCustomQueryConfirm = (payload: { values: Record<string, any>
   handleQueryFilterConfirm(payload.values);
 };
 
+// 工具栏导出事件
+const handleToolbarExport = () => {
+  exportExcel();
+};
+
 // 工具栏刷新事件
 const handleToolbarRefresh = () => {
   getDataList();
 };
 
+// 表格当前行变化事件
+const handleTableRowCurrentChange = (payload: { row: any }) => {
+  handleCurrentChange(payload);
+};
+
 // 表格排序事件
 const handleTableSortChange = (payload: { raw: any }) => {
   sortChangeHandle(payload.raw);

package/assets/templates/ledger_master_child_jump/menu.sql.tpl

@@ -3,13 +3,16 @@
 -- Generated by worsoft-codegen-local on {{GENERATED_AT}}
 
 -- 主子表台账列表菜单：只读台账入口
-insert into sys_menu (menu_id, parent_id, path, permission, menu_type, icon, del_flag, create_time, sort_order, update_time, name, tenant_id)
-values ({{MENU_BASE_ID}}, '-1', '/{{MENU_ROUTE_PATH}}/index', '', '0', 'icon-bangzhushouji', '0', null, '8', null, '{{TABLE_COMMENT}}管理', 1);
+insert into sys_menu (menu_id, parent_id, path, permission, menu_type, icon, del_flag, create_time, sort_order, update_time, name, tenant_id, bill_code)
+values ({{MENU_BASE_ID}}, '-1', '/{{MENU_ROUTE_PATH}}/index', '', '0', 'icon-bangzhushouji', '0', null, '8', null, '{{TABLE_COMMENT}}管理', 1, '{{BILL_CODE}}');
 
 -- 主子表台账详情路由：隐藏菜单，用于列表页查看跳转
-insert into sys_menu (menu_id, parent_id, path, permission, menu_type, icon, visible, del_flag, create_time, sort_order, update_time, name, tenant_id)
-values ({{MENU_BASE_ID_PLUS_6}}, '-1', '/{{MENU_ROUTE_PATH}}/form', '', '0', 'icon-biaodan', '0', '0', null, '9', null, '{{TABLE_COMMENT}}详情', 1);
+insert into sys_menu (menu_id, parent_id, path, permission, menu_type, icon, visible, del_flag, create_time, sort_order, update_time, name, tenant_id, bill_code)
+values ({{MENU_BASE_ID_PLUS_6}}, '-1', '/{{MENU_ROUTE_PATH}}/form', '', '0', 'icon-biaodan', '0', '0', null, '9', null, '{{TABLE_COMMENT}}详情', 1, '{{BILL_CODE}}');
 
--- 台账查看权限：不生成新增、编辑、删除等操作权限
-insert into sys_menu (menu_id, parent_id, permission, menu_type, path, icon, del_flag, create_time, sort_order, update_time, name, tenant_id)
-values ({{MENU_BASE_ID_PLUS_1}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_view', '1', null, '1', '0', null, '0', null, '{{TABLE_COMMENT}}查看', 1);
+-- 台账操作权限：只生成查看、导出权限，不生成新增、编辑、删除等操作权限
+insert into sys_menu (menu_id, parent_id, permission, menu_type, path, icon, del_flag, create_time, sort_order, update_time, name, tenant_id, bill_code)
+values ({{MENU_BASE_ID_PLUS_1}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_view', '1', null, '1', '0', null, '0', null, '{{TABLE_COMMENT}}查看', 1, '{{BILL_CODE}}');
+
+insert into sys_menu (menu_id, parent_id, permission, menu_type, path, icon, del_flag, create_time, sort_order, update_time, name, tenant_id, bill_code)
+values ({{MENU_BASE_ID_PLUS_5}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_export', '1', null, '1', '0', null, '4', null, '导入导出', 1, '{{BILL_CODE}}');

package/assets/templates/ledger_single_table_jump/index.tpl

@@ -1,28 +1,32 @@
+<!-- 功能名称：{{FEATURE_TITLE}} -->
 <template>
-  <!-- 页面布局：{{FEATURE_TITLE}}台账列表页，只提供查询和查看能力 -->
+  <!-- 页面布局：{{FEATURE_TITLE}}台账列表页 -->
   <div class="layout-padding">
     <div class="layout-padding-auto layout-padding-view flex h-full flex-col">
-      <!-- 台账工具栏：保留关键字查询、重置、高级查询和刷新，隐藏新增、导入、删除、导出 -->
+      <!-- 列表工具栏：搜索、重置、高级查询、导出和刷新，台账页不提供新增、导入、删除入口 -->
       <SchemaListToolbar
         v-bind="toolbarProps"
         @update:keyword="state.queryForm.smartVal = $event"
         @query="handleToolbarQuery"
         @reset="handleToolbarReset"
         @custom-query-confirm="handleToolbarCustomQueryConfirm"
+        @export="handleToolbarExport"
         @refresh="handleToolbarRefresh"
       />
 
-      <!-- 台账列表表格：展示列表数据和行内查看按钮，不提供勾选批量操作 -->
+      <!-- 列表表格：展示{{FEATURE_TITLE}}台账数据、分页、排序和行内查看操作 -->
       <SchemaListTable
         v-bind="tableProps"
         row-id-key="{{PK_ATTR}}"
         :action-column-width="100"
+        @row-current-change="handleTableRowCurrentChange"
         @sort-change="handleTableSortChange"
         @size-change="handleTableSizeChange"
         @current-change="handleTableCurrentChange"
       >
-        <!-- 行操作按钮：台账只允许查看详情 -->
+        <!-- 行操作按钮：台账页只允许查看详情 -->
         <template #actions="{ row }">
+          <!-- 查看{{FEATURE_TITLE}}台账详情 -->
           <el-button text type="primary" icon="view" v-auth="'{{PERMISSION_PREFIX}}_view'" @click="handleDetail(row.{{PK_ATTR}})">{{ t('common.viewBtn') }}</el-button>
         </template>
       </SchemaListTable>
@@ -31,13 +35,15 @@
 </template>
 
 <script setup lang="ts" name="system{{CLASS_NAME}}">
-// 台账列表接口：只消费分页查询能力
+// 列表接口：台账页只消费分页查询能力
 import { fetchList } from '/@/api/{{API_MODULE_PATH}}';
 // 字典数据加载
 import { useDict } from '/@/hooks/dict';
-// 列表字段元数据能力
+// 列表页字段元数据能力
 import { useCrudPageMeta } from '/@/hooks/useCrudPageMeta';
-// 列表页查询、分页、排序状态管理
+// 列表当前行选中保持能力
+import { useTableCurrentRow } from '/@/hooks/useTableCurrentRow';
+// 列表页查询、分页和排序状态管理
 import { useSchemaListQuery } from '/@/hooks/useSchemaListQuery';
 // 统一列表工具栏组件
 import SchemaListToolbar from '/@/components/schema-list/SchemaListToolbar.vue';
@@ -54,19 +60,26 @@ const dictRefs = useDict(...allDictTypes);
 const { t } = useI18n();
 // 路由跳转能力
 const router = useRouter();
+// 当前高亮行
 
-// 统一管理台账列表查询、分页和排序
-const { state, getDataList, currentChangeHandle, sizeChangeHandle, sortChangeHandle, tableStyle, resetQueryForm } = useSchemaListQuery({
+// 统一管理台账列表查询、分页、排序和导出
+const { state, getDataList, currentChangeHandle, sizeChangeHandle, sortChangeHandle, tableStyle, exportExcel: runExportExcel, resetQueryForm } = useSchemaListQuery({
   schema: crudSchema,
   pageList: fetchList,
   exportUrl: '/{{API_PATH}}/export',
   exportFileName: '{{FUNCTION_NAME}}.xlsx',
 });
 
+// 统一处理台账列表加载后的首行选中，以及刷新后的当前行保持
+const { currentRowKey, handleCurrentChange } = useTableCurrentRow(
+  computed(() => state.dataList),
+  '{{PK_ATTR}}'
+);
+
 // 提供字段标签、字典选项和查询区描述
 const { resolveLabel, getDictOptions, visibleTableColumns, searchKeywordTooltip, queryableDictFields } = useCrudPageMeta(dataMasterEntity, dictRefs);
 
-// 高级查询字典字段配置
+// 自定义查询区的字典字段配置
 const queryableDictOptions = computed(() =>
   queryableDictFields.value.map((field) => ({
     ...field,
@@ -85,7 +98,7 @@ const tableColumns = computed(() =>
   }))
 );
 
-// 台账工具栏透传属性：显式关闭新增、导入、删除和导出入口
+// 工具栏透传属性：显式关闭新增、导入、删除入口，保留导出
 const toolbarProps = computed(() => ({
   keyword: state.queryForm.smartVal,
   searchPlaceholder: searchKeywordTooltip.value,
@@ -95,10 +108,10 @@ const toolbarProps = computed(() => ({
   showAdd: false,
   showImport: false,
   showDelete: false,
-  exportPermission: false,
+  exportPermission: '{{PERMISSION_PREFIX}}_export',
 }));
 
-// 台账表格透传属性：关闭勾选列，仅保留查看操作列
+// 表格透传属性：关闭勾选列，仅保留查看操作列和当前行高亮
 const tableProps = computed(() => ({
   data: state.dataList,
   loading: !!state.loading,
@@ -106,9 +119,12 @@ const tableProps = computed(() => ({
   pagination: state.pagination,
   tableStyle,
   showSelection: false,
+  currentRowKey: currentRowKey.value,
+  highlightCurrentRow: true,
 }));
 
-// 详情页路由路径
+// 列表刷新后恢复当前行：优先恢复原选中行，不存在时选中第一行
+// 表单页路由路径
 const getFormPath = () => '/{{VIEW_MODULE_PATH}}/form';
 
 // 跳转台账详情页，固定 detail=1
@@ -116,6 +132,11 @@ const handleDetail = (id: string) => {
   router.push({ path: getFormPath(), query: { id, detail: '1', tagsViewName: t('common.viewBtn') } });
 };
 
+// 导出台账数据
+const exportExcel = () => {
+  runExportExcel([]);
+};
+
 // 应用高级查询条件
 const handleQueryFilterConfirm = (values: Record<string, any>) => {
   queryableDictFields.value.forEach((field) => {
@@ -150,11 +171,21 @@ const handleToolbarCustomQueryConfirm = (payload: { values: Record<string, any>
   handleQueryFilterConfirm(payload.values);
 };
 
+// 工具栏导出事件
+const handleToolbarExport = () => {
+  exportExcel();
+};
+
 // 工具栏刷新事件
 const handleToolbarRefresh = () => {
   getDataList();
 };
 
+// 表格当前行变化事件
+const handleTableRowCurrentChange = (payload: { row: any }) => {
+  handleCurrentChange(payload);
+};
+
 // 表格排序事件
 const handleTableSortChange = (payload: { raw: any }) => {
   sortChangeHandle(payload.raw);

package/assets/templates/ledger_single_table_jump/menu.sql.tpl

@@ -3,13 +3,16 @@
 -- Generated by worsoft-codegen-local on {{GENERATED_AT}}
 
 -- 台账列表菜单：只读台账入口
-insert into sys_menu (menu_id, parent_id, path, permission, menu_type, icon, del_flag, create_time, sort_order, update_time, name, tenant_id)
-values ({{MENU_BASE_ID}}, '-1', '/{{MENU_ROUTE_PATH}}/index', '', '0', 'icon-bangzhushouji', '0', null, '8', null, '{{TABLE_COMMENT}}管理', 1);
+insert into sys_menu (menu_id, parent_id, path, permission, menu_type, icon, del_flag, create_time, sort_order, update_time, name, tenant_id, bill_code)
+values ({{MENU_BASE_ID}}, '-1', '/{{MENU_ROUTE_PATH}}/index', '', '0', 'icon-bangzhushouji', '0', null, '8', null, '{{TABLE_COMMENT}}管理', 1, '{{BILL_CODE}}');
 
 -- 台账详情路由：隐藏菜单，用于列表页查看跳转
-insert into sys_menu (menu_id, parent_id, path, permission, menu_type, icon, visible, del_flag, create_time, sort_order, update_time, name, tenant_id)
-values ({{MENU_BASE_ID_PLUS_6}}, '-1', '/{{MENU_ROUTE_PATH}}/form', '', '0', 'icon-biaodan', '0', '0', null, '9', null, '{{TABLE_COMMENT}}详情', 1);
+insert into sys_menu (menu_id, parent_id, path, permission, menu_type, icon, visible, del_flag, create_time, sort_order, update_time, name, tenant_id, bill_code)
+values ({{MENU_BASE_ID_PLUS_6}}, '-1', '/{{MENU_ROUTE_PATH}}/form', '', '0', 'icon-biaodan', '0', '0', null, '9', null, '{{TABLE_COMMENT}}详情', 1, '{{BILL_CODE}}');
 
--- 台账查看权限：不生成新增、编辑、删除等操作权限
-insert into sys_menu (menu_id, parent_id, permission, menu_type, path, icon, del_flag, create_time, sort_order, update_time, name, tenant_id)
-values ({{MENU_BASE_ID_PLUS_1}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_view', '1', null, '1', '0', null, '0', null, '{{TABLE_COMMENT}}查看', 1);
+-- 台账操作权限：只生成查看、导出权限，不生成新增、编辑、删除等操作权限
+insert into sys_menu (menu_id, parent_id, permission, menu_type, path, icon, del_flag, create_time, sort_order, update_time, name, tenant_id, bill_code)
+values ({{MENU_BASE_ID_PLUS_1}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_view', '1', null, '1', '0', null, '0', null, '{{TABLE_COMMENT}}查看', 1, '{{BILL_CODE}}');
+
+insert into sys_menu (menu_id, parent_id, permission, menu_type, path, icon, del_flag, create_time, sort_order, update_time, name, tenant_id, bill_code)
+values ({{MENU_BASE_ID_PLUS_5}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_export', '1', null, '1', '0', null, '4', null, '导入导出', 1, '{{BILL_CODE}}');

package/assets/templates/master_child_jump/form.tpl

@@ -131,6 +131,10 @@ const resetFormState = () => {
   nextTick(() => {
     dataFormRef.value?.resetFields();
 {{CHILD_RESET_LISTS}}
+    Object.keys(selectedChildRowsMap).forEach((key) => {
+      selectedChildRowsMap[key] = [];
+      childTableRefMap[key]?.clearSelection?.();
+    });
   });
 };
 
@@ -188,6 +192,43 @@ const deleteChild = (_obj: Record<string, any>, _childPkAttr: string) => {
 };
 
 // 页面挂载后初始化数据
+// 子表表格引用集合，用于外部新增按钮调用表格新增方法
+const childTableRefMap = reactive<Record<string, any>>({});
+// 子表勾选行集合，用于外部删除按钮删除已选明细
+const selectedChildRowsMap = reactive<Record<string, Record<string, any>[]>>({});
+
+const setChildTableRef = (childKey: string, el: any) => {
+  if (el) childTableRefMap[childKey] = el;
+};
+
+const getSelectedChildRows = (childKey: string) => selectedChildRowsMap[childKey] || [];
+
+const handleChildSelectionChange = (childKey: string, rows: Record<string, any>[]) => {
+  selectedChildRowsMap[childKey] = rows || [];
+};
+
+// 通过子表外部工具按钮新增一行，表格内部不显示新增入口
+const handleAddChild = (childKey: string) => {
+  if (detail.value) return;
+  childTableRefMap[childKey]?.pushRow?.();
+};
+
+// 通过子表外部工具按钮删除已勾选行，表格内部不显示删除入口
+const handleDeleteSelectedChild = (childKey: string, childPkAttr: string) => {
+  if (detail.value) return;
+
+  const selectedRows = getSelectedChildRows(childKey);
+  if (!selectedRows.length) return;
+
+  const selectedSet = new Set(selectedRows);
+  const childRows = ((form as Record<string, any>)[childKey] || []) as Record<string, any>[];
+  const deletedRows = childRows.filter((row) => selectedSet.has(row));
+  (form as Record<string, any>)[childKey] = childRows.filter((row) => !selectedSet.has(row));
+  selectedChildRowsMap[childKey] = [];
+  childTableRefMap[childKey]?.clearSelection?.();
+  deletedRows.forEach((row) => deleteChild(row, childPkAttr));
+};
+
 onMounted(() => {
   initPage();
 });

package/assets/templates/master_child_jump/index.tpl

@@ -22,6 +22,7 @@
         v-bind="tableProps"
         row-id-key="{{PK_ATTR}}"
         @selection-change="handleTableSelectionChange"
+        @row-current-change="handleTableRowCurrentChange"
         @sort-change="handleTableSortChange"
         @size-change="handleTableSizeChange"
         @current-change="handleTableCurrentChange"
@@ -32,10 +33,10 @@
           <el-button text type="primary" icon="view" v-auth="'{{PERMISSION_PREFIX}}_view'" @click="handleDetail(row.{{PK_ATTR}})">{{ t('common.viewBtn') }}</el-button>
           <!-- 编辑{{FEATURE_TITLE}}：业务单据编辑态控制按需生效 -->
           <el-button{{BUSINESS_EDIT_IF}} icon="edit-pen" text type="primary" v-auth="'{{PERMISSION_PREFIX}}_edit'" @click="handleEdit(row.{{PK_ATTR}})">{{ t('common.editBtn') }}</el-button>
-          <!-- 提交{{FEATURE_TITLE}} -->
-          <el-button text type="primary" icon="check" @click="handleQuickAction(row, 'submit')">{{ commonActionLabel('submit') }}</el-button>
-          <!-- 流转{{FEATURE_TITLE}} -->
-          <el-button text type="success" icon="position" @click="handleQuickAction(row, 'flow')">{{ commonActionLabel('flow') }}</el-button>
+          <!-- 提交{{FEATURE_TITLE}}：仅在编辑中状态时可用 -->
+          <el-button{{BUSINESS_SUBMIT_IF}} text type="primary" icon="check" @click="handleQuickAction(row, 'submit')">{{ commonActionLabel('submit') }}</el-button>
+          <!-- 流转{{FEATURE_TITLE}}：仅在编辑中状态时可用 -->
+          <el-button{{BUSINESS_FLOW_IF}} text type="success" icon="position" @click="handleQuickAction(row, 'flow')">{{ commonActionLabel('flow') }}</el-button>
           <!-- 删除{{FEATURE_TITLE}} -->
           <el-button{{BUSINESS_DELETE_IF}} icon="delete" text type="primary" v-auth="'{{PERMISSION_PREFIX}}_del'" @click="handleDelete([row.{{PK_ATTR}}]{{BUSINESS_DELETE_ROW_ARG}})">{{ t('common.delBtn') }}</el-button>
         </template>
@@ -56,6 +57,8 @@ import { useMessage, useMessageBox } from '/@/hooks/message';
 import { useDict } from '/@/hooks/dict';
 // 列表页字段元数据能力
 import { useCrudPageMeta } from '/@/hooks/useCrudPageMeta';
+// 列表当前行选中保持能力
+import { useTableCurrentRow } from '/@/hooks/useTableCurrentRow';
 // 列表页查询与分页状态
 import { useSchemaListQuery } from '/@/hooks/useSchemaListQuery';
 // 统一列表工具栏组件
@@ -92,6 +95,12 @@ const { state, getDataList, currentChangeHandle, sizeChangeHandle, sortChangeHan
   exportFileName: '{{FUNCTION_NAME}}.xlsx',
 });
 
+// 统一处理列表加载后的首行选中，以及刷新后的当前行保持
+const { currentRowKey, handleCurrentChange: handleTableRowCurrentChange } = useTableCurrentRow(
+  computed(() => state.dataList),
+  '{{PK_ATTR}}'
+);
+
 // 提供字段标签、字典选项和查询区描述
 const { resolveLabel, getDictOptions, commonActionLabel, visibleTableColumns, searchKeywordTooltip, queryableDictFields } = useCrudPageMeta(dataMasterEntity, dictRefs);
 
@@ -132,6 +141,8 @@ const tableProps = computed(() => ({
   columns: tableColumns.value,
   pagination: state.pagination,
   tableStyle,
+  currentRowKey: currentRowKey.value,
+  highlightCurrentRow: true,
 }));
 
 // 表单页路由路径

package/assets/templates/master_child_jump/menu.sql.tpl

@@ -2,25 +2,25 @@
 -- Suggested default parent_id: -1
 -- Generated by worsoft-codegen-local on {{GENERATED_AT}}
 
-insert into sys_menu (menu_id, parent_id, path, permission, menu_type, icon, del_flag, create_time, sort_order, update_time, name, tenant_id)
-values ({{MENU_BASE_ID}}, '-1', '/{{MENU_ROUTE_PATH}}/index', '', '0', 'icon-bangzhushouji', '0', null, '8', null, '{{TABLE_COMMENT}}管理', 1);
+insert into sys_menu (menu_id, parent_id, path, permission, menu_type, icon, del_flag, create_time, sort_order, update_time, name, tenant_id, bill_code)
+values ({{MENU_BASE_ID}}, '-1', '/{{MENU_ROUTE_PATH}}/index', '', '0', 'icon-bangzhushouji', '0', null, '8', null, '{{TABLE_COMMENT}}管理', 1, '{{BILL_CODE}}');
 
 -- Form route SQL for jump-based pages. Hidden from sidebar, used by list page add/edit/view navigation.
 -- Keep it as a sibling of the list page, not a child of the list page, because index.vue has no nested router-view.
-insert into sys_menu (menu_id, parent_id, path, permission, menu_type, icon, visible, del_flag, create_time, sort_order, update_time, name, tenant_id)
-values ({{MENU_BASE_ID_PLUS_6}}, '-1', '/{{MENU_ROUTE_PATH}}/form', '', '0', 'icon-biaodan', '0', '0', null, '9', null, '{{TABLE_COMMENT}}表单', 1);
+insert into sys_menu (menu_id, parent_id, path, permission, menu_type, icon, visible, del_flag, create_time, sort_order, update_time, name, tenant_id, bill_code{{BUSINESS_FORM_KEEP_ALIVE_COLUMN}})
+values ({{MENU_BASE_ID_PLUS_6}}, '-1', '/{{MENU_ROUTE_PATH}}/form', '', '0', 'icon-biaodan', '0', '0', null, '9', null, '{{TABLE_COMMENT}}表单', 1, '{{BILL_CODE}}'{{BUSINESS_FORM_KEEP_ALIVE_VALUE}});
 
-insert into sys_menu (menu_id, parent_id, permission, menu_type, path, icon, del_flag, create_time, sort_order, update_time, name, tenant_id)
-values ({{MENU_BASE_ID_PLUS_1}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_view', '1', null, '1', '0', null, '0', null, '{{TABLE_COMMENT}}查看', 1);
+insert into sys_menu (menu_id, parent_id, permission, menu_type, path, icon, del_flag, create_time, sort_order, update_time, name, tenant_id, bill_code)
+values ({{MENU_BASE_ID_PLUS_1}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_view', '1', null, '1', '0', null, '0', null, '{{TABLE_COMMENT}}查看', 1, '{{BILL_CODE}}');
 
-insert into sys_menu (menu_id, parent_id, permission, menu_type, path, icon, del_flag, create_time, sort_order, update_time, name, tenant_id)
-values ({{MENU_BASE_ID_PLUS_2}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_add', '1', null, '1', '0', null, '1', null, '{{TABLE_COMMENT}}新增', 1);
+insert into sys_menu (menu_id, parent_id, permission, menu_type, path, icon, del_flag, create_time, sort_order, update_time, name, tenant_id, bill_code)
+values ({{MENU_BASE_ID_PLUS_2}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_add', '1', null, '1', '0', null, '1', null, '{{TABLE_COMMENT}}新增', 1, '{{BILL_CODE}}');
 
-insert into sys_menu (menu_id, parent_id, permission, menu_type, path, icon, del_flag, create_time, sort_order, update_time, name, tenant_id)
-values ({{MENU_BASE_ID_PLUS_3}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_edit', '1', null, '1', '0', null, '2', null, '{{TABLE_COMMENT}}修改', 1);
+insert into sys_menu (menu_id, parent_id, permission, menu_type, path, icon, del_flag, create_time, sort_order, update_time, name, tenant_id, bill_code)
+values ({{MENU_BASE_ID_PLUS_3}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_edit', '1', null, '1', '0', null, '2', null, '{{TABLE_COMMENT}}修改', 1, '{{BILL_CODE}}');
 
-insert into sys_menu (menu_id, parent_id, permission, menu_type, path, icon, del_flag, create_time, sort_order, update_time, name, tenant_id)
-values ({{MENU_BASE_ID_PLUS_4}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_del', '1', null, '1', '0', null, '3', null, '{{TABLE_COMMENT}}删除', 1);
+insert into sys_menu (menu_id, parent_id, permission, menu_type, path, icon, del_flag, create_time, sort_order, update_time, name, tenant_id, bill_code)
+values ({{MENU_BASE_ID_PLUS_4}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_del', '1', null, '1', '0', null, '3', null, '{{TABLE_COMMENT}}删除', 1, '{{BILL_CODE}}');
 
-insert into sys_menu (menu_id, parent_id, permission, menu_type, path, icon, del_flag, create_time, sort_order, update_time, name, tenant_id)
-values ({{MENU_BASE_ID_PLUS_5}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_export', '1', null, '1', '0', null, '4', null, '导入导出', 1);
+insert into sys_menu (menu_id, parent_id, permission, menu_type, path, icon, del_flag, create_time, sort_order, update_time, name, tenant_id, bill_code)
+values ({{MENU_BASE_ID_PLUS_5}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_export', '1', null, '1', '0', null, '4', null, '导入导出', 1, '{{BILL_CODE}}');

package/assets/templates/single_table_dialog/index.tpl

@@ -23,6 +23,7 @@
         row-id-key="{{PK_ATTR}}"
         :action-column-width="{{ACTION_COLUMN_WIDTH}}"
         @selection-change="handleTableSelectionChange"
+        @row-current-change="handleTableRowCurrentChange"
         @sort-change="handleTableSortChange"
         @size-change="handleTableSizeChange"
         @current-change="handleTableCurrentChange"
@@ -51,6 +52,8 @@ import { useDict } from '/@/hooks/dict';
 {{DICT_SEMANTIC_IMPORT_BLOCK}}
 // 列表页字段元数据能力
 import { useCrudPageMeta } from '/@/hooks/useCrudPageMeta';
+// 列表当前行选中保持能力
+import { useTableCurrentRow } from '/@/hooks/useTableCurrentRow';
 // 列表页查询与分页状态
 import { useSchemaListQuery } from '/@/hooks/useSchemaListQuery';
 // 统一列表工具栏组件
@@ -86,6 +89,12 @@ const { state, getDataList, currentChangeHandle, sizeChangeHandle, sortChangeHan
   exportFileName: '{{FUNCTION_NAME}}.xlsx',
 });
 
+// 统一处理列表加载后的首行选中，以及刷新后的当前行保持
+const { currentRowKey, handleCurrentChange: handleTableRowCurrentChange } = useTableCurrentRow(
+  computed(() => state.dataList),
+  '{{PK_ATTR}}'
+);
+
 // 提供字段标签、字典选项和查询区描述
 const { resolveLabel, getDictOptions, visibleTableColumns, searchKeywordTooltip, queryableDictFields } = useCrudPageMeta(dataMasterEntity, dictRefs);
 
@@ -130,6 +139,8 @@ const tableProps = computed(() => ({
   columns: tableColumns.value,
   pagination: state.pagination,
   tableStyle,
+  currentRowKey: currentRowKey.value,
+  highlightCurrentRow: true,
 }));
 
 // 字典页动作按钮控制（按需生成）