vite-plugin-deploy-oss 3.3.0 → 3.3.1

package/.prettierignore

@@ -0,0 +1,5 @@
+dist
+node_modules
+playground/__dist__
+coverage
+*.log

package/.prettierrc.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json.schemastore.org/prettierrc",
+  "arrowParens": "always",
+  "bracketSameLine": false,
+  "jsxSingleQuote": true,
+  "printWidth": 120,
+  "quoteProps": "as-needed",
+  "semi": false,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "endOfLine": "lf"
+}

package/README.md

@@ -12,6 +12,14 @@
 pnpm add vite-plugin-deploy-oss -D
 ```
 
+## 调试模式
+
+```bash
+pnpm run build:test:debug
+```
+
+这会进入带调试信息的上传模式，构建结束后额外输出每个关键步骤花了多久。
+
 ## 使用
 
 ```ts
@@ -26,6 +34,8 @@ export default {
     vitePluginDeployOss({
       // 建议按环境变量开关上传，避免本地/CI误上传
       open: process.env.DEPLOY_OSS === '1',
+      // 输出调试耗时信息，方便排查慢在哪里
+      debug: process.env.DEPLOY_OSS_DEBUG === '1',
       // 终端实时动效进度面板（默认 true）
       fancy: true,
 
@@ -53,6 +63,7 @@ export default {
 
 - 当前版本仅支持 ESM（`import`），不再提供 CommonJS（`require`）入口。
 - `open` 默认 `true`，建议通过环境变量控制开关（例如 `DEPLOY_OSS=1` 时再上传）。
+- `debug` 默认关闭。开启后会在结束时额外输出每个关键步骤花了多久，方便排查慢点和卡点。
 - `fancy` 默认 `true`，TTY 终端下会显示实时动效进度（速度、预计剩余、并发、当前文件）。
 - `failOnError` 默认 `true`，上传有失败会抛错，适合 CI 场景保证发布质量。
 - `manifest` 默认关闭。开启后会在构建目录生成并上传 `oss-manifest.json`。

package/dist/index.d.ts

@@ -18,6 +18,7 @@ interface vitePluginDeployOssOption extends Omit<oss.Options, 'accessKeyId' | 'a
     autoDelete?: boolean;
     skip?: string | string[];
     open?: boolean;
+    debug?: boolean;
     fancy?: boolean;
     noCache?: boolean;
     failOnError?: boolean;

package/dist/index.js

@@ -179,6 +179,18 @@ ${body}
 ${bottom}`;
 };
 var renderInlineStats = (items) => items.filter(Boolean).join(chalk2.gray(" \xB7 "));
+var getPanelDot = (tone = "success") => {
+  switch (tone) {
+    case "info":
+      return chalk2.green("\u25CF");
+    case "success":
+      return chalk2.green("\u25CF");
+    case "warning":
+      return chalk2.yellow("\u25CF");
+    case "danger":
+      return chalk2.red("\u25CF");
+  }
+};
 var getLogSymbol = (tone) => {
   switch (tone) {
     case "success":
@@ -191,6 +203,20 @@ var getLogSymbol = (tone) => {
 };
 
 // src/index.ts
+var formatTimingDuration = (durationMs) => {
+  if (durationMs < 1e3) return `${durationMs}ms`;
+  const seconds = durationMs / 1e3;
+  return `${seconds.toFixed(seconds >= 10 ? 1 : 2)}s`;
+};
+var renderDebugPanel = (entries) => {
+  const rows = entries.map((entry) => ({
+    label: `${entry.label}:`,
+    value: chalk3.cyan(
+      entry.detail ? `${formatTimingDuration(entry.durationMs)} \xB7 ${truncateTerminalText(entry.detail, 24)}` : formatTimingDuration(entry.durationMs)
+    )
+  }));
+  return renderPanel(`${getPanelDot("success")} \u8C03\u8BD5\u8017\u65F6`, rows, "info");
+};
 var createManifestPayload = async (results, configBase, alias) => {
   const successfulResults = results.filter((result) => result.success);
   const files = await Promise.all(
@@ -223,6 +249,7 @@ function vitePluginDeployOss(option) {
     autoDelete = false,
     alias,
     open = true,
+    debug = false,
     fancy = true,
     noCache = false,
     failOnError = true,
@@ -334,12 +361,14 @@ function vitePluginDeployOss(option) {
   };
   const uploadFilesInBatches = async (client, files, windowSize = concurrency) => {
     const results = [];
+    const debugEntries = [];
     const totalFiles = files.length;
     const tasks = [];
     let completed = 0;
     let failed = 0;
     let uploadedBytes = 0;
     let retries = 0;
+    const taskPrepareStartedAt = Date.now();
     const taskCandidates = await Promise.all(
       files.map(async (relativeFilePath) => {
         const filePath = normalizePath(resolve2(outDir, relativeFilePath));
@@ -352,6 +381,11 @@ function vitePluginDeployOss(option) {
         }
       })
     );
+    debugEntries.push({
+      label: "\u751F\u6210\u4E0A\u4F20\u4EFB\u52A1",
+      durationMs: Date.now() - taskPrepareStartedAt,
+      detail: `${files.length} \u4E2A\u6587\u4EF6`
+    });
     for (const candidate of taskCandidates) {
       if (candidate.task) {
         tasks.push(candidate.task);
@@ -453,7 +487,12 @@ function vitePluginDeployOss(option) {
     } else {
       console.log(`${getLogSymbol("success")} \u6240\u6709\u6587\u4EF6\u4E0A\u4F20\u5B8C\u6210 (${totalFiles}/${totalFiles})`);
     }
-    return results;
+    debugEntries.push({
+      label: "\u4E0A\u4F20\u6587\u4EF6",
+      durationMs: Date.now() - startAt,
+      detail: `${tasks.length} \u4E2A\u6210\u529F\u5019\u9009 \xB7 \u5E76\u53D1 ${safeWindowSize}`
+    });
+    return { results, debugEntries };
   };
   return {
     name: "vite-plugin-deploy-oss",
@@ -484,13 +523,20 @@ ${validationErrors.map((err) => `  - ${err}`).join("\n")}`);
       async handler() {
         if (!open || !upload || buildFailed || !resolvedConfig) return;
         const startTime = Date.now();
+        const debugEntries = [];
         const client = new oss({ region, accessKeyId, accessKeySecret, secure, bucket, ...props });
         const manifestFileName = resolveManifestFileName(manifest);
+        const collectFilesStartedAt = Date.now();
         const files = globSync("**/*", {
           cwd: outDir,
           nodir: true,
           ignore: Array.isArray(skip) ? skip : [skip]
         }).map((file) => normalizePath(file)).filter((file) => file !== manifestFileName);
+        debugEntries.push({
+          label: "\u626B\u63CF\u672C\u5730\u6587\u4EF6",
+          durationMs: Date.now() - collectFilesStartedAt,
+          detail: `${files.length} \u4E2A\u6587\u4EF6`
+        });
         if (files.length === 0) {
           console.log(`${getLogSymbol("warning")} \u6CA1\u6709\u627E\u5230\u9700\u8981\u4E0A\u4F20\u7684\u6587\u4EF6`);
           return;
@@ -498,7 +544,7 @@ ${validationErrors.map((err) => `  - ${err}`).join("\n")}`);
         clearViewport();
         console.log(
           renderPanel(
-            "\u51C6\u5907\u90E8\u7F72",
+            `${getPanelDot("success")} \u51C6\u5907\u90E8\u7F72`,
             [
               { label: "\u4F4D\u7F6E:", value: chalk3.green(`${bucket} \xB7 ${region}`) },
               {
@@ -519,7 +565,11 @@ ${validationErrors.map((err) => `  - ${err}`).join("\n")}`);
           )
         );
         try {
-          const results = await uploadFilesInBatches(client, files, concurrency);
+          const uploadExecution = await uploadFilesInBatches(client, files, concurrency);
+          const { results, debugEntries: uploadDebugEntries } = uploadExecution;
+          if (debug) {
+            debugEntries.push(...uploadDebugEntries);
+          }
           const successCount = results.filter((r) => r.success).length;
           const failedCount = results.length - successCount;
           const durationSeconds = (Date.now() - startTime) / 1e3;
@@ -531,13 +581,22 @@ ${validationErrors.map((err) => `  - ${err}`).join("\n")}`);
             const manifestRelativeFilePath = manifestFileName;
             const manifestFilePath = normalizePath(resolve2(outDir, manifestRelativeFilePath));
             const manifestObjectKey = normalizeObjectKey(normalizedUploadDir, manifestRelativeFilePath);
+            const manifestStartedAt = Date.now();
             await mkdir(dirname(manifestFilePath), { recursive: true });
             await writeFile(
               manifestFilePath,
               JSON.stringify(await createManifestPayload(results, normalizedConfigBase, normalizedAlias), null, 2),
               "utf8"
             );
+            if (debug) {
+              debugEntries.push({
+                label: "\u751F\u6210\u6E05\u5355\u6587\u4EF6",
+                durationMs: Date.now() - manifestStartedAt,
+                detail: manifestRelativeFilePath
+              });
+            }
             const manifestStats = await stat(manifestFilePath);
+            const manifestUploadStartedAt = Date.now();
             const manifestResult = await uploadSingleTask(client, {
               filePath: manifestFilePath,
               relativeFilePath: manifestRelativeFilePath,
@@ -548,6 +607,13 @@ ${validationErrors.map((err) => `  - ${err}`).join("\n")}`);
             if (!manifestResult.success) {
               throw manifestResult.error || new Error(`Failed to upload manifest: ${manifestRelativeFilePath}`);
             }
+            if (debug) {
+              debugEntries.push({
+                label: "\u4E0A\u4F20\u6E05\u5355\u6587\u4EF6",
+                durationMs: Date.now() - manifestUploadStartedAt,
+                detail: manifestRelativeFilePath
+              });
+            }
             const manifestUrl = resolveUploadedFileUrl(
               manifestRelativeFilePath,
               manifestObjectKey,
@@ -557,7 +623,14 @@ ${validationErrors.map((err) => `  - ${err}`).join("\n")}`);
             manifestSummary = truncateTerminalText(manifestUrl || manifestObjectKey, 20);
           }
           try {
+            const cleanupStartedAt = Date.now();
             await removeEmptyDirectories(outDir);
+            if (debug) {
+              debugEntries.push({
+                label: "\u6E05\u7406\u7A7A\u76EE\u5F55",
+                durationMs: Date.now() - cleanupStartedAt
+              });
+            }
           } catch (error) {
             console.warn(`${getLogSymbol("warning")} \u6E05\u7406\u7A7A\u76EE\u5F55\u5931\u8D25: ${error}`);
           }
@@ -596,11 +669,18 @@ ${validationErrors.map((err) => `  - ${err}`).join("\n")}`);
           }
           console.log(
             renderPanel(
-              failedCount === 0 ? `${getLogSymbol("success")} \u90E8\u7F72\u5B8C\u6210` : `${getLogSymbol("warning")} \u90E8\u7F72\u5B8C\u6210`,
+              failedCount === 0 ? `${getPanelDot("success")} \u90E8\u7F72\u5B8C\u6210` : `${getPanelDot("warning")} \u90E8\u7F72\u5B8C\u6210`,
               resultRows,
               failedCount === 0 ? "success" : "warning"
             )
           );
+          if (debug) {
+            debugEntries.push({
+              label: "\u603B\u8017\u65F6",
+              durationMs: Date.now() - startTime
+            });
+            console.log(renderDebugPanel(debugEntries));
+          }
           if (failedCount > 0 && failOnError) {
             throw new Error(`Failed to upload ${failedCount} of ${results.length} files`);
           }
@@ -608,6 +688,13 @@ ${validationErrors.map((err) => `  - ${err}`).join("\n")}`);
           console.log(`
 ${getLogSymbol("danger")} \u4E0A\u4F20\u8FC7\u7A0B\u4E2D\u53D1\u751F\u9519\u8BEF: ${error}
 `);
+          if (debug && debugEntries.length > 0) {
+            debugEntries.push({
+              label: "\u5931\u8D25\u524D\u8017\u65F6",
+              durationMs: Date.now() - startTime
+            });
+            console.log(renderDebugPanel(debugEntries));
+          }
           if (failOnError) {
             throw error instanceof Error ? error : new Error(String(error));
           }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-deploy-oss",
-  "version": "3.3.0",
+  "version": "3.3.1",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "type": "module",
@@ -33,6 +33,7 @@
   "devDependencies": {
     "@types/ali-oss": "^6.23.3",
     "@types/node": "^22.19.13",
+    "prettier": "3.8.1",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3"
   },
@@ -53,7 +54,10 @@
     "build": "tsup",
     "typecheck": "tsc -p tsconfig.json",
     "pack": "pnpm run build && pnpm pack",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
     "build:test": "cd playground && vite build",
-    "build:test:deploy": "cd playground && vite build --mode deploy"
+    "build:test:deploy": "cd playground && vite build --mode deploy",
+    "build:test:debug": "cd playground && vite build --mode deploy-debug"
   }
 }