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

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

@@ -2,20 +2,20 @@
 -- 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}}');
 
-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_jump/index.tpl

@@ -23,6 +23,7 @@
         row-id-key="{{PK_ATTR}}"
         :action-column-width="320"
         @selection-change="handleTableSelectionChange"
+        @row-current-change="handleTableRowCurrentChange"
         @sort-change="handleTableSortChange"
         @size-change="handleTableSizeChange"
         @current-change="handleTableCurrentChange"
@@ -33,10 +34,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>
@@ -57,6 +58,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';
 // 统一列表工具栏组件
@@ -93,6 +96,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);
 
@@ -136,6 +145,8 @@ const tableProps = computed(() => ({
   columns: tableColumns.value,
   pagination: state.pagination,
   tableStyle,
+  currentRowKey: currentRowKey.value,
+  highlightCurrentRow: true,
 }));
 
 // 表单页路由路径

package/assets/templates/single_table_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_tree_table/api.tpl

@@ -0,0 +1,17 @@
+import request from '/@/utils/request';
+import { createCrudApi } from '/@/api/common/crudFactory';
+
+// {{FEATURE_TITLE}} 通用列表、新增、详情、删除、更新、导出接口
+export const { fetchList, addObj, getObj, delObjs, putObj, exportObj } = createCrudApi('/{{API_PATH}}');
+
+// {{FEATURE_TITLE}} 树形子节点列表
+export function fetchTreeList(payload?: any) {
+  return request({
+    url: '/{{API_PATH}}/listByParentId',
+    method: 'get',
+    params: payload,
+  });
+}
+
+{{DICT_API_FUNCTIONS}}
+{{EXTRA_API_FUNCTIONS}}

package/assets/templates/single_tree_table/form.tpl

@@ -0,0 +1,139 @@
+<template>
+  <!-- 表单弹窗：新增或编辑{{FEATURE_TITLE}}数据 -->
+  <el-dialog v-model="visible" :title="form.{{PK_ATTR}} ? t('common.editBtn') : t('common.addBtn')" :close-on-click-modal="false" draggable>
+    <!-- 弹窗表单：按 PRD 表单显隐和顺序渲染字段 -->
+    <el-form ref="dataFormRef" :model="form" :rules="dataRules" label-width="100px" v-loading="loading">
+      <!-- 主表字段区：字段级注释由 MCP 根据字段名称生成 -->
+      <el-row :gutter="24">
+{{FORM_FIELDS}}
+      </el-row>
+    </el-form>
+    <!-- 弹窗底部操作按钮：取消和确认提交 -->
+    <template #footer>
+      <span class="dialog-footer">
+        <el-button @click="visible = false">{{ t('common.cancelButtonText') }}</el-button>
+        <el-button type="primary" @click="onSubmit" :disabled="loading">{{ t('common.confirmButtonText') }}</el-button>
+      </span>
+    </template>
+  </el-dialog>
+</template>
+
+<script setup lang="ts" name="{{CLASS_NAME}}Dialog">
+// 通用消息提示
+import { useMessage } from '/@/hooks/message';
+// 本地会话存储
+import { Session } from '/@/utils/storage';
+// 表单数据接口
+import { getObj, addObj, putObj } from '/@/api/{{API_MODULE_PATH}}';
+// 字典数据加载
+import { useDict } from '/@/hooks/dict';
+// 表单字段元数据能力
+import { useCrudPageMeta } from '/@/hooks/useCrudPageMeta';
+// 国际化能力
+import { useI18n } from 'vue-i18n';
+// 当前页面的字段配置
+import { allDictTypes, dataMasterEntity } from './options';
+
+// 页面所需的字典引用
+const dictRefs = useDict(...allDictTypes);
+// 国际化方法
+const { t } = useI18n();
+// 弹窗刷新事件
+const emit = defineEmits(['refresh']);
+
+// 表单引用
+const dataFormRef = ref();
+// 弹窗显示状态
+const visible = ref(false);
+// 提交加载状态
+const loading = ref(false);
+
+// 主表字段的双语、字典和校验提示统一由公共 hook 提供
+const {
+  getFieldMeta: getMasterFieldMeta,
+  getFieldLabel: getMasterFieldLabel,
+  getDictOptions,
+  inputPlaceholder,
+  selectPlaceholder,
+  fieldRequiredMessage,
+} = useCrudPageMeta(dataMasterEntity, dictRefs);
+
+const formInputPlaceholder = (label: string, disabled = false) => (disabled ? '' : inputPlaceholder(label));
+const formSelectPlaceholder = (label: string, disabled = false) => (disabled ? '' : selectPlaceholder(label));
+
+// 统一维护表单默认值
+const createDefaultFormState = () => ({
+{{FORM_DEFAULTS}}
+});
+
+// 表单响应式数据
+const form = reactive(createDefaultFormState());
+
+// 表单校验规则
+const dataRules = ref({
+{{FORM_RULES}}
+});
+
+// 根据主键加载详情数据
+const get{{CLASS_NAME}}Data = async (id: string) => {
+  try {
+    loading.value = true;
+    const { data } = await getObj({ {{PK_ATTR}}: id });
+    Object.assign(form, Array.isArray(data) ? data[0] || {} : data || {});
+  } catch (error) {
+    useMessage().error(t('common.messages.fetchError'));
+  } finally {
+    loading.value = false;
+  }
+};
+
+// 重置表单为初始状态
+const resetFormState = () => {
+  Object.assign(form, createDefaultFormState());
+  nextTick(() => {
+    dataFormRef.value?.resetFields();
+  });
+};
+
+// 打开弹窗并按需加载详情
+const openDialog = async (id?: string, parentId?: string | number) => {
+  visible.value = true;
+  resetFormState();
+
+  if (parentId !== undefined && parentId !== null && parentId !== '') {
+    form.{{TREE_PARENT_ATTR}} = parentId;
+  }
+
+  if (id) {
+    form.{{PK_ATTR}} = id;
+    await get{{CLASS_NAME}}Data(id);
+  }
+};
+
+// 提交弹窗表单
+const onSubmit = async () => {
+  loading.value = true;
+
+  const valid = await dataFormRef.value.validate().catch(() => {});
+  if (!valid) {
+    loading.value = false;
+    return false;
+  }
+
+  try {
+    form.{{PK_ATTR}} ? await putObj(form) : await addObj(form);
+    useMessage().success(form.{{PK_ATTR}} ? t('common.editSuccessText') : t('common.addSuccessText'));
+    visible.value = false;
+    emit('refresh');
+  } catch (err: any) {
+    useMessage().error(err.msg || t('common.messages.submitError'));
+  } finally {
+    loading.value = false;
+  }
+};
+
+// 向父组件暴露打开弹窗方法
+defineExpose({
+  openDialog,
+});
+</script>

package/assets/templates/single_tree_table/index.tpl

@@ -0,0 +1,203 @@
+<!-- 功能名称：{{FEATURE_TITLE}} -->
+<template>
+  <div class="layout-padding">
+    <div class="layout-padding-auto layout-padding-view flex h-full flex-col">
+      <SchemaListToolbar
+        v-bind="toolbarProps"
+        :show-add="false"
+        @update:keyword="state.queryForm.smartVal = $event"
+        @query="handleToolbarQuery"
+        @reset="handleToolbarReset"
+        @refresh="handleToolbarRefresh"
+      >
+        <template #prepend-actions>
+          <el-dropdown trigger="click" @command="handleAddTreeNode">
+            <el-button type="primary">
+              {{ t('common.addBtn') }}
+              <el-icon class="ml-1"><ArrowDown /></el-icon>
+            </el-button>
+            <template #dropdown>
+              <el-dropdown-menu>
+                <el-dropdown-item command="root">{{ resolveText('common.treeActions.addRoot', '新增根节点') }}</el-dropdown-item>
+                <el-dropdown-item command="sibling" :disabled="!currentRow">{{ resolveText('common.treeActions.addSibling', '新增同级节点') }}</el-dropdown-item>
+                <el-dropdown-item command="child" :disabled="!currentRow">{{ resolveText('common.treeActions.addChild', '新增子节点') }}</el-dropdown-item>
+              </el-dropdown-menu>
+            </template>
+          </el-dropdown>
+        </template>
+      </SchemaListToolbar>
+
+      <SchemaTreeTable
+        v-bind="tableProps"
+        row-id-key="{{PK_ATTR}}"
+        :load="loadTreeChildren"
+        :action-column-width="{{ACTION_COLUMN_WIDTH}}"
+        @row-current-change="handleTableRowCurrentChange"
+      >
+        <template #actions="{ row }">
+{{LIST_ACTIONS}}
+        </template>
+      </SchemaTreeTable>
+    </div>
+
+    <form-dialog ref="formDialogRef" @refresh="getDataList" />
+  </div>
+</template>
+
+<script setup lang="ts" name="system{{CLASS_NAME}}">
+import { ArrowDown } from '@element-plus/icons-vue';
+import { computed, defineAsyncComponent, onMounted, reactive, ref, watch } from 'vue';
+import { useI18n } from 'vue-i18n';
+import { fetchTreeList, delObjs{{DICT_API_IMPORTS}} } from '/@/api/{{API_MODULE_PATH}}';
+import { useMessage, useMessageBox } from '/@/hooks/message';
+import { useDict } from '/@/hooks/dict';
+{{DICT_SEMANTIC_IMPORT_BLOCK}}
+import { useTable } from '/@/hooks/table';
+import { useCrudPageMeta } from '/@/hooks/useCrudPageMeta';
+// 列表当前行选中保持能力
+import { useTableCurrentRow } from '/@/hooks/useTableCurrentRow';
+import { buildSchemaQueryParams } from '/@/utils/schemaQuery';
+import SchemaListToolbar from '/@/components/schema-list/SchemaListToolbar.vue';
+import SchemaTreeTable from '/@/components/schema-list/SchemaTreeTable.vue';
+import { allDictTypes, crudSchema, dataMasterEntity } from './options';
+
+const FormDialog = defineAsyncComponent(() => import('./form.vue'));
+const formDialogRef = ref();
+const { t } = useI18n();
+const dictRefs = useDict(...allDictTypes);
+const { tableStyle } = useTable({ createdIsNeed: false });
+
+const state = reactive({
+  loading: false,
+  dataList: [] as any[],
+  queryForm: {
+    smartVal: '',
+  } as Record<string, any>,
+});
+
+// 统一处理树表加载后的首行选中、刷新后的当前行保持，并保留当前行供新增同级/子级使用
+const { currentRow, currentRowKey, handleCurrentChange: handleTableRowCurrentChange } = useTableCurrentRow(
+  computed(() => state.dataList),
+  '{{PK_ATTR}}'
+);
+
+const { resolveLabel, getDictOptions, visibleTableColumns, searchKeywordTooltip } = useCrudPageMeta(dataMasterEntity, dictRefs);
+
+const resolveText = (key: string, fallback: string) => {
+  const translated = t(key);
+  return translated === key ? fallback : translated;
+};
+
+const tableColumns = computed(() =>
+  visibleTableColumns.value.map((column) => ({
+    prop: column.prop,
+    label: resolveLabel(column.labelKey, column.fallbackLabel),
+    width: column.width,
+    dictType: column.dictType,
+    options: column.dictType ? getDictOptions(column.dictType) : [],
+  }))
+);
+
+const toolbarProps = computed(() => ({
+  keyword: state.queryForm.smartVal,
+  searchPlaceholder: searchKeywordTooltip.value,
+  queryModel: state.queryForm,
+  customQueryFields: [],
+  selectedIds: [],
+  showImport: false,
+  showDelete: false,
+  showRightTools: false,
+}));
+
+const tableProps = computed(() => ({
+  data: state.dataList,
+  loading: !!state.loading,
+  columns: tableColumns.value,
+  tableStyle,
+  currentRowKey: currentRowKey.value,
+  lazy: true,
+  highlightCurrentRow: true,
+}));
+
+const normalizeTreeRows = (rows: any[]) =>
+  rows.map((row) => ({
+    ...row,
+    hasChildren:
+      typeof row.hasChildren === 'boolean'
+        ? row.hasChildren
+        : typeof row.hasChild === 'boolean'
+          ? row.hasChild
+          : typeof row.childCount === 'number'
+            ? row.childCount > 0
+            : true,
+  }));
+
+const getQueryParams = () => ({
+  {{TREE_PARENT_ATTR}}: {{TREE_ROOT_PARENT_VALUE}},
+  ...buildSchemaQueryParams(crudSchema.filterTypes, state.queryForm),
+});
+
+const getDataList = async () => {
+  state.loading = true;
+  try {
+    const { data } = await fetchTreeList(getQueryParams());
+    const rows = Array.isArray(data) ? data : data?.records || data?.list || [];
+    state.dataList = normalizeTreeRows(rows);
+  } finally {
+    state.loading = false;
+  }
+};
+
+{{DICT_LIST_HELPERS}}
+
+const handleAddTreeNode = (command: 'root' | 'sibling' | 'child') => {
+  let parentId: string | number = {{TREE_ROOT_PARENT_VALUE}};
+  if (command === 'sibling' && currentRow.value) parentId = currentRow.value.{{TREE_PARENT_ATTR}} ?? {{TREE_ROOT_PARENT_VALUE}};
+  if (command === 'child' && currentRow.value) parentId = currentRow.value.{{PK_ATTR}};
+  formDialogRef.value?.openDialog(undefined, parentId);
+};
+
+const handleDelete = async (ids: string[]) => {
+  try {
+    await useMessageBox().confirm(t('common.delConfirmText'));
+  } catch {
+    return;
+  }
+
+  try {
+    await delObjs(ids);
+    await getDataList();
+    useMessage().success(t('common.delSuccessText'));
+  } catch (err: any) {
+    useMessage().error(err.msg || t('common.delBtn'));
+  }
+};
+
+const handleToolbarQuery = () => {
+  getDataList();
+};
+
+const handleToolbarReset = () => {
+  Object.keys(state.queryForm).forEach((key) => delete state.queryForm[key]);
+  state.queryForm.smartVal = '';
+  getDataList();
+};
+
+const handleToolbarRefresh = () => {
+  getDataList();
+};
+
+const loadTreeChildren = async (row: any, _treeNode: any, resolve: (data: any[]) => void) => {
+  try {
+    const { data } = await fetchTreeList({ {{TREE_PARENT_ATTR}}: row?.{{PK_ATTR}} });
+    const rows = Array.isArray(data) ? data : data?.records || data?.list || [];
+    resolve(normalizeTreeRows(rows));
+  } catch {
+    resolve([]);
+  }
+};
+
+onMounted(() => {
+  getDataList();
+});
+</script>

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

@@ -0,0 +1,21 @@
+-- Do not execute directly. Review parent menu id and tenant settings before import.
+-- 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, 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, 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_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, 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, 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, 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_tree_table/options.tpl

@@ -0,0 +1,35 @@
+// 字典注册表
+{{DICT_REGISTRY_IMPORT_BLOCK}}
+// schema 构建工具
+import { createCrudSchema } from '/@/utils/crudSchema';
+// schema 类型定义
+import type { CrudSchemaDefinition } from '/@/utils/crudSchema';
+
+/**
+ * {{TABLE_NAME}} 页面字段声明
+ * 这里维护字段 key、双语 key、字典类型和显示元数据
+ */
+const definition: CrudSchemaDefinition = {
+  master: [
+{{MASTER_OPTION_FIELDS}}
+  ],
+  children: {
+{{CHILD_OPTION_GROUPS}}
+  },
+};
+
+// 将页面字段声明转换为 index/form 共用的 schema 结果
+const schema = createCrudSchema(definition);
+
+// 完整 CRUD schema
+export const crudSchema = schema;
+// 主表字段配置，供列表页和表单页使用
+export const dataMasterEntity = schema.master;
+// 子表字段配置，当前无子表时保留统一出口
+export const childFieldGroups = schema.children;
+// 列表/查询使用的主表字段类型映射
+export const filterTypes = schema.filterTypes;
+// 子表字段类型映射
+export const childFilterTypes = schema.childFilterTypes;
+// 当前页面需要一次性加载的全部字典类型
+export const allDictTypes = schema.allDictTypes;

package/assets/templates/tree_left_list/README.md

@@ -0,0 +1 @@
+tree_left_list 由 mcp_server.js 的多层字典模型专用渲染函数生成，目录用于样式目录注册和模板资产归档。

package/assets/templates/tree_left_list/api.tpl

@@ -0,0 +1,4 @@
+/*
+ * 左树右列表 API 模板由 mcp_server.js 的 renderTreeLeftListApiTs 渲染。
+ * 该模板会为左侧树形模块额外生成 <apiPath>/listByParentId 懒加载接口。
+ */

package/assets/templates/tree_left_list/form.tpl

@@ -0,0 +1,3 @@
+<!--
+左树右列表 form 模板复用多层字典 form 渲染逻辑。
+-->

package/assets/templates/tree_left_list/index.tpl

@@ -0,0 +1,4 @@
+<!--
+左树右列表模板由 mcp_server.js 的 renderTreeLeftListIndexVue 渲染。
+该样式依赖 levels[]：level 1 为左侧树形模块，level 2 为右侧列表模块。
+-->

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

@@ -0,0 +1 @@
+-- 左树右列表菜单 SQL 模板复用多层字典菜单 SQL 渲染逻辑。

package/assets/templates/tree_left_list/options.tpl

@@ -0,0 +1,3 @@
+/*
+ * 左树右列表 options 模板复用多层字典 options 渲染逻辑。
+ */