openxiangda 1.0.0

package/packages/sdk/src/build-source/scripts/utils/load-config.mjs

@@ -0,0 +1,257 @@
+import { config as dotenvConfig } from "dotenv";
+import { resolve } from "path";
+import { pathToFileURL } from "url";
+
+export const rootDir = resolve(process.env.LOWCODE_WORKSPACE_ROOT || process.cwd());
+
+/**
+ * 标准化 OSS 路径前缀，去除前后斜杠
+ * @param {string|undefined} pathPrefix
+ * @returns {string}
+ */
+function normalizePathPrefix(pathPrefix) {
+  return String(pathPrefix || "app-workspace").replace(/^\/+|\/+$/g, "");
+}
+
+/**
+ * 解析逗号分隔的字符串为数组
+ * @param {string|undefined} value
+ * @param {string} [fallback]
+ * @returns {string[]}
+ */
+function parseCsv(value, fallback) {
+  return String(value || fallback || "")
+    .split(",")
+    .map((item) => item.trim())
+    .filter(Boolean);
+}
+
+function getDefaultCorsOrigin(platformUrl) {
+  try {
+    return new URL(platformUrl).origin;
+  } catch {
+    return "*";
+  }
+}
+
+function createBuildId() {
+  return new Date().toISOString().replace(/[-:TZ.]/g, "").slice(0, 14);
+}
+
+function normalizeBaseUrl(value) {
+  return String(value || "").replace(/\/+$/, "");
+}
+
+function normalizeCssIsolation(value) {
+  if (value === "none") return "none";
+  if (value === "shadow") {
+    console.warn(
+      "[lowcode-workspace] cssIsolation='shadow' is deprecated; use 'namespace' instead.",
+    );
+    return "shadow";
+  }
+  return "namespace";
+}
+
+export function resolveOpenXiangdaEndpointConfig(baseUrl) {
+  const raw = normalizeBaseUrl(baseUrl);
+  if (!raw) {
+    return { platformUrl: "", servicePrefix: "" };
+  }
+
+  try {
+    const url = new URL(raw);
+    const cleanPath = url.pathname.replace(/\/+$/, "");
+    if (
+      !cleanPath ||
+      cleanPath === "/platform" ||
+      cleanPath.startsWith("/platform/") ||
+      cleanPath === "/view" ||
+      cleanPath.startsWith("/view/")
+    ) {
+      return { platformUrl: url.origin, servicePrefix: "/service" };
+    }
+    return { platformUrl: `${url.origin}${cleanPath}`, servicePrefix: "" };
+  } catch {
+    return { platformUrl: raw, servicePrefix: "" };
+  }
+}
+
+async function loadConfigModule() {
+  const configPath = resolve(rootDir, "app-workspace.config.ts");
+  const loaded = await import(pathToFileURL(configPath).href);
+  return loaded.default || loaded;
+}
+
+/**
+ * 加载并合并应用配置（文件 + 环境变量）
+ * @returns {Promise<object>} 合并后的应用配置对象
+ */
+export async function loadConfig() {
+  const mode = process.env.APP_MODE || "development";
+
+  if (mode !== "development") {
+    dotenvConfig({ path: resolve(rootDir, `.env.${mode}`) });
+  }
+  dotenvConfig({ path: resolve(rootDir, ".env") });
+
+  const source = await loadConfigModule();
+  const openXiangdaMode = Boolean(
+    process.env.OPENXIANGDA_ACCESS_TOKEN || process.env.OPENXIANGDA_BASE_URL,
+  );
+  const openXiangdaEndpoint = process.env.OPENXIANGDA_BASE_URL
+    ? resolveOpenXiangdaEndpointConfig(process.env.OPENXIANGDA_BASE_URL)
+    : null;
+  const platformUrl = openXiangdaEndpoint
+    ? openXiangdaEndpoint.platformUrl
+    : source.platformUrl || process.env.APP_PLATFORM_URL;
+  const explicitBuildId = Boolean(source.buildId || process.env.APP_BUILD_ID);
+
+  const normalized = {
+    ...source,
+    appType: process.env.OPENXIANGDA_APP_TYPE || source.appType || process.env.APP_TYPE,
+    appName: source.appName || process.env.APP_NAME || "低代码应用",
+    platformUrl,
+    servicePrefix:
+      openXiangdaEndpoint?.servicePrefix ??
+      (source.servicePrefix ||
+        process.env.APP_SERVICE_PREFIX ||
+        (openXiangdaMode ? "" : "/service")),
+    openXiangdaAccessToken: process.env.OPENXIANGDA_ACCESS_TOKEN || "",
+    openXiangdaProfile: process.env.OPENXIANGDA_PROFILE || "",
+    appKey: source.appKey || process.env.APP_KEY,
+    appSecret: source.appSecret || process.env.APP_SECRET,
+    userId: source.userId || process.env.APP_USER_ID,
+    version: source.version || process.env.APP_VERSION || "0.1.0",
+    buildId: source.buildId || process.env.APP_BUILD_ID || createBuildId(),
+    buildIdExplicit: explicitBuildId,
+    oss: {
+      ...(source.oss || {}),
+      region: source.oss?.region || process.env.APP_OSS_REGION,
+      bucket: source.oss?.bucket || process.env.APP_OSS_BUCKET,
+      accessKeyId:
+        source.oss?.accessKeyId || process.env.APP_OSS_ACCESS_KEY_ID,
+      accessKeySecret:
+        source.oss?.accessKeySecret || process.env.APP_OSS_ACCESS_KEY_SECRET,
+      pathPrefix: normalizePathPrefix(
+        source.oss?.pathPrefix || process.env.APP_OSS_PATH_PREFIX,
+      ),
+      corsOrigins: parseCsv(
+        process.env.APP_OSS_CORS_ORIGINS,
+        getDefaultCorsOrigin(platformUrl),
+      ),
+      skipCors: process.env.APP_OSS_SKIP_CORS === "1" || source.oss?.skipCors,
+    },
+    defaults: {
+      protocolVersion:
+        source.defaults?.protocolVersion ||
+        process.env.APP_PAGE_PROTOCOL_VERSION ||
+        "1.0",
+      frameworkVersion:
+        source.defaults?.frameworkVersion ||
+        process.env.APP_FRAMEWORK_VERSION ||
+        "18.3.1",
+      cssIsolation: normalizeCssIsolation(
+        process.env.APP_PAGE_CSS_ISOLATION || source.defaults?.cssIsolation,
+      ),
+      formMenuParentId:
+        source.defaults?.formMenuParentId ||
+        process.env.APP_FORM_MENU_PARENT_ID ||
+        "",
+      formMenuIcon:
+        source.defaults?.formMenuIcon || process.env.APP_FORM_MENU_ICON || "",
+      pageMenuParentId:
+        source.defaults?.pageMenuParentId ||
+        process.env.APP_PAGE_MENU_PARENT_ID ||
+        "",
+      pageMenuIcon:
+        source.defaults?.pageMenuIcon || process.env.APP_PAGE_MENU_ICON || "",
+      formBuilderVersion:
+        source.defaults?.formBuilderVersion ||
+        process.env.APP_FORM_BUILDER_VERSION ||
+        "2.0",
+    },
+  };
+
+  return {
+    ...normalized,
+    menu: {
+      parentId: normalized.defaults.formMenuParentId,
+      icon: normalized.defaults.formMenuIcon,
+    },
+  };
+}
+
+/**
+ * 获取后端 API 基础 URL
+ * @param {object} config - 应用配置对象
+ * @returns {string}
+ */
+export function getApiBaseUrl(config) {
+  return `${normalizeBaseUrl(config.platformUrl)}${config.servicePrefix}`;
+}
+
+/**
+ * 获取 OSS 公网访问基础 URL
+ * @param {object} config - 应用配置对象
+ * @returns {string}
+ */
+export function getPublicBaseUrl(config) {
+  return `https://${config.oss.bucket}.${config.oss.region}.aliyuncs.com/${config.oss.pathPrefix}/${config.version}/${config.buildId}`;
+}
+
+/**
+ * 获取表单 bundle 文件的公网 URL
+ * @param {object} config - 应用配置对象
+ * @param {string} formName - 表单名
+ * @param {string} fileName - 文件名
+ * @returns {string}
+ */
+export function getFormBundleUrl(config, formName, fileName) {
+  return `${getPublicBaseUrl(config)}/forms/${formName}/${fileName}`;
+}
+
+/**
+ * 获取表单共享 runtime 文件的公网 URL
+ * @param {object} config - 应用配置对象
+ * @param {string} fileName - 文件名
+ * @returns {string}
+ */
+export function getFormRuntimeUrl(config, fileName) {
+  return `${getPublicBaseUrl(config)}/form-runtime/${fileName}`;
+}
+
+/**
+ * 获取代码页资源基础 URL
+ * @param {object} config - 应用配置对象
+ * @param {string} pageCode - 页面编码
+ * @returns {string}
+ */
+export function getPageAssetBaseUrl(config, pageCode) {
+  return `${getPublicBaseUrl(config)}/pages/${pageCode}`;
+}
+
+/**
+ * 获取代码页指定资源的公网 URL
+ * @param {object} config - 应用配置对象
+ * @param {string} pageCode - 页面编码
+ * @param {string} fileName - 文件名
+ * @returns {string}
+ */
+export function getPageAssetUrl(config, pageCode, fileName) {
+  return `${getPageAssetBaseUrl(config, pageCode)}/${fileName}`;
+}
+
+/**
+ * 获取代码页共享 runtime 文件的公网 URL
+ * @param {object} config - 应用配置对象
+ * @param {string} fileName - 文件名
+ * @returns {string}
+ */
+export function getPageRuntimeUrl(config, fileName) {
+  return `${getPublicBaseUrl(config)}/page-runtime/${fileName}`;
+}
+
+export function getBundleOSSUrl(config, formName, fileName) {
+  return getFormBundleUrl(config, formName, fileName);
+}

package/packages/sdk/src/build-source/scripts/utils/load-config.test.ts

@@ -0,0 +1,44 @@
+import { describe, expect, it } from "vitest";
+
+import {
+  getApiBaseUrl,
+  resolveOpenXiangdaEndpointConfig,
+} from "./load-config.mjs";
+
+describe("OpenXiangda endpoint config", () => {
+  it("treats /service base as the complete API base", () => {
+    const config = resolveOpenXiangdaEndpointConfig(
+      "https://yida.wisejob.cn/service",
+    );
+
+    expect(config).toEqual({
+      platformUrl: "https://yida.wisejob.cn/service",
+      servicePrefix: "",
+    });
+    expect(getApiBaseUrl(config)).toBe("https://yida.wisejob.cn/service");
+  });
+
+  it("maps root, platform, and view urls to the service API base", () => {
+    const inputs = [
+      "https://yida.wisejob.cn/",
+      "https://yida.wisejob.cn/platform",
+      "https://yida.wisejob.cn/platform/apps",
+      "https://yida.wisejob.cn/view/app",
+    ];
+
+    for (const input of inputs) {
+      const config = resolveOpenXiangdaEndpointConfig(input);
+      expect(getApiBaseUrl(config)).toBe("https://yida.wisejob.cn/service");
+    }
+  });
+
+  it("preserves custom gateway paths as complete API bases", () => {
+    const config = resolveOpenXiangdaEndpointConfig(
+      "https://gateway.example.com/private-api",
+    );
+
+    expect(getApiBaseUrl(config)).toBe(
+      "https://gateway.example.com/private-api",
+    );
+  });
+});

package/packages/sdk/src/build-source/scripts/utils/mime-types.mjs

@@ -0,0 +1,70 @@
+/**
+ * mime-types.mjs - MIME 类型映射
+ *
+ * 提供文件扩展名到 MIME 类型的映射，支持 JS/CSS/JSON/HTML、
+ * 图片、字体和其他常见静态资源类型。
+ */
+
+import path from "node:path";
+
+/** @type {Record<string, string>} 扩展名 → MIME 类型映射表 */
+const MIME_MAP = {
+  // 脚本 & 样式
+  ".js": "application/javascript",
+  ".mjs": "application/javascript",
+  ".css": "text/css",
+  ".json": "application/json",
+  ".html": "text/html",
+  // 图片
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".gif": "image/gif",
+  ".svg": "image/svg+xml",
+  ".webp": "image/webp",
+  ".ico": "image/x-icon",
+  ".avif": "image/avif",
+  // 字体
+  ".woff": "font/woff",
+  ".woff2": "font/woff2",
+  ".ttf": "font/ttf",
+  ".eot": "application/vnd.ms-fontobject",
+  // 其他
+  ".map": "application/json",
+};
+
+/**
+ * 根据文件路径获取对应的 MIME 类型
+ * @param {string} file - 文件路径
+ * @returns {string} MIME 类型
+ */
+export function getContentType(file) {
+  const ext = path.extname(file).toLowerCase();
+  return MIME_MAP[ext] || "application/octet-stream";
+}
+
+/**
+ * 判断文件名是否包含 content hash（如 logo-abc123.png）
+ * 匹配模式：name-[8+位hex hash].ext
+ * @param {string} file - 文件名或路径
+ * @returns {boolean}
+ */
+export function hasContentHash(file) {
+  const basename = path.basename(file);
+  return /\-[a-f0-9]{8,}\.[^.]+$/.test(basename);
+}
+
+/**
+ * 根据文件特征返回合适的 Cache-Control 头
+ * - 带 content hash 的资源 → 长期缓存 + immutable
+ * - 其他文件 → 长期缓存（依赖 buildId 路径做版本隔离）
+ * @param {string} file - 文件路径
+ * @returns {string} Cache-Control 头值
+ */
+export function getCacheControl(file) {
+  if (hasContentHash(file)) {
+    return "public, max-age=31536000, immutable";
+  }
+  // 入口文件依赖 buildId 路径做版本隔离，同样可以长期缓存
+  return "public, max-age=31536000";
+}

package/packages/sdk/src/build-source/scripts/utils/namespace-css.mjs

@@ -0,0 +1,61 @@
+const DEFAULT_PREFIX = ".sy-app-workspace";
+
+function splitSelectors(selector) {
+  const selectors = [];
+  let depth = 0;
+  let quote = "";
+  let current = "";
+  for (const char of selector) {
+    if (quote) {
+      current += char;
+      if (char === quote) quote = "";
+      continue;
+    }
+    if (char === '"' || char === "'") {
+      quote = char;
+      current += char;
+      continue;
+    }
+    if (char === "(" || char === "[") depth += 1;
+    if (char === ")" || char === "]") depth -= 1;
+    if (char === "," && depth === 0) {
+      selectors.push(current.trim());
+      current = "";
+      continue;
+    }
+    current += char;
+  }
+  if (current.trim()) selectors.push(current.trim());
+  return selectors;
+}
+
+function shouldSkipSelector(selector, prefix) {
+  if (!selector || selector.includes(prefix)) return true;
+  if (/^(html|body|:root)(\b|:|\[|$)/.test(selector)) return true;
+  if (/^(@|from\b|to\b|\d+%)/.test(selector)) return true;
+  if (/^\.(ant|sy-ant|anticon|adm)-/.test(selector)) return true;
+  return false;
+}
+
+export function createNamespaceCssPlugin(prefix = DEFAULT_PREFIX) {
+  return {
+    postcssPlugin: "openxiangda-namespace-css",
+    Rule(rule) {
+      if (!rule.selector) return;
+      let parent = rule.parent;
+      while (parent) {
+        if (parent.type === "atrule" && /keyframes$/i.test(parent.name)) {
+          return;
+        }
+        parent = parent.parent;
+      }
+      rule.selector = splitSelectors(rule.selector)
+        .map((selector) =>
+          shouldSkipSelector(selector, prefix) ? selector : `${prefix} ${selector}`,
+        )
+        .join(", ");
+    },
+  };
+}
+
+createNamespaceCssPlugin.postcss = true;

package/packages/sdk/src/build-source/scripts/utils/oss-client.mjs

@@ -0,0 +1,128 @@
+/**
+ * oss-client.mjs - 阿里云 OSS 客户端工具
+ *
+ * 封装 OSS 客户端初始化、带重试的上传、以及 CORS 规则确保。
+ */
+
+import OSS from "ali-oss";
+
+/**
+ * 创建阿里云 OSS 客户端实例
+ * @param {object} ossConfig - OSS 配置
+ * @param {string} ossConfig.region - OSS Region
+ * @param {string} ossConfig.bucket - Bucket 名称
+ * @param {string} ossConfig.accessKeyId - AccessKey ID
+ * @param {string} ossConfig.accessKeySecret - AccessKey Secret
+ * @returns {import("ali-oss")} OSS 客户端实例
+ */
+export function createOSSClient(ossConfig) {
+  return new OSS({
+    region: ossConfig.region,
+    accessKeyId: ossConfig.accessKeyId,
+    accessKeySecret: ossConfig.accessKeySecret,
+    bucket: ossConfig.bucket,
+  });
+}
+
+/**
+ * 带重试机制的 OSS 上传
+ * @param {import("ali-oss")} client - OSS 客户端实例
+ * @param {string} ossKey - OSS 对象键
+ * @param {string} localPath - 本地文件路径
+ * @param {object} headers - HTTP 头（Cache-Control, Content-Type 等）
+ * @param {number} [retries=3] - 最大重试次数
+ * @returns {Promise<void>}
+ */
+export async function uploadWithRetry(client, ossKey, localPath, headers, retries = 3) {
+  for (let i = 0; i < retries; i++) {
+    try {
+      await client.put(ossKey, localPath, { headers });
+      return;
+    } catch (err) {
+      if (i === retries - 1) throw err;
+      console.warn(`  ⚠ 重试 ${i + 1}/${retries}: ${ossKey}`);
+      await new Promise((r) => setTimeout(r, 1000 * (i + 1)));
+    }
+  }
+}
+
+/**
+ * @param {*} value
+ * @returns {string[]}
+ */
+function toArray(value) {
+  if (Array.isArray(value)) return value;
+  if (value === undefined || value === null || value === "") return [];
+  return [value];
+}
+
+/**
+ * 检查单条 CORS 规则是否已满足指定 origins 和 methods
+ * @param {object} rule - CORS 规则对象
+ * @param {string[]} origins - 需要允许的来源
+ * @param {string[]} methods - 需要允许的方法
+ * @returns {boolean}
+ */
+function corsRuleAllows(rule, origins, methods) {
+  const allowedOrigins = toArray(rule.allowedOrigin);
+  const allowedMethods = toArray(rule.allowedMethod).map((item) =>
+    String(item).toUpperCase(),
+  );
+
+  const originAllowed =
+    allowedOrigins.includes("*") ||
+    origins.every((origin) => allowedOrigins.includes(origin));
+  const methodAllowed = methods.every((method) =>
+    allowedMethods.includes(method),
+  );
+
+  return originAllowed && methodAllowed;
+}
+
+/**
+ * 确保 OSS Bucket 的 CORS 规则满足前端资源加载需求
+ * @param {import("ali-oss")} client - OSS 客户端实例
+ * @param {object} ossConfig - OSS 配置
+ * @param {string} ossConfig.bucket - Bucket 名称
+ * @param {boolean} [ossConfig.skipCors] - 是否跳过 CORS 检查
+ * @param {string[]} [ossConfig.corsOrigins] - 允许的来源列表
+ * @returns {Promise<void>}
+ */
+export async function ensureBucketCors(client, ossConfig) {
+  if (ossConfig.skipCors) {
+    console.log("   CORS: 跳过（APP_OSS_SKIP_CORS=1）");
+    return;
+  }
+
+  const origins = ossConfig.corsOrigins?.length
+    ? ossConfig.corsOrigins
+    : ["*"];
+  const methods = ["GET", "HEAD"];
+  let rules = [];
+
+  try {
+    const result = await client.getBucketCORS(ossConfig.bucket);
+    rules = Array.isArray(result.rules) ? result.rules : [];
+  } catch (error) {
+    if (error?.status !== 404 && error?.code !== "NoSuchCORSConfiguration") {
+      throw error;
+    }
+  }
+
+  if (rules.some((rule) => corsRuleAllows(rule, origins, methods))) {
+    console.log(`   CORS: 已允许 ${origins.join(", ")}`);
+    return;
+  }
+
+  await client.putBucketCORS(ossConfig.bucket, [
+    ...rules,
+    {
+      allowedOrigin: origins,
+      allowedMethod: methods,
+      allowedHeader: "*",
+      exposeHeader: ["ETag", "Content-Length", "Content-Type"],
+      maxAgeSeconds: "3600",
+    },
+  ]);
+  console.log(`   CORS: 已配置 ${origins.join(", ")}`);
+}

package/packages/sdk/src/build-source/scripts/utils/pages.mjs

@@ -0,0 +1,80 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { rootDir as workspaceRoot } from "./load-config.mjs";
+
+export const rootDir = workspaceRoot;
+export const srcRoot = path.join(rootDir, "src");
+export const formsRoot = path.join(srcRoot, "forms");
+export const pagesRoot = path.join(srcRoot, "pages");
+export const distRoot = path.join(rootDir, "dist");
+
+async function fileExists(targetPath) {
+  try {
+    await fs.access(targetPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function loadTypeScriptModule(filePath) {
+  const loaded = await import(pathToFileURL(filePath).href);
+  return loaded.default || loaded;
+}
+
+export async function discoverPages(filterName = "") {
+  if (!(await fileExists(pagesRoot))) {
+    return [];
+  }
+
+  const entries = await fs.readdir(pagesRoot, { withFileTypes: true });
+  const pages = [];
+
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    if (filterName && entry.name !== filterName) continue;
+
+    const dirPath = path.join(pagesRoot, entry.name);
+    const entryPath = path.join(dirPath, "index.tsx");
+    const appPath = path.join(dirPath, "App.tsx");
+    const configPath = path.join(dirPath, "page.config.ts");
+    const required = [entryPath, appPath, configPath];
+    const exists = await Promise.all(required.map(fileExists));
+    if (exists.every((item) => !item)) continue;
+    for (let index = 0; index < required.length; index += 1) {
+      if (!exists[index]) {
+        throw new Error(`页面 ${entry.name} 缺少文件: ${path.basename(required[index])}`);
+      }
+    }
+
+    const config = await loadTypeScriptModule(configPath);
+    if (config.publish === false) continue;
+    pages.push({
+      dirName: entry.name,
+      dirPath,
+      entryPath,
+      appPath,
+      configPath,
+      config,
+    });
+  }
+
+  return pages.sort((left, right) =>
+    String(left.config.name || left.dirName).localeCompare(
+      String(right.config.name || right.dirName),
+      "zh-Hans-CN",
+    ),
+  );
+}
+
+export async function readPackageJson() {
+  return JSON.parse(await fs.readFile(path.join(rootDir, "package.json"), "utf8"));
+}
+
+export async function getReactVersion() {
+  const packageJson = await readPackageJson();
+  return String(packageJson.dependencies?.react || "")
+    .replace(/^[~^]/, "")
+    .trim();
+}

package/packages/sdk/src/build-source/scripts/utils/progress.mjs

@@ -0,0 +1,57 @@
+/**
+ * progress.mjs - 上传进度报告工具
+ *
+ * 提供文件上传进度跟踪，包括已完成数量、文件总大小、耗时统计。
+ */
+
+import fs from "node:fs";
+
+/**
+ * 创建进度跟踪器
+ * @param {number} total - 总文件数
+ * @returns {{ tick: (file: string, localPath: string) => void, summary: () => void }}
+ */
+export function createProgressTracker(total) {
+  let completed = 0;
+  let totalBytes = 0;
+  const startTime = Date.now();
+
+  return {
+    /**
+     * 标记一个文件上传完成
+     * @param {string} ossKey - OSS 对象键（用于日志）
+     * @param {string} localPath - 本地文件路径（用于计算大小）
+     */
+    tick(ossKey, localPath) {
+      completed += 1;
+      try {
+        const stat = fs.statSync(localPath);
+        totalBytes += stat.size;
+      } catch {
+        // 忽略 stat 失败
+      }
+      const pct = Math.round((completed / total) * 100);
+      console.log(`  ✓ [${completed}/${total} ${pct}%] ${ossKey}`);
+    },
+
+    /**
+     * 标记一个文件上传失败
+     * @param {string} ossKey - OSS 对象键
+     * @param {Error} error - 错误对象
+     */
+    fail(ossKey, error) {
+      completed += 1;
+      const pct = Math.round((completed / total) * 100);
+      console.error(`  ✗ [${completed}/${total} ${pct}%] ${ossKey}: ${error.message}`);
+    },
+
+    /**
+     * 打印上传汇总信息
+     */
+    summary() {
+      const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+      const sizeMB = (totalBytes / (1024 * 1024)).toFixed(2);
+      console.log(`\n📊 上传统计: ${total} 个文件, ${sizeMB} MB, 耗时 ${elapsed}s`);
+    },
+  };
+}