From 219e4f7eff8cb870be0239374b97052638dcd81a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=99=88=E5=AD=90=E9=BB=98?= <925456043@qq.com>
Date: Mon, 3 Aug 2026 11:39:40 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E4=BC=98=E5=8C=96=E6=95=B0=E6=8D=AE?=
 =?UTF-8?q?=E4=B8=AD=E6=9E=A2=20Excel=20=E8=BF=9E=E6=8E=A5=E5=88=9B?=
 =?UTF-8?q?=E5=BB=BA=E4=BA=A4=E4=BA=92?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 在新增连接中完成 Excel 上传并自动填写连接名称

- 限制上传格式并提供空表和无表头错误反馈

- 移除旧导入入口和无效测试连接操作
---
 .../views/datacenter/DatacenterWorkspace.vue  | 224 ++----------------
 .../components/SourceFormDrawer.vue           | 178 +++++++++++++-
 .../datacenter/components/TableDetailView.vue |   2 +-
 .../datacenter-excel-upload.test.ts           |  22 ++
 .../composables/datacenter-excel-upload.ts    |  22 ++
 .../datacenter/composables/datacenter-id.ts   |   4 +
 .../composables/use-connection-tree.ts        |   4 +-
 .../composables/use-datacenter-sources.ts     |  35 ++-
 .../composables/use-datacenter-tables.ts      |  29 ++-
 .../datacenter/composables/use-source-form.ts |   9 +-
 .../src/ui/form-modal/form-modal.vue          |   5 +-
 11 files changed, 301 insertions(+), 233 deletions(-)
 create mode 100644 easyflow-ui-admin/app/src/views/datacenter/composables/datacenter-excel-upload.test.ts
 create mode 100644 easyflow-ui-admin/app/src/views/datacenter/composables/datacenter-excel-upload.ts
 create mode 100644 easyflow-ui-admin/app/src/views/datacenter/composables/datacenter-id.ts

diff --git a/easyflow-ui-admin/app/src/views/datacenter/DatacenterWorkspace.vue b/easyflow-ui-admin/app/src/views/datacenter/DatacenterWorkspace.vue
index 9a073256..23603ddc 100644
--- a/easyflow-ui-admin/app/src/views/datacenter/DatacenterWorkspace.vue
+++ b/easyflow-ui-admin/app/src/views/datacenter/DatacenterWorkspace.vue
@@ -1,37 +1,26 @@
 <script setup lang="ts">
 import type { TreeNode } from './composables/use-connection-tree';
 
-import { computed, nextTick, onBeforeUnmount, onMounted, ref } from 'vue';
+import { nextTick, onBeforeUnmount, onMounted, ref } from 'vue';
 
 import {
-  EasyFlowButton,
   ResizableHandle,
   ResizablePanel,
   ResizablePanelGroup,
 } from '@easyflow-core/shadcn-ui';
 
-import {
-  ElDropdown,
-  ElDropdownItem,
-  ElDropdownMenu,
-  ElEmpty,
-  ElMessageBox,
-} from 'element-plus';
+import { ElEmpty, ElMessage, ElMessageBox } from 'element-plus';
 
 import ConnectionTree from './components/ConnectionTree.vue';
-import ExcelActionDrawer from './components/ExcelActionDrawer.vue';
 import SourceFormDrawer from './components/SourceFormDrawer.vue';
 import TableDetailView from './components/TableDetailView.vue';
 import TableListView from './components/TableListView.vue';
 import { useConnectionTree } from './composables/use-connection-tree';
-import { useDatacenterExcel } from './composables/use-datacenter-excel';
 import { useDatacenterSources } from './composables/use-datacenter-sources';
 import { useDatacenterTables } from './composables/use-datacenter-tables';
 
 const sourceFormRef = ref<InstanceType<typeof SourceFormDrawer>>();
-const excelActionRef = ref<InstanceType<typeof ExcelActionDrawer>>();
 const sourceFormVisible = ref(false);
-const excelActionVisible = ref(false);
 const workspaceRef = ref<HTMLElement>();
 const workspaceHeight = ref('100%');
 
@@ -42,6 +31,7 @@ const {
   loading,
   saving,
   testing,
+  importExcelSource,
   loadSources,
   removeSource,
   saveSource,
@@ -76,7 +66,7 @@ async function reloadAll(options?: {
   resetTable?: boolean;
 }) {
   await loadSources();
-  if (!selectedSourceId.value) {
+  if (selectedSourceId.value === null) {
     selectedCatalogId.value = null;
     selectedTableId.value = null;
     selectedNodeKey.value = '';
@@ -97,61 +87,11 @@ async function reloadAll(options?: {
   viewMode.value = 'list';
 }
 
-const {
-  actionLoading,
-  pendingUploadFile,
-  splitForm,
-  mergeForm,
-  deriveForm,
-  exportForm,
-  resetSplitForm,
-  resetMergeForm,
-  resetDeriveForm,
-  resetExportForm,
-  handleImport,
-  handleSplit,
-  handleMerge,
-  handleDerive,
-  handleExport,
-} = useDatacenterExcel(
-  selectedSourceId,
-  selectedCatalogId,
-  selectedTableId,
-  reloadAll,
-);
-
 // 视图状态：empty | list | detail
 const selectedNodeKey = ref('');
 const viewMode = ref<'detail' | 'empty' | 'list'>('empty');
 
-const isExcelContext = computed(() => {
-  const st =
-    selectedSource.value?.sourceType || schema.value?.source?.sourceType;
-  return st === 'EXCEL' || st === 'EXCEL_MATERIALIZED';
-});
-const canImportExcel = computed(
-  () => selectedSource.value?.sourceType === 'EXCEL',
-);
-const canExport = computed(() =>
-  Boolean(selectedTable.value || selectedSource.value),
-);
-const canShowMoreActions = computed(
-  () =>
-    isExcelContext.value &&
-    (Boolean(selectedTable.value) ||
-      managedTables.value.length > 1 ||
-      canExport.value),
-);
-const showToolbar = computed(
-  () => canImportExcel.value || canShowMoreActions.value,
-);
 const { treeData, parseNodeKey } = useConnectionTree(sources);
-const selectedFieldOptions = computed(() =>
-  (schema.value?.fields || []).map((f: any) => ({
-    label: f.fieldName,
-    value: f.fieldName,
-  })),
-);
 
 async function handleNodeSelect(node: TreeNode) {
   selectedNodeKey.value = node.id;
@@ -188,7 +128,10 @@ async function handleBatchRegister(rows: any[]) {
 async function handleBatchRemove(rows: any[]) {
   const removedIds = rows.map((row) => row?.id).filter(Boolean);
   await batchRemoveTables(rows);
-  if (selectedTableId.value && removedIds.includes(selectedTableId.value)) {
+  if (
+    selectedTableId.value !== null &&
+    removedIds.includes(selectedTableId.value)
+  ) {
     viewMode.value = 'list';
   }
 }
@@ -245,8 +188,18 @@ async function handleRemoveSource(node: TreeNode) {
   await reloadAll({ focus: 'source', resetTable: true });
 }
 
-async function handleSaveSource(formData: Record<string, any>) {
-  await saveSource(formData);
+async function handleSaveSource(
+  formData: Record<string, any>,
+  excelFile?: File,
+) {
+  if (formData.sourceType === 'EXCEL' && !formData.id) {
+    if (!excelFile) return;
+    await importExcelSource(excelFile, formData.sourceName);
+    ElMessage.success('Excel 已导入');
+  } else {
+    await saveSource(formData);
+    ElMessage.success(formData.id ? '连接已更新' : '连接已创建');
+  }
   sourceFormRef.value?.close();
   sourceFormVisible.value = false;
   await nextTick();
@@ -259,58 +212,6 @@ async function handleTestConnection(formData: Record<string, any>) {
   if (formData.id) await loadSources();
 }
 
-function openExcelAction(
-  action: 'derive' | 'export' | 'import' | 'merge' | 'split',
-) {
-  switch (action) {
-    case 'derive': {
-      resetDeriveForm();
-      break;
-    }
-    case 'export': {
-      resetExportForm();
-      break;
-    }
-    case 'merge': {
-      resetMergeForm();
-      break;
-    }
-    case 'split': {
-      resetSplitForm();
-      break;
-    }
-  }
-  excelActionRef.value?.open(action);
-  excelActionVisible.value = true;
-}
-
-async function handleExcelAction(action: string) {
-  let success = false;
-  switch (action) {
-    case 'derive': {
-      success = await handleDerive();
-      break;
-    }
-    case 'export': {
-      success = await handleExport(loadTableRuntime);
-      break;
-    }
-    case 'import': {
-      success = await handleImport();
-      break;
-    }
-    case 'merge': {
-      success = await handleMerge();
-      break;
-    }
-    case 'split': {
-      success = await handleSplit();
-      break;
-    }
-  }
-  if (success) excelActionVisible.value = false;
-}
-
 async function loadAll() {
   loading.value = true;
   try {
@@ -346,53 +247,6 @@ onBeforeUnmount(() => {
     :style="{ height: workspaceHeight }"
     v-loading="loading"
   >
-    <!-- 顶部工具栏 -->
-    <div v-if="showToolbar" class="workspace-toolbar">
-      <div class="toolbar-left">
-        <EasyFlowButton
-          v-if="canImportExcel"
-          class="toolbar-button"
-          variant="outline"
-          @click="openExcelAction('import')"
-        >
-          导入 Excel
-        </EasyFlowButton>
-        <ElDropdown v-if="canShowMoreActions">
-          <EasyFlowButton class="toolbar-button" variant="outline">
-            更多操作
-          </EasyFlowButton>
-          <template #dropdown>
-            <ElDropdownMenu>
-              <ElDropdownItem
-                v-if="canExport"
-                @click="openExcelAction('export')"
-              >
-                导出
-              </ElDropdownItem>
-              <ElDropdownItem
-                v-if="selectedTable"
-                @click="openExcelAction('split')"
-              >
-                拆分
-              </ElDropdownItem>
-              <ElDropdownItem
-                v-if="managedTables.length > 1"
-                @click="openExcelAction('merge')"
-              >
-                合并
-              </ElDropdownItem>
-              <ElDropdownItem
-                v-if="selectedTable"
-                @click="openExcelAction('derive')"
-              >
-                生成新表
-              </ElDropdownItem>
-            </ElDropdownMenu>
-          </template>
-        </ElDropdown>
-      </div>
-    </div>
-
     <!-- 双栏主体 -->
     <ResizablePanelGroup direction="horizontal" class="workspace-body">
       <ResizablePanel :default-size="20" :min-size="16" :max-size="30">
@@ -447,25 +301,6 @@ onBeforeUnmount(() => {
       @save="handleSaveSource"
       @test="handleTestConnection"
     />
-
-    <ExcelActionDrawer
-      ref="excelActionRef"
-      v-model:visible="excelActionVisible"
-      v-model:split-form="splitForm"
-      v-model:merge-form="mergeForm"
-      v-model:derive-form="deriveForm"
-      v-model:export-form="exportForm"
-      :action-loading="actionLoading"
-      :managed-tables="managedTables"
-      :field-options="selectedFieldOptions"
-      :pending-upload-file="pendingUploadFile"
-      @update:pending-upload-file="(f) => (pendingUploadFile = f)"
-      @import="handleExcelAction('import')"
-      @split="handleExcelAction('split')"
-      @merge="handleExcelAction('merge')"
-      @derive="handleExcelAction('derive')"
-      @export="handleExcelAction('export')"
-    />
   </div>
 </template>
 
@@ -481,25 +316,6 @@ onBeforeUnmount(() => {
   background: transparent;
 }
 
-.workspace-toolbar {
-  display: flex;
-  gap: 12px;
-  align-items: center;
-  justify-content: flex-start;
-  padding: 0 0 12px;
-}
-
-.toolbar-left {
-  display: flex;
-  gap: 8px;
-  align-items: center;
-}
-
-.toolbar-button {
-  min-width: 84px;
-  box-shadow: none;
-}
-
 .workspace-body {
   flex: 1;
   width: 100%;
diff --git a/easyflow-ui-admin/app/src/views/datacenter/components/SourceFormDrawer.vue b/easyflow-ui-admin/app/src/views/datacenter/components/SourceFormDrawer.vue
index 3f014e04..2538911b 100644
--- a/easyflow-ui-admin/app/src/views/datacenter/components/SourceFormDrawer.vue
+++ b/easyflow-ui-admin/app/src/views/datacenter/components/SourceFormDrawer.vue
@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import type { FormInstance } from 'element-plus';
+import type { FormInstance, UploadFile, UploadInstance } from 'element-plus';
 
 import { computed, ref, watch } from 'vue';
 
@@ -7,20 +7,31 @@ import { EasyFlowFormModal } from '@easyflow/common-ui';
 
 import { EasyFlowButton } from '@easyflow-core/shadcn-ui';
 
-import { CircleCheckFilled, CircleCloseFilled } from '@element-plus/icons-vue';
+import {
+  CircleCheckFilled,
+  CircleCloseFilled,
+  UploadFilled,
+} from '@element-plus/icons-vue';
 import {
   ElForm,
   ElFormItem,
   ElIcon,
   ElInput,
+  ElMessage,
   ElOption,
   ElSelect,
+  ElUpload,
 } from 'element-plus';
 
 import {
   sourceTypeLabels,
   sourceTypeOptions,
 } from '../composables/datacenter-constants';
+import {
+  EXCEL_FILE_ACCEPT,
+  isSupportedExcelFileName,
+  sourceNameFromExcelFileName,
+} from '../composables/datacenter-excel-upload';
 import { useSourceForm } from '../composables/use-source-form';
 import SourceBrandIcon from './SourceBrandIcon.vue';
 
@@ -31,13 +42,17 @@ const props = defineProps<{
 }>();
 
 const emit = defineEmits<{
-  save: [form: Record<string, any>];
+  save: [form: Record<string, any>, excelFile?: File];
   test: [form: Record<string, any>];
   'update:visible': [value: boolean];
 }>();
 const formRef = ref<FormInstance>();
+const excelUploadRef = ref<UploadInstance>();
 const testResult = ref<any>(null);
 const showAdvanced = ref(false);
+const pendingExcelFile = ref<File | null>(null);
+const excelFileError = ref('');
+const lastGeneratedSourceName = ref('');
 
 const {
   form,
@@ -60,10 +75,24 @@ const testButtonClass = computed(() => ({
 const selectedSourceTypeLabel = computed(
   () => sourceTypeLabels[form.sourceType] || form.sourceType,
 );
+const isExcelCreate = computed(() => form.sourceType === 'EXCEL' && !form.id);
+const confirmDisabled = computed(
+  () =>
+    isExcelCreate.value &&
+    (!pendingExcelFile.value || !String(form.sourceName || '').trim()),
+);
+
+function resetExcelFile() {
+  excelUploadRef.value?.clearFiles();
+  pendingExcelFile.value = null;
+  excelFileError.value = '';
+  lastGeneratedSourceName.value = '';
+}
 
 function resetDialogState() {
   testResult.value = null;
   showAdvanced.value = false;
+  resetExcelFile();
 }
 
 function open(row?: any) {
@@ -78,8 +107,16 @@ function close() {
 }
 
 async function handleSave() {
+  if (isExcelCreate.value && !pendingExcelFile.value) {
+    excelFileError.value = '请选择需要导入的 Excel 文件';
+    return;
+  }
   await formRef.value?.validate();
-  emit('save', { ...form });
+  emit(
+    'save',
+    { ...form },
+    isExcelCreate.value ? pendingExcelFile.value || undefined : undefined,
+  );
 }
 
 async function handleTest() {
@@ -96,6 +133,33 @@ function setTestResult(result: any) {
   testResult.value = result;
 }
 
+function handleUploadChange(file: UploadFile) {
+  if (!isSupportedExcelFileName(file.name)) {
+    excelUploadRef.value?.clearFiles();
+    pendingExcelFile.value = null;
+    excelFileError.value = '仅支持 .xls 和 .xlsx 格式的 Excel 文件';
+    ElMessage.warning(excelFileError.value);
+    return;
+  }
+
+  const generatedSourceName = sourceNameFromExcelFileName(file.name);
+  if (
+    !String(form.sourceName || '').trim() ||
+    form.sourceName === lastGeneratedSourceName.value
+  ) {
+    form.sourceName = generatedSourceName;
+    formRef.value?.clearValidate('sourceName');
+  }
+  lastGeneratedSourceName.value = generatedSourceName;
+  pendingExcelFile.value = file.raw || null;
+  excelFileError.value = '';
+}
+
+function handleUploadRemove() {
+  pendingExcelFile.value = null;
+  excelFileError.value = '';
+}
+
 watch(
   () => [
     form.sourceName,
@@ -117,6 +181,15 @@ watch(
   },
 );
 
+watch(
+  () => form.sourceType,
+  (_sourceType, previousSourceType) => {
+    if (previousSourceType && previousSourceType !== form.sourceType) {
+      resetExcelFile();
+    }
+  },
+);
+
 defineExpose({ close, open, setTestResult });
 </script>
 
@@ -125,6 +198,7 @@ defineExpose({ close, open, setTestResult });
     :open="visible"
     :title="modalTitle"
     :before-close="handleBeforeClose"
+    :confirm-disabled="confirmDisabled"
     :confirm-loading="saving"
     confirm-text="保存"
     :submitting="saving"
@@ -141,13 +215,19 @@ defineExpose({ close, open, setTestResult });
     >
       <div class="form-grid">
         <ElFormItem label="连接名称" prop="sourceName">
-          <ElInput v-model="form.sourceName" placeholder="例如：华东 MySQL" />
+          <ElInput
+            v-model="form.sourceName"
+            maxlength="100"
+            :placeholder="
+              isExcelCreate ? '选择文件后自动填写' : '例如：华东 MySQL'
+            "
+          />
         </ElFormItem>
         <ElFormItem label="连接类型" prop="sourceType">
           <ElSelect
             v-model="form.sourceType"
             class="w-full"
-            :disabled="Boolean(form.builtinFlag)"
+            :disabled="Boolean(form.builtinFlag || form.id)"
           >
             <template #label>
               <span class="source-type-select-label">
@@ -174,6 +254,35 @@ defineExpose({ close, open, setTestResult });
         </ElFormItem>
       </div>
 
+      <ElFormItem
+        v-if="isExcelCreate"
+        label="表格文件"
+        required
+        :error="excelFileError"
+        class="excel-file-field"
+      >
+        <ElUpload
+          ref="excelUploadRef"
+          class="excel-upload"
+          drag
+          :accept="EXCEL_FILE_ACCEPT"
+          :auto-upload="false"
+          :show-file-list="true"
+          :limit="1"
+          :disabled="saving"
+          :on-change="handleUploadChange"
+          :on-remove="handleUploadRemove"
+        >
+          <ElIcon class="excel-upload__icon">
+            <UploadFilled />
+          </ElIcon>
+          <div class="excel-upload__title">拖拽或点击选择 Excel 文件</div>
+          <div class="excel-upload__description">
+            仅支持 .xls、.xlsx；工作表首行需包含表头
+          </div>
+        </ElUpload>
+      </ElFormItem>
+
       <template v-if="supportsExternalConnection">
         <div class="form-grid">
           <ElFormItem label="主机">
@@ -242,6 +351,7 @@ defineExpose({ close, open, setTestResult });
 
     <template #footer-extra>
       <EasyFlowButton
+        v-if="supportsExternalConnection"
         variant="outline"
         :loading="testing"
         :disabled="saving"
@@ -308,6 +418,62 @@ defineExpose({ close, open, setTestResult });
   grid-column: 1 / -1;
 }
 
+.excel-file-field {
+  margin-bottom: 0;
+}
+
+.excel-upload {
+  width: 100%;
+}
+
+.excel-upload :deep(.el-upload) {
+  width: 100%;
+}
+
+.excel-upload :deep(.el-upload-dragger) {
+  width: 100%;
+  padding: 24px;
+  background: hsl(var(--surface-subtle) / 72%);
+  border-color: hsl(var(--border) / 76%);
+  border-radius: var(--radius-panel);
+  transition:
+    background-color 0.16s,
+    border-color 0.16s;
+}
+
+.excel-upload :deep(.el-upload-dragger:hover),
+.excel-upload :deep(.el-upload-dragger:focus-visible) {
+  background: hsl(var(--primary) / 5%);
+  border-color: hsl(var(--primary) / 56%);
+}
+
+.excel-upload__icon {
+  margin-bottom: 8px;
+  font-size: 28px;
+  color: hsl(var(--primary));
+}
+
+.excel-upload__title {
+  font-size: 14px;
+  font-weight: 600;
+  color: hsl(var(--foreground));
+}
+
+.excel-upload__description {
+  margin-top: 6px;
+  font-size: 12px;
+  line-height: 1.5;
+  color: hsl(var(--muted-foreground));
+}
+
+.excel-upload :deep(.el-upload-list) {
+  margin-top: 8px;
+}
+
+.excel-upload :deep(.el-upload-list__item) {
+  border-radius: var(--radius-control);
+}
+
 .toggle-advanced {
   display: inline-flex;
   align-items: center;
diff --git a/easyflow-ui-admin/app/src/views/datacenter/components/TableDetailView.vue b/easyflow-ui-admin/app/src/views/datacenter/components/TableDetailView.vue
index 8c200e0d..d752a9b0 100644
--- a/easyflow-ui-admin/app/src/views/datacenter/components/TableDetailView.vue
+++ b/easyflow-ui-admin/app/src/views/datacenter/components/TableDetailView.vue
@@ -101,7 +101,7 @@ async function saveFieldDescription(field: any) {
               v-for="field in schema?.fields || []"
               :key="field.fieldName"
               :prop="field.fieldName"
-              :label="field.fieldName"
+              :label="field.fieldDesc || field.fieldName"
               min-width="140"
             />
           </ElTable>
diff --git a/easyflow-ui-admin/app/src/views/datacenter/composables/datacenter-excel-upload.test.ts b/easyflow-ui-admin/app/src/views/datacenter/composables/datacenter-excel-upload.test.ts
new file mode 100644
index 00000000..443b514d
--- /dev/null
+++ b/easyflow-ui-admin/app/src/views/datacenter/composables/datacenter-excel-upload.test.ts
@@ -0,0 +1,22 @@
+import { describe, expect, it } from 'vitest';
+
+import {
+  isSupportedExcelFileName,
+  sourceNameFromExcelFileName,
+} from './datacenter-excel-upload';
+
+describe('datacenter Excel upload', () => {
+  it('accepts only xls and xlsx extensions', () => {
+    expect(isSupportedExcelFileName('预算表.XLS')).toBe(true);
+    expect(isSupportedExcelFileName('预算表.xlsx')).toBe(true);
+    expect(isSupportedExcelFileName('预算表.xlsm')).toBe(false);
+    expect(isSupportedExcelFileName('预算表.csv')).toBe(false);
+  });
+
+  it('derives the connection name from the final extension', () => {
+    expect(sourceNameFromExcelFileName('ama 实验基线模型预算.xlsx')).toBe(
+      'ama 实验基线模型预算',
+    );
+    expect(sourceNameFromExcelFileName('模型预算.v2.xls')).toBe('模型预算.v2');
+  });
+});
diff --git a/easyflow-ui-admin/app/src/views/datacenter/composables/datacenter-excel-upload.ts b/easyflow-ui-admin/app/src/views/datacenter/composables/datacenter-excel-upload.ts
new file mode 100644
index 00000000..87e4cdc9
--- /dev/null
+++ b/easyflow-ui-admin/app/src/views/datacenter/composables/datacenter-excel-upload.ts
@@ -0,0 +1,22 @@
+export const EXCEL_FILE_ACCEPT = '.xls,.xlsx';
+
+/**
+ * 判断文件名是否属于数据中枢支持的 Excel 格式。
+ */
+export function isSupportedExcelFileName(fileName: string) {
+  const normalizedFileName = fileName.trim().toLowerCase();
+  return (
+    normalizedFileName.endsWith('.xls') || normalizedFileName.endsWith('.xlsx')
+  );
+}
+
+/**
+ * 从 Excel 文件名生成默认连接名称。
+ */
+export function sourceNameFromExcelFileName(fileName: string) {
+  const trimmedFileName = fileName.trim();
+  const extensionIndex = trimmedFileName.lastIndexOf('.');
+  return extensionIndex > 0
+    ? trimmedFileName.slice(0, extensionIndex)
+    : trimmedFileName;
+}
diff --git a/easyflow-ui-admin/app/src/views/datacenter/composables/datacenter-id.ts b/easyflow-ui-admin/app/src/views/datacenter/composables/datacenter-id.ts
new file mode 100644
index 00000000..2aed727d
--- /dev/null
+++ b/easyflow-ui-admin/app/src/views/datacenter/composables/datacenter-id.ts
@@ -0,0 +1,4 @@
+/**
+ * 数据中枢接口中的雪花主键会以字符串返回，避免 JavaScript Number 丢失精度。
+ */
+export type DatacenterId = string;
diff --git a/easyflow-ui-admin/app/src/views/datacenter/composables/use-connection-tree.ts b/easyflow-ui-admin/app/src/views/datacenter/composables/use-connection-tree.ts
index 5e44a2dd..9487fe73 100644
--- a/easyflow-ui-admin/app/src/views/datacenter/composables/use-connection-tree.ts
+++ b/easyflow-ui-admin/app/src/views/datacenter/composables/use-connection-tree.ts
@@ -1,5 +1,7 @@
 import type { Ref } from 'vue';
 
+import type { DatacenterId } from './datacenter-id';
+
 import { computed } from 'vue';
 
 import { formatSourceType, formatTestStatus } from './datacenter-constants';
@@ -49,7 +51,7 @@ export function useConnectionTree(sources: Ref<any[]>) {
     const id = idParts.join('-');
     return {
       type: type as 'source' | 'table',
-      id: Number(id),
+      id: id as DatacenterId,
     };
   }
 
diff --git a/easyflow-ui-admin/app/src/views/datacenter/composables/use-datacenter-sources.ts b/easyflow-ui-admin/app/src/views/datacenter/composables/use-datacenter-sources.ts
index f7690e36..205528e7 100644
--- a/easyflow-ui-admin/app/src/views/datacenter/composables/use-datacenter-sources.ts
+++ b/easyflow-ui-admin/app/src/views/datacenter/composables/use-datacenter-sources.ts
@@ -1,3 +1,5 @@
+import type { DatacenterId } from './datacenter-id';
+
 import { computed, ref } from 'vue';
 
 import { api } from '#/api/request';
@@ -6,7 +8,7 @@ import { mergeConfigJsonBySourceType } from './datacenter-constants';
 
 export function useDatacenterSources() {
   const sources = ref<any[]>([]);
-  const selectedSourceId = ref<null | number>(null);
+  const selectedSourceId = ref<DatacenterId | null>(null);
   const loading = ref(false);
   const saving = ref(false);
   const testing = ref(false);
@@ -32,7 +34,7 @@ export function useDatacenterSources() {
       return;
     }
     if (
-      !selectedSourceId.value ||
+      selectedSourceId.value === null ||
       !sources.value.some((item) => item.id === selectedSourceId.value)
     ) {
       selectedSourceId.value = sources.value[0].id;
@@ -54,7 +56,7 @@ export function useDatacenterSources() {
   }
 
   function markSourceRuntimeUnavailable(sourceId?: null | number | string) {
-    if (!sourceId) return;
+    if (sourceId === null || sourceId === undefined) return;
     sources.value = sources.value.map((item) =>
       String(item.id) === String(sourceId)
         ? { ...item, runtimeUnavailable: true }
@@ -63,7 +65,7 @@ export function useDatacenterSources() {
   }
 
   function clearSourceRuntimeUnavailable(sourceId?: null | number | string) {
-    if (!sourceId) return;
+    if (sourceId === null || sourceId === undefined) return;
     sources.value = sources.value.map((item) =>
       String(item.id) === String(sourceId)
         ? { ...item, runtimeUnavailable: false }
@@ -71,7 +73,7 @@ export function useDatacenterSources() {
     );
   }
 
-  function removeSourceFromState(sourceId: number) {
+  function removeSourceFromState(sourceId: DatacenterId) {
     sources.value = sources.value.filter((item) => item.id !== sourceId);
     syncSelectedSourceAfterMutation();
   }
@@ -126,6 +128,26 @@ export function useDatacenterSources() {
     }
   }
 
+  async function importExcelSource(file: File, sourceName: string) {
+    saving.value = true;
+    try {
+      const formData = new FormData();
+      formData.append('file', file);
+      formData.append('sourceName', sourceName.trim());
+      const res = await api.postFile(
+        '/api/v1/datacenterExcel/import',
+        formData,
+        {
+          timeout: 10 * 60 * 1000,
+        },
+      );
+      selectedSourceId.value = res.data?.sourceId || null;
+      return res.data;
+    } finally {
+      saving.value = false;
+    }
+  }
+
   async function testConnection(target: Record<string, any>) {
     testing.value = true;
     try {
@@ -164,7 +186,7 @@ export function useDatacenterSources() {
     }
   }
 
-  async function removeSource(sourceId: number) {
+  async function removeSource(sourceId: DatacenterId) {
     await api.post('/api/v1/datacenterSource/remove', { sourceId });
     removeSourceFromState(sourceId);
   }
@@ -176,6 +198,7 @@ export function useDatacenterSources() {
     loading,
     saving,
     testing,
+    importExcelSource,
     loadSources,
     removeSource,
     removeSourceFromState,
diff --git a/easyflow-ui-admin/app/src/views/datacenter/composables/use-datacenter-tables.ts b/easyflow-ui-admin/app/src/views/datacenter/composables/use-datacenter-tables.ts
index 1783c6cc..9c695537 100644
--- a/easyflow-ui-admin/app/src/views/datacenter/composables/use-datacenter-tables.ts
+++ b/easyflow-ui-admin/app/src/views/datacenter/composables/use-datacenter-tables.ts
@@ -1,5 +1,7 @@
 import type { Ref } from 'vue';
 
+import type { DatacenterId } from './datacenter-id';
+
 import { computed, ref } from 'vue';
 
 import { ElMessage } from 'element-plus';
@@ -7,12 +9,12 @@ import { ElMessage } from 'element-plus';
 import { requestClient } from '#/api/request';
 
 interface DatacenterTableRuntimeOptions {
-  clearSourceRuntimeUnavailable?: (sourceId?: null | number | string) => void;
-  markSourceRuntimeUnavailable?: (sourceId?: null | number | string) => void;
+  clearSourceRuntimeUnavailable?: (sourceId?: DatacenterId | null) => void;
+  markSourceRuntimeUnavailable?: (sourceId?: DatacenterId | null) => void;
 }
 
 export function useDatacenterTables(
-  selectedSourceId: Ref<null | number>,
+  selectedSourceId: Ref<DatacenterId | null>,
   options: DatacenterTableRuntimeOptions = {},
 ) {
   const SOURCE_MISSING_MESSAGE = '连接不存在';
@@ -24,8 +26,8 @@ export function useDatacenterTables(
   const previewRows = ref<any[]>([]);
   const jobs = ref<any[]>([]);
   const sourceUnavailable = ref(false);
-  const selectedCatalogId = ref<null | number>(null);
-  const selectedTableId = ref<null | number>(null);
+  const selectedCatalogId = ref<DatacenterId | null>(null);
+  const selectedTableId = ref<DatacenterId | null>(null);
   const previewLoading = ref(false);
 
   const selectedCatalog = computed(
@@ -66,7 +68,7 @@ export function useDatacenterTables(
   }
 
   async function loadCatalogs() {
-    if (!selectedSourceId.value) {
+    if (selectedSourceId.value === null) {
       catalogs.value = [];
       selectedCatalogId.value = null;
       sourceUnavailable.value = false;
@@ -87,7 +89,7 @@ export function useDatacenterTables(
         return true;
       }
       if (
-        !selectedCatalogId.value ||
+        selectedCatalogId.value === null ||
         !catalogs.value.some((item) => item.id === selectedCatalogId.value)
       ) {
         selectedCatalogId.value = catalogs.value[0].id;
@@ -107,7 +109,7 @@ export function useDatacenterTables(
   }
 
   async function loadSourceTables() {
-    if (!selectedSourceId.value) {
+    if (selectedSourceId.value === null) {
       sourceTables.value = [];
       return;
     }
@@ -130,7 +132,7 @@ export function useDatacenterTables(
   }
 
   async function loadManagedTables() {
-    if (!selectedSourceId.value) {
+    if (selectedSourceId.value === null) {
       managedTables.value = [];
       selectedTableId.value = null;
       return;
@@ -158,7 +160,7 @@ export function useDatacenterTables(
       return;
     }
     if (
-      !selectedTableId.value ||
+      selectedTableId.value === null ||
       !managedTables.value.some((item) => item.id === selectedTableId.value)
     ) {
       selectedTableId.value = managedTables.value[0].id;
@@ -166,7 +168,7 @@ export function useDatacenterTables(
   }
 
   async function loadTableRuntime() {
-    if (!selectedTableId.value) {
+    if (selectedTableId.value === null) {
       schema.value = null;
       previewRows.value = [];
       jobs.value = [];
@@ -279,7 +281,10 @@ export function useDatacenterTables(
       tableIds,
     });
     ElMessage.success(`已去除 ${tableIds.length} 张表`);
-    if (selectedTableId.value && tableIds.includes(selectedTableId.value)) {
+    if (
+      selectedTableId.value !== null &&
+      tableIds.includes(selectedTableId.value)
+    ) {
       selectedTableId.value = null;
       schema.value = null;
       previewRows.value = [];
diff --git a/easyflow-ui-admin/app/src/views/datacenter/composables/use-source-form.ts b/easyflow-ui-admin/app/src/views/datacenter/composables/use-source-form.ts
index a847094b..923327eb 100644
--- a/easyflow-ui-admin/app/src/views/datacenter/composables/use-source-form.ts
+++ b/easyflow-ui-admin/app/src/views/datacenter/composables/use-source-form.ts
@@ -16,7 +16,7 @@ export function useSourceForm() {
     id: undefined,
     sourceName: '',
     sourceCode: '',
-    sourceType: 'MYSQL',
+    sourceType: 'EXCEL',
     accessMode: 'READ_ONLY',
     driverClassName: '',
     jdbcUrl: '',
@@ -33,6 +33,11 @@ export function useSourceForm() {
   const rules: FormRules = {
     sourceName: [
       { required: true, message: '请输入连接名称', trigger: 'blur' },
+      {
+        max: 100,
+        message: '连接名称不能超过 100 个字符',
+        trigger: ['blur', 'change'],
+      },
     ],
     sourceType: [
       { required: true, message: '请选择连接类型', trigger: 'change' },
@@ -138,7 +143,7 @@ export function useSourceForm() {
     form.id = row?.id;
     form.sourceName = row?.sourceName || '';
     form.sourceCode = row?.sourceCode || '';
-    form.sourceType = row?.sourceType || 'MYSQL';
+    form.sourceType = row?.sourceType || 'EXCEL';
     form.accessMode = row?.accessMode || 'READ_ONLY';
     form.driverClassName = row?.driverClassName || '';
     form.jdbcUrl = row?.jdbcUrl || '';
diff --git a/easyflow-ui-admin/packages/effects/common-ui/src/ui/form-modal/form-modal.vue b/easyflow-ui-admin/packages/effects/common-ui/src/ui/form-modal/form-modal.vue
index e2ba4f5b..e39a001a 100644
--- a/easyflow-ui-admin/packages/effects/common-ui/src/ui/form-modal/form-modal.vue
+++ b/easyflow-ui-admin/packages/effects/common-ui/src/ui/form-modal/form-modal.vue
@@ -15,6 +15,7 @@ interface Props {
   centered?: boolean;
   closable?: boolean;
   closeOnClickModal?: boolean;
+  confirmDisabled?: boolean;
   confirmLoading?: boolean;
   confirmText?: string;
   description?: string;
@@ -40,6 +41,7 @@ const props = withDefaults(defineProps<Props>(), {
   centered: false,
   closable: true,
   closeOnClickModal: false,
+  confirmDisabled: false,
   confirmLoading: false,
   confirmText: '',
   description: '',
@@ -124,6 +126,7 @@ function handleConfirm() {
     :centered="centered"
     :closable="closable"
     :close-on-click-modal="closeOnClickModal"
+    :confirm-disabled="confirmDisabled || submitting"
     :confirm-loading="confirmLoading"
     content-class="p-0"
     :description="description"
@@ -164,7 +167,7 @@ function handleConfirm() {
           </EasyFlowButton>
           <EasyFlowButton
             v-if="showConfirmButton"
-            :disabled="submitting"
+            :disabled="confirmDisabled || submitting"
             :loading="confirmLoading || submitting"
             @click="handleConfirm"
           >