worsoft-frontend-codegen-local-mcp 0.1.84 → 0.1.88

package/README.md

@@ -9,10 +9,24 @@ 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
 
+Preferred input:
+
+- `parseResultPath`
+- `writeToDisk`
+- `overwrite`
+- `writeSupportFiles`
+- `mergeI18nZh`
+
+When `parseResultPath` is provided, MCP reads `parseResult.json` locally and uses `parseResult.mcpPayload` as the generation input. The caller should not expand `mcpPayload` in the model context.
+
+Legacy-compatible low-level inputs:
+
 - `featureTitle`
 - `tableName`
 - `tableComment`
@@ -33,7 +47,28 @@ If the caller accidentally passes the `src` directory, MCP will normalize it bac
 
 ## Recommended MCP Arguments
 
-Single table:
+Preferred:
+
+```json
+{
+  "parseResultPath": "E:/own-worker-platform/trunk/docs/03-modules/.../parseResult.json",
+  "writeToDisk": true,
+  "overwrite": true
+}
+```
+
+If `parseResult.mcpPayload` does not contain `frontendPath`, pass it as a non-semantic runtime argument:
+
+```json
+{
+  "parseResultPath": "E:/own-worker-platform/trunk/docs/03-modules/.../parseResult.json",
+  "frontendPath": "E:/own-worker-platform/trunk/worsoft-ui",
+  "writeToDisk": true,
+  "overwrite": true
+}
+```
+
+Legacy low-level single table:
 
 ```json
 {
@@ -54,7 +89,7 @@ Single table:
 }
 ```
 
-Master-child:
+Legacy low-level master-child:
 
 ```json
 {
@@ -103,10 +138,13 @@ Node:
 
 ```bash
 node plugins/worsoft-codegen-local/smoke_test_mcp.js --scenario single
+node plugins/worsoft-codegen-local/smoke_test_mcp.js --scenario parse_result_path
 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:
@@ -130,9 +168,9 @@ Optional overrides:
 - `mergeI18nZh=false`:
   MCP renders `zh-cn.ts` from current metadata only and does not parse the existing file
 
-## Master-Child Contract
+## Legacy Low-Level Master-Child Contract
 
-For `master_child_jump`, MCP does not infer relations.
+For low-level `master_child_jump` calls, MCP does not infer relations. `parseResultPath` callers should let `doc-parse` populate `parseResult.mcpPayload.children`.
 
 The caller must provide explicit `children[]`, and each child must include:
 
@@ -145,9 +183,9 @@ The caller must provide explicit `children[]`, and each child must include:
 
 If these fields are missing, MCP returns a structured validation error.
 
-## Multi-Level Dictionary Contract
+## Legacy Low-Level Multi-Level Dictionary Contract
 
-For `multi_level_dict`, MCP does not infer hierarchy.
+For low-level `multi_level_dict`, MCP does not infer hierarchy. `parseResultPath` callers should let `doc-parse` populate `parseResult.mcpPayload.levels`.
 
 The caller must provide explicit `levels[]`. Each level must include:
 
@@ -160,6 +198,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`
@@ -174,12 +216,7 @@ Each module must include:
 - Human guide: `STYLE_TEMPLATE_GUIDE.md`
 - Machine source: `assets/style-catalog.json`
 
-Declared styles:
-
-- `single_table_jump`
-- `single_table_dialog`
-- `master_child_jump`
-- `multi_level_dict`
+Declared styles are defined by `assets/style-catalog.json`; README intentionally does not duplicate the full enum as a second source.
 
 ## 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/api.tpl

@@ -2,6 +2,6 @@
 import { createCrudApi } from '/@/api/common/crudFactory';
 {{API_REQUEST_IMPORT}}
 
-// {{FEATURE_TITLE}}主子表台账只读接口：分页查询、详情查询
-export const { fetchList, getObj } = createCrudApi('/{{API_PATH}}');
+// {{FEATURE_TITLE}}主子表台账只读接口：分页查询、详情查询、导出
+export const { fetchList, getObj, exportObj } = createCrudApi('/{{API_PATH}}');
 {{EXTRA_API_FUNCTIONS}}

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 { fetchList, exportObj } 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,27 @@ 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',
+  exportApi: exportObj,
+  exportFileName: '{{FEATURE_TITLE}}.xlsx',
+  exportColumns: () => tableColumns.value,
 });
 
+// 统一处理台账列表加载后的首行选中，以及刷新后的当前行保持
+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 +99,7 @@ const tableColumns = computed(() =>
   }))
 );
 
-// 台账工具栏透传属性：显式关闭新增、导入、删除和导出入口
+// 工具栏透传属性：显式关闭新增、导入、删除入口，保留导出
 const toolbarProps = computed(() => ({
   keyword: state.queryForm.smartVal,
   searchPlaceholder: searchKeywordTooltip.value,
@@ -95,10 +109,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 +120,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 +172,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/api.tpl

@@ -2,6 +2,6 @@
 import { createCrudApi } from '/@/api/common/crudFactory';
 {{API_REQUEST_IMPORT}}
 
-// {{FEATURE_TITLE}}台账只读接口：分页查询、详情查询
-export const { fetchList, getObj } = createCrudApi('/{{API_PATH}}');
+// {{FEATURE_TITLE}}台账只读接口：分页查询、详情查询、导出
+export const { fetchList, getObj, exportObj } = createCrudApi('/{{API_PATH}}');
 {{EXTRA_API_FUNCTIONS}}

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 { fetchList, exportObj } 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,27 @@ 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',
+  exportApi: exportObj,
+  exportFileName: '{{FEATURE_TITLE}}.xlsx',
+  exportColumns: () => tableColumns.value,
 });
 
+// 统一处理台账列表加载后的首行选中，以及刷新后的当前行保持
+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 +99,7 @@ const tableColumns = computed(() =>
   }))
 );
 
-// 台账工具栏透传属性：显式关闭新增、导入、删除和导出入口
+// 工具栏透传属性：显式关闭新增、导入、删除入口，保留导出
 const toolbarProps = computed(() => ({
   keyword: state.queryForm.smartVal,
   searchPlaceholder: searchKeywordTooltip.value,
@@ -95,10 +109,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 +120,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 +133,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 +172,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();
 });