@ruan-cat/vercel-deploy-tool 1.2.7 → 1.4.0

package/dist/cli.js

@@ -8,7 +8,7 @@ import { Command as Command3 } from "commander";
 
 // src/commands/deploy.ts
 import { Command } from "commander";
-import { consola as consola10 } from "consola";
+import { consola as consola11 } from "consola";
 import { config as dotenvxConfig2 } from "@dotenvx/dotenvx";
 
 // src/config/loader.ts
@@ -60,7 +60,7 @@ async function loadConfig() {
 // src/core/tasks/index.ts
 import fs4 from "fs";
 import { resolve as resolve5 } from "path";
-import { consola as consola9 } from "consola";
+import { consola as consola10 } from "consola";
 
 // src/core/executor.ts
 import task from "tasuku";
@@ -113,12 +113,60 @@ var VERCEL_NULL_CONFIG = {
 var VERCEL_NULL_CONFIG_PATH = "./vercel.null.def.json";
 var VERCEL_OUTPUT_STATIC = ".vercel/output/static";
 
+// src/core/git-diff-filter.ts
+import { spawnSync } from "child_process";
+import picomatch from "picomatch";
+import { consola as consola2 } from "consola";
+function getChangedFiles(diffBase) {
+  if (!diffBase) {
+    consola2.warn("\u672A\u63D0\u4F9B diffBase\uFF0C\u65E0\u6CD5\u68C0\u6D4B\u53D8\u66F4\u6587\u4EF6\uFF0C\u5C06\u964D\u7EA7\u4E3A\u5168\u91CF\u90E8\u7F72");
+    return null;
+  }
+  const result = spawnSync("git", ["diff", "--name-only", diffBase, "HEAD"], {
+    encoding: "utf-8"
+  });
+  if (result.error) {
+    consola2.warn(`git \u547D\u4EE4\u4E0D\u53EF\u7528\u6216\u6267\u884C\u5931\u8D25: ${result.error.message}\uFF0C\u5C06\u964D\u7EA7\u4E3A\u5168\u91CF\u90E8\u7F72`);
+    return null;
+  }
+  if (result.status !== 0) {
+    consola2.warn(`git diff \u8FD4\u56DE\u975E\u96F6\u9000\u51FA\u7801 ${result.status}\uFF0C\u5C06\u964D\u7EA7\u4E3A\u5168\u91CF\u90E8\u7F72`);
+    if (result.stderr?.trim()) {
+      consola2.warn(result.stderr.trim());
+    }
+    return null;
+  }
+  const output = result.stdout?.trim();
+  if (!output) {
+    return [];
+  }
+  return output.split("\n").filter(Boolean);
+}
+function filterTargetsByDiff(targets, changedFiles) {
+  const deploy = [];
+  const skipped = [];
+  for (const target of targets) {
+    if (!target.watchPaths || target.watchPaths.length === 0) {
+      deploy.push(target);
+      continue;
+    }
+    const isMatch = picomatch(target.watchPaths);
+    const hasChange = changedFiles.some((file) => isMatch(file));
+    if (hasChange) {
+      deploy.push(target);
+    } else {
+      skipped.push(target);
+    }
+  }
+  return { deploy, skipped };
+}
+
 // src/core/tasks/link.ts
 import fs from "fs";
 import { resolve } from "path";
-import { spawnSync } from "child_process";
+import { spawnSync as spawnSync2 } from "child_process";
 import { concat } from "lodash-es";
-import { consola as consola2 } from "consola";
+import { consola as consola3 } from "consola";
 
 // src/core/vercel.ts
 function getVercelProjectNameArg(config) {
@@ -155,7 +203,7 @@ function createLinkTask(config, target) {
       const targetPath = resolve(target.targetCWD);
       if (!fs.existsSync(targetPath)) {
         const err = new Error(`\u76EE\u6807\u76EE\u5F55\u4E0D\u5B58\u5728\uFF0C\u8BF7\u5148\u6784\u5EFA: ${target.targetCWD}`);
-        consola2.error(err.message);
+        consola3.error(err.message);
         throw err;
       }
       const args = concat(
@@ -165,13 +213,13 @@ function createLinkTask(config, target) {
         getVercelProjectNameArg(config),
         getVercelTokenArg(config)
       );
-      consola2.start(`\u5F00\u59CB link \u4EFB\u52A1: ${target.targetCWD}`);
-      const result = spawnSync("vercel", args, createVercelSpawnOptions());
+      consola3.start(`\u5F00\u59CB link \u4EFB\u52A1: ${target.targetCWD}`);
+      const result = spawnSync2("vercel", args, createVercelSpawnOptions());
       if (result.error) {
-        consola2.error(`link \u4EFB\u52A1\u5931\u8D25: ${target.targetCWD}`);
+        consola3.error(`link \u4EFB\u52A1\u5931\u8D25: ${target.targetCWD}`);
         throw result.error;
       }
-      consola2.success(`\u5B8C\u6210 link \u4EFB\u52A1: ${target.targetCWD}`);
+      consola3.success(`\u5B8C\u6210 link \u4EFB\u52A1: ${target.targetCWD}`);
       return result.stdout;
     }
   };
@@ -180,9 +228,9 @@ function createLinkTask(config, target) {
 // src/core/tasks/build.ts
 import fs2 from "fs";
 import { resolve as resolve2 } from "path";
-import { spawnSync as spawnSync2 } from "child_process";
+import { spawnSync as spawnSync3 } from "child_process";
 import { concat as concat2 } from "lodash-es";
-import { consola as consola3 } from "consola";
+import { consola as consola4 } from "consola";
 function createBuildTask(config, target) {
   return {
     name: `Build: ${target.targetCWD}`,
@@ -190,7 +238,7 @@ function createBuildTask(config, target) {
       const targetPath = resolve2(target.targetCWD);
       if (!fs2.existsSync(targetPath)) {
         const err = new Error(`\u76EE\u6807\u76EE\u5F55\u4E0D\u5B58\u5728\uFF0C\u8BF7\u5148\u6784\u5EFA: ${target.targetCWD}`);
-        consola3.error(err.message);
+        consola4.error(err.message);
         throw err;
       }
       const args = concat2(
@@ -201,21 +249,21 @@ function createBuildTask(config, target) {
         getVercelLocalConfigArg(),
         getVercelTokenArg(config)
       );
-      consola3.start(`\u5F00\u59CB build \u4EFB\u52A1: ${target.targetCWD}`);
-      const result = spawnSync2("vercel", args, createVercelSpawnOptions());
+      consola4.start(`\u5F00\u59CB build \u4EFB\u52A1: ${target.targetCWD}`);
+      const result = spawnSync3("vercel", args, createVercelSpawnOptions());
       if (result.error) {
-        consola3.error(`build \u4EFB\u52A1\u5931\u8D25: ${target.targetCWD}`);
+        consola4.error(`build \u4EFB\u52A1\u5931\u8D25: ${target.targetCWD}`);
         throw result.error;
       }
-      consola3.success(`\u5B8C\u6210 build \u4EFB\u52A1: ${target.targetCWD}`);
+      consola4.success(`\u5B8C\u6210 build \u4EFB\u52A1: ${target.targetCWD}`);
       return result.stdout;
     }
   };
 }
 
 // src/core/tasks/after-build.ts
-import { spawnSync as spawnSync3 } from "child_process";
-import { consola as consola4 } from "consola";
+import { spawnSync as spawnSync4 } from "child_process";
+import { consola as consola5 } from "consola";
 import { isUndefined as isUndefined2, isEmpty } from "lodash-es";
 function createAfterBuildTasks(config) {
   const afterBuildTasks = config.afterBuildTasks;
@@ -224,7 +272,7 @@ function createAfterBuildTasks(config) {
       {
         name: "AfterBuild: \u65E0\u4EFB\u52A1",
         fn: async () => {
-          consola4.warn("\u5F53\u524D\u6CA1\u6709\u6709\u610F\u4E49\u7684 afterBuildTasks \u4EFB\u52A1\u914D\u7F6E");
+          consola5.warn("\u5F53\u524D\u6CA1\u6709\u6709\u610F\u4E49\u7684 afterBuildTasks \u4EFB\u52A1\u914D\u7F6E");
           return void 0;
         }
       }
@@ -233,40 +281,40 @@ function createAfterBuildTasks(config) {
   return afterBuildTasks.map((command) => ({
     name: `AfterBuild: ${command}`,
     fn: async () => {
-      consola4.start(`\u5F00\u59CB afterBuild \u4EFB\u52A1: ${command}`);
-      const result = spawnSync3(command, [], {
+      consola5.start(`\u5F00\u59CB afterBuild \u4EFB\u52A1: ${command}`);
+      const result = spawnSync4(command, [], {
         encoding: "utf-8",
         stdio: "inherit",
         shell: true
       });
       if (result.error) {
-        consola4.error(`afterBuild \u4EFB\u52A1\u5931\u8D25: ${command}`);
+        consola5.error(`afterBuild \u4EFB\u52A1\u5931\u8D25: ${command}`);
         throw result.error;
       }
-      consola4.success(`\u5B8C\u6210 afterBuild \u4EFB\u52A1: ${command}`);
+      consola5.success(`\u5B8C\u6210 afterBuild \u4EFB\u52A1: ${command}`);
       return result.stdout;
     }
   }));
 }
 
 // src/core/tasks/user-commands.ts
-import { spawnSync as spawnSync4 } from "child_process";
-import { consola as consola5 } from "consola";
+import { spawnSync as spawnSync5 } from "child_process";
+import { consola as consola6 } from "consola";
 function createUserCommandTasks(target) {
   return target.userCommands.map((command) => ({
     name: `UserCommand: ${command}`,
     fn: async () => {
-      consola5.start(`\u5F00\u59CB\u7528\u6237\u547D\u4EE4\u4EFB\u52A1: ${command}`);
-      const result = spawnSync4(command, [], {
+      consola6.start(`\u5F00\u59CB\u7528\u6237\u547D\u4EE4\u4EFB\u52A1: ${command}`);
+      const result = spawnSync5(command, [], {
         encoding: "utf-8",
         stdio: "inherit",
         shell: true
       });
       if (result.error) {
-        consola5.error(`\u7528\u6237\u547D\u4EE4\u4EFB\u52A1\u5931\u8D25: ${command}`);
+        consola6.error(`\u7528\u6237\u547D\u4EE4\u4EFB\u52A1\u5931\u8D25: ${command}`);
         throw result.error;
       }
-      consola5.success(`\u5B8C\u6210\u7528\u6237\u547D\u4EE4\u4EFB\u52A1: ${command}`);
+      consola6.success(`\u5B8C\u6210\u7528\u6237\u547D\u4EE4\u4EFB\u52A1: ${command}`);
       return result.stdout;
     }
   }));
@@ -275,7 +323,7 @@ function createUserCommandTasks(target) {
 // src/core/tasks/copy-dist.ts
 import { resolve as resolve3 } from "path";
 import { rmSync, mkdirSync, cpSync } from "fs";
-import { consola as consola6 } from "consola";
+import { consola as consola7 } from "consola";
 function createCopyDistTasks(target) {
   const targetCWD = target.targetCWD;
   const outputDirectory = target.outputDirectory;
@@ -288,27 +336,27 @@ function createCopyDistTasks(target) {
     {
       name: `\u5220\u9664\u76EE\u5F55: ${pathVercelOutputStatic}`,
       fn: async () => {
-        consola6.start(`\u5F00\u59CB\u5220\u9664\u6587\u4EF6\u4EFB\u52A1: ${pathVercelOutputStatic}`);
+        consola7.start(`\u5F00\u59CB\u5220\u9664\u6587\u4EF6\u4EFB\u52A1: ${pathVercelOutputStatic}`);
         rmSync(pathVercelOutputStatic, { recursive: true, force: true });
-        consola6.success(`\u5220\u9664\u8BE5\u8DEF\u5F84\u7684\u6587\u4EF6: ${pathVercelOutputStatic}`);
+        consola7.success(`\u5220\u9664\u8BE5\u8DEF\u5F84\u7684\u6587\u4EF6: ${pathVercelOutputStatic}`);
       }
     },
     {
       name: `\u521B\u5EFA\u76EE\u5F55: ${pathVercelOutputStatic}`,
       fn: async () => {
-        consola6.start(`\u5F00\u59CB\u521B\u5EFA\u6587\u4EF6\u5939\u4EFB\u52A1: ${pathVercelOutputStatic}`);
+        consola7.start(`\u5F00\u59CB\u521B\u5EFA\u6587\u4EF6\u5939\u4EFB\u52A1: ${pathVercelOutputStatic}`);
         mkdirSync(pathVercelOutputStatic, { recursive: true });
-        consola6.success(`\u521B\u5EFA\u7684\u65B0\u76EE\u5F55\u4E3A: ${pathVercelOutputStatic}`);
+        consola7.success(`\u521B\u5EFA\u7684\u65B0\u76EE\u5F55\u4E3A: ${pathVercelOutputStatic}`);
       }
     },
     {
       name: `\u590D\u5236\u6587\u4EF6: ${pathOutputDirectory} -> ${pathVercelOutputStatic}`,
       fn: async () => {
-        consola6.start(`\u5F00\u59CB\u6587\u4EF6\u590D\u5236\u4EFB\u52A1`);
-        consola6.info(`\u4ECE ${pathOutputDirectory} \u5F00\u59CB`);
-        consola6.info(`\u590D\u5236\u5230 ${pathVercelOutputStatic} \u5185`);
+        consola7.start(`\u5F00\u59CB\u6587\u4EF6\u590D\u5236\u4EFB\u52A1`);
+        consola7.info(`\u4ECE ${pathOutputDirectory} \u5F00\u59CB`);
+        consola7.info(`\u590D\u5236\u5230 ${pathVercelOutputStatic} \u5185`);
         cpSync(pathOutputDirectory, pathVercelOutputStatic, { recursive: true });
-        consola6.success(`\u5B8C\u6210\u6587\u4EF6\u590D\u5236\u4EFB\u52A1`);
+        consola7.success(`\u5B8C\u6210\u6587\u4EF6\u590D\u5236\u4EFB\u52A1`);
       }
     }
   ];
@@ -317,9 +365,9 @@ function createCopyDistTasks(target) {
 // src/core/tasks/deploy.ts
 import fs3 from "fs";
 import { resolve as resolve4 } from "path";
-import { spawnSync as spawnSync5 } from "child_process";
+import { spawnSync as spawnSync6 } from "child_process";
 import { concat as concat3 } from "lodash-es";
-import { consola as consola7 } from "consola";
+import { consola as consola8 } from "consola";
 function createDeployTask(config, target) {
   return {
     name: `Deploy: ${target.targetCWD}`,
@@ -327,7 +375,7 @@ function createDeployTask(config, target) {
       const targetPath = resolve4(target.targetCWD);
       if (!fs3.existsSync(targetPath)) {
         const err = new Error(`\u76EE\u6807\u76EE\u5F55\u4E0D\u5B58\u5728\uFF0C\u8BF7\u5148\u6784\u5EFA: ${target.targetCWD}`);
-        consola7.error(err.message);
+        consola8.error(err.message);
         throw err;
       }
       const args = concat3(
@@ -338,38 +386,38 @@ function createDeployTask(config, target) {
         getTargetCWDArg(target),
         getVercelTokenArg(config)
       );
-      consola7.start(`\u5F00\u59CB\u90E8\u7F72\u4EFB\u52A1: ${target.targetCWD}`);
-      const result = spawnSync5("vercel", args, createVercelSpawnOptions("pipe"));
+      consola8.start(`\u5F00\u59CB\u90E8\u7F72\u4EFB\u52A1: ${target.targetCWD}`);
+      const result = spawnSync6("vercel", args, createVercelSpawnOptions("pipe"));
       if (result.error) {
-        consola7.error(`\u90E8\u7F72\u5931\u8D25\u4E86: ${target.targetCWD}`);
-        consola7.error(result.error);
+        consola8.error(`\u90E8\u7F72\u5931\u8D25\u4E86: ${target.targetCWD}`);
+        consola8.error(result.error);
         throw result.error;
       }
       const vercelUrl = result.stdout.toString().trim();
-      consola7.success(`\u5B8C\u6210\u90E8\u7F72\u4EFB\u52A1\uFF0C\u751F\u6210\u7684url\u4E3A:`);
-      consola7.box(vercelUrl);
+      consola8.success(`\u5B8C\u6210\u90E8\u7F72\u4EFB\u52A1\uFF0C\u751F\u6210\u7684url\u4E3A:`);
+      consola8.box(vercelUrl);
       return vercelUrl;
     }
   };
 }
 
 // src/core/tasks/alias.ts
-import { spawnSync as spawnSync6 } from "child_process";
+import { spawnSync as spawnSync7 } from "child_process";
 import { concat as concat4 } from "lodash-es";
-import { consola as consola8 } from "consola";
+import { consola as consola9 } from "consola";
 function createAliasTask(config, vercelUrl, userUrl) {
   return {
     name: `Alias: ${userUrl}`,
     fn: async () => {
       const args = concat4(["alias", "set", vercelUrl, userUrl], getVercelTokenArg(config), getVercelScopeArg(config));
-      consola8.start(`\u5F00\u59CB\u522B\u540D\u4EFB\u52A1: ${userUrl}`);
-      const result = spawnSync6("vercel", args, createVercelSpawnOptions());
+      consola9.start(`\u5F00\u59CB\u522B\u540D\u4EFB\u52A1: ${userUrl}`);
+      const result = spawnSync7("vercel", args, createVercelSpawnOptions());
       if (result.error) {
-        consola8.error(`\u522B\u540D\u4EFB\u52A1\u5931\u8D25: ${userUrl}`);
+        consola9.error(`\u522B\u540D\u4EFB\u52A1\u5931\u8D25: ${userUrl}`);
         throw result.error;
       }
-      consola8.success(`\u5B8C\u6210\u522B\u540D\u4EFB\u52A1\uFF0C\u53EF\u7528\u7684\u522B\u540D\u5730\u5740\u4E3A:`);
-      consola8.box(`https://${userUrl}`);
+      consola9.success(`\u5B8C\u6210\u522B\u540D\u4EFB\u52A1\uFF0C\u53EF\u7528\u7684\u522B\u540D\u5730\u5740\u4E3A:`);
+      consola9.box(`https://${userUrl}`);
       return result.stdout;
     }
   };
@@ -378,32 +426,59 @@ function createAliasTask(config, vercelUrl, userUrl) {
 // src/core/tasks/index.ts
 async function generateVercelNullConfig() {
   fs4.writeFileSync(VERCEL_NULL_CONFIG_PATH, JSON.stringify(VERCEL_NULL_CONFIG, null, 2));
-  consola9.success(`\u751F\u6210 Vercel \u7A7A\u914D\u7F6E\u6587\u4EF6: ${VERCEL_NULL_CONFIG_PATH}`);
+  consola10.success(`\u751F\u6210 Vercel \u7A7A\u914D\u7F6E\u6587\u4EF6: ${VERCEL_NULL_CONFIG_PATH}`);
 }
-async function executeDeploymentWorkflow(config) {
+async function executeDeploymentWorkflow(config, options) {
   await generateVercelNullConfig();
   const { deployTargets } = config;
   const availableTargets = deployTargets.filter((target) => {
     const targetPath = resolve5(target.targetCWD);
     if (!fs4.existsSync(targetPath)) {
-      consola9.warn(`\u76EE\u6807\u76EE\u5F55\u4E0D\u5B58\u5728\uFF0C\u5DF2\u8DF3\u8FC7: ${target.targetCWD}`);
+      consola10.warn(`\u76EE\u6807\u76EE\u5F55\u4E0D\u5B58\u5728\uFF0C\u5DF2\u8DF3\u8FC7: ${target.targetCWD}`);
       return false;
     }
     return true;
   });
   if (availableTargets.length === 0) {
-    consola9.error("\u6CA1\u6709\u53EF\u7528\u7684\u90E8\u7F72\u76EE\u6807\uFF0C\u8BF7\u5148\u6784\u5EFA\u4EA7\u7269");
+    consola10.error("\u6CA1\u6709\u53EF\u7528\u7684\u90E8\u7F72\u76EE\u6807\uFF0C\u8BF7\u5148\u6784\u5EFA\u4EA7\u7269");
     return;
   }
   await task("Vercel \u90E8\u7F72\u5DE5\u4F5C\u6D41", async ({ task: task2 }) => {
+    const { result: finalTargets } = await task2("0. \u68C0\u6D4B\u53D8\u66F4\u8303\u56F4", async ({ setTitle }) => {
+      if (options?.forceAll) {
+        setTitle("0. \u5F3A\u5236\u5168\u91CF\u90E8\u7F72\uFF08--force-all\uFF09");
+        return availableTargets;
+      }
+      if (!options?.diffBase) {
+        setTitle("0. \u5168\u91CF\u90E8\u7F72\uFF08\u672A\u6307\u5B9A --diff-base\uFF09");
+        return availableTargets;
+      }
+      const changedFiles = getChangedFiles(options.diffBase);
+      if (changedFiles === null) {
+        setTitle("0. Git \u4E0D\u53EF\u7528\uFF0C\u5DF2\u964D\u7EA7\u4E3A\u5168\u91CF\u90E8\u7F72");
+        return availableTargets;
+      }
+      if (changedFiles.length === 0) {
+        setTitle("0. \u65E0\u6587\u4EF6\u53D8\u66F4\uFF0C\u8DF3\u8FC7\u6240\u6709\u90E8\u7F72");
+        return [];
+      }
+      const { deploy, skipped } = filterTargetsByDiff(availableTargets, changedFiles);
+      skipped.forEach((t) => consola10.info(`\u8DF3\u8FC7\u672A\u53D8\u66F4\u76EE\u6807: ${t.targetCWD}`));
+      setTitle(`0. \u7CBE\u786E\u90E8\u7F72: ${deploy.length} / ${availableTargets.length} \u4E2A\u76EE\u6807`);
+      return deploy;
+    });
+    if (finalTargets.length === 0) {
+      consola10.success("\u6240\u6709\u76EE\u6807\u5747\u65E0\u53D8\u66F4\uFF0C\u65E0\u9700\u90E8\u7F72");
+      return;
+    }
     await task2("1. Link \u9879\u76EE", async () => {
-      const linkTasks = availableTargets.map((target) => createLinkTask(config, target));
+      const linkTasks = finalTargets.map((target) => createLinkTask(config, target));
       await task2.group((task3) => linkTasks.map((t) => task3(t.name, t.fn)));
     });
     await task2("2. \u6784\u5EFA\u9879\u76EE", async () => {
-      const buildTasks = availableTargets.filter(isNeedVercelBuild).map((target) => createBuildTask(config, target));
+      const buildTasks = finalTargets.filter(isNeedVercelBuild).map((target) => createBuildTask(config, target));
       if (buildTasks.length === 0) {
-        consola9.warn("\u6CA1\u6709\u9700\u8981\u6267\u884C build \u7684\u76EE\u6807");
+        consola10.warn("\u6CA1\u6709\u9700\u8981\u6267\u884C build \u7684\u76EE\u6807");
         return;
       }
       await task2.group((task3) => buildTasks.map((t) => task3(t.name, t.fn)));
@@ -413,11 +488,11 @@ async function executeDeploymentWorkflow(config) {
       await executeSequential("AfterBuild", afterBuildTasks);
     });
     await task2("4. \u6267\u884C\u7528\u6237\u547D\u4EE4\u4E0E\u6587\u4EF6\u590D\u5236", async () => {
-      const targetTasks = availableTargets.map((target) => ({
+      const targetTasks = finalTargets.map((target) => ({
         name: `\u5904\u7406\u76EE\u6807: ${target.targetCWD}`,
         fn: async () => {
           if (!isDeployTargetWithUserCommands(target)) {
-            consola9.warn(`\u76EE\u6807 ${target.targetCWD} \u4E0D\u5C5E\u4E8E userCommands \u7C7B\u578B`);
+            consola10.warn(`\u76EE\u6807 ${target.targetCWD} \u4E0D\u5C5E\u4E8E userCommands \u7C7B\u578B`);
             return;
           }
           const userCommandTasks = createUserCommandTasks(target);
@@ -426,14 +501,14 @@ async function executeDeploymentWorkflow(config) {
             const copyDistTasks = createCopyDistTasks(target);
             await executeSequential(`CopyDist: ${target.targetCWD}`, copyDistTasks);
           } else {
-            consola9.warn(`\u76EE\u6807 ${target.targetCWD} \u4E0D\u9700\u8981\u590D\u5236\u6587\u4EF6`);
+            consola10.warn(`\u76EE\u6807 ${target.targetCWD} \u4E0D\u9700\u8981\u590D\u5236\u6587\u4EF6`);
           }
         }
       }));
       await task2.group((task3) => targetTasks.map((t) => task3(t.name, t.fn)));
     });
     await task2("5. \u90E8\u7F72\u4E0E\u8BBE\u7F6E\u522B\u540D", async () => {
-      const deployAliasTasks = availableTargets.map((target) => ({
+      const deployAliasTasks = finalTargets.map((target) => ({
         name: `\u90E8\u7F72\u4E0E\u522B\u540D: ${target.targetCWD}`,
         fn: async () => {
           const deployTask = createDeployTask(config, target);
@@ -443,34 +518,37 @@ async function executeDeploymentWorkflow(config) {
             const aliasTasks = target.url.map((userUrl) => createAliasTask(config, vercelUrl, userUrl));
             await task2.group((task3) => aliasTasks.map((t) => task3(t.name, t.fn)));
           } else {
-            consola9.warn(`\u76EE\u6807 ${target.targetCWD} \u6CA1\u6709\u914D\u7F6E\u522B\u540D`);
+            consola10.warn(`\u76EE\u6807 ${target.targetCWD} \u6CA1\u6709\u914D\u7F6E\u522B\u540D`);
           }
         }
       }));
       await task2.group((task3) => deployAliasTasks.map((t) => task3(t.name, t.fn)));
     });
   });
-  consola9.success("\u{1F389} Vercel \u90E8\u7F72\u5DE5\u4F5C\u6D41\u5B8C\u6210\uFF01");
+  consola10.success("\u{1F389} Vercel \u90E8\u7F72\u5DE5\u4F5C\u6D41\u5B8C\u6210\uFF01");
 }
 
 // src/commands/deploy.ts
 function createDeployCommand() {
   const command = new Command("deploy");
-  command.description("\u90E8\u7F72\u9879\u76EE\u5230 Vercel").option("--env-path <path>", "\u6307\u5B9A dotenv \u6587\u4EF6\u8DEF\u5F84\uFF0C\u7528\u4E8E\u8986\u76D6\u9ED8\u8BA4\u73AF\u5883\u53D8\u91CF").action(async (options) => {
+  command.description("\u90E8\u7F72\u9879\u76EE\u5230 Vercel").option("--env-path <path>", "\u6307\u5B9A dotenv \u6587\u4EF6\u8DEF\u5F84\uFF0C\u7528\u4E8E\u8986\u76D6\u9ED8\u8BA4\u73AF\u5883\u53D8\u91CF").option("--diff-base <ref>", "Git ref\uFF0C\u4E0E HEAD \u5BF9\u6BD4\u68C0\u6D4B\u53D8\u66F4\u6587\u4EF6\uFF0C\u4EC5\u90E8\u7F72\u6709\u53D8\u66F4\u7684\u76EE\u6807").option("--force-all", "\u5F3A\u5236\u90E8\u7F72\u6240\u6709\u76EE\u6807\uFF0C\u5FFD\u7565 watchPaths \u8FC7\u6EE4\uFF08\u4F18\u5148\u7EA7\u9AD8\u4E8E --diff-base\uFF09").action(async (options) => {
     try {
       if (options?.envPath) {
         process.env.VERCEL_DEPLOY_TOOL_ENV_PATH = options.envPath;
         dotenvxConfig2({ path: options.envPath });
-        consola10.info(`\u5DF2\u4ECE --env-path \u52A0\u8F7D\u73AF\u5883\u53D8\u91CF: ${options.envPath}`);
+        consola11.info(`\u5DF2\u4ECE --env-path \u52A0\u8F7D\u73AF\u5883\u53D8\u91CF: ${options.envPath}`);
       }
-      consola10.start("\u5F00\u59CB\u52A0\u8F7D\u914D\u7F6E...");
+      consola11.start("\u5F00\u59CB\u52A0\u8F7D\u914D\u7F6E...");
       const config = await loadConfig();
-      consola10.start("\u5F00\u59CB\u6267\u884C\u90E8\u7F72\u5DE5\u4F5C\u6D41...");
-      await executeDeploymentWorkflow(config);
-      consola10.success("\u90E8\u7F72\u5B8C\u6210\uFF01");
+      consola11.start("\u5F00\u59CB\u6267\u884C\u90E8\u7F72\u5DE5\u4F5C\u6D41...");
+      await executeDeploymentWorkflow(config, {
+        diffBase: options?.diffBase,
+        forceAll: options?.forceAll
+      });
+      consola11.success("\u90E8\u7F72\u5B8C\u6210\uFF01");
     } catch (error) {
-      consola10.error("\u90E8\u7F72\u5931\u8D25:");
-      consola10.error(error);
+      consola11.error("\u90E8\u7F72\u5931\u8D25:");
+      consola11.error(error);
       process.exit(1);
     }
   });
@@ -482,7 +560,7 @@ import { Command as Command2 } from "commander";
 import { readFileSync, writeFileSync, existsSync } from "fs";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
-import { consola as consola11 } from "consola";
+import { consola as consola12 } from "consola";
 var __filename2 = fileURLToPath(import.meta.url);
 var __dirname2 = dirname(__filename2);
 function createInitCommand() {
@@ -492,19 +570,19 @@ function createInitCommand() {
     const configFile = "vercel-deploy-tool.config.ts";
     const targetPath = join(cwd, configFile);
     if (existsSync(targetPath) && !options.force) {
-      consola11.warn(`\u914D\u7F6E\u6587\u4EF6\u5DF2\u5B58\u5728: ${configFile}`);
-      consola11.info("\u4F7F\u7528 --force \u9009\u9879\u53EF\u4EE5\u8986\u76D6");
+      consola12.warn(`\u914D\u7F6E\u6587\u4EF6\u5DF2\u5B58\u5728: ${configFile}`);
+      consola12.info("\u4F7F\u7528 --force \u9009\u9879\u53EF\u4EE5\u8986\u76D6");
       return;
     }
     const templatePath = join(__dirname2, "..", "templates", configFile);
     if (!existsSync(templatePath)) {
-      consola11.error(`\u6A21\u677F\u6587\u4EF6\u4E0D\u5B58\u5728: ${templatePath}`);
-      consola11.error("\u8BF7\u786E\u4FDD @ruan-cat/vercel-deploy-tool \u5305\u5DF2\u6B63\u786E\u5B89\u88C5");
+      consola12.error(`\u6A21\u677F\u6587\u4EF6\u4E0D\u5B58\u5728: ${templatePath}`);
+      consola12.error("\u8BF7\u786E\u4FDD @ruan-cat/vercel-deploy-tool \u5305\u5DF2\u6B63\u786E\u5B89\u88C5");
       process.exit(1);
     }
     const content = readFileSync(templatePath, "utf-8");
     writeFileSync(targetPath, content, "utf-8");
-    consola11.success(`\u5DF2\u521B\u5EFA\u914D\u7F6E\u6587\u4EF6: ${configFile}`);
+    consola12.success(`\u5DF2\u521B\u5EFA\u914D\u7F6E\u6587\u4EF6: ${configFile}`);
     const pkgPath = join(cwd, "package.json");
     if (existsSync(pkgPath)) {
       try {
@@ -512,12 +590,12 @@ function createInitCommand() {
         if (!pkg.scripts) pkg.scripts = {};
         pkg.scripts["deploy-vercel"] = "vercel-deploy-tool deploy";
         writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
-        consola11.success('\u5DF2\u6DFB\u52A0\u811A\u672C: "deploy-vercel"');
+        consola12.success('\u5DF2\u6DFB\u52A0\u811A\u672C: "deploy-vercel"');
       } catch (error) {
-        consola11.warn("\u66F4\u65B0 package.json \u5931\u8D25:", error);
+        consola12.warn("\u66F4\u65B0 package.json \u5931\u8D25:", error);
       }
     }
-    consola11.box(`\u{1F389} \u521D\u59CB\u5316\u5B8C\u6210\uFF01
+    consola12.box(`\u{1F389} \u521D\u59CB\u5316\u5B8C\u6210\uFF01
 
 \u521B\u5EFA\u7684\u6587\u4EF6:
   \u2022 ${configFile} - Vercel \u90E8\u7F72\u914D\u7F6E\u6587\u4EF6

package/dist/index.d.ts

@@ -24,6 +24,17 @@ interface DeployTargetBase {
      * @default true
      */
     isNeedVercelBuild?: boolean;
+    /**
+     * 监控路径（glob 模式）
+     * @description
+     * 配置后，部署前会通过 git diff 检测这些路径是否有变更。
+     * 仅在有变更时才部署该目标。未配置则始终部署（向后兼容）。
+     *
+     * 路径相对于 monorepo 根目录，使用 glob 语法。
+     * @example ["packages/utils/**"]
+     * @example ["packages/utils/src/docs/**", "packages/utils/src/.vitepress/**"]
+     */
+    watchPaths?: string[];
 }
 /**
  * 带有用户命令的配置
@@ -138,6 +149,22 @@ declare function loadConfig(): Promise<VercelDeployConfig>;
  */
 declare function getConfig(): Promise<VercelDeployConfig>;
 
+/** 部署工作流的可选参数 */
+interface DeploymentWorkflowOptions {
+    /**
+     * Git ref，与 HEAD 对比检测变更文件
+     * @description
+     * 提供后，会通过 git diff 过滤出只有 watchPaths 匹配的目标才被部署。
+     * 未提供则不做过滤，全量部署。
+     */
+    diffBase?: string;
+    /**
+     * 强制部署所有目标
+     * @description
+     * 为 true 时忽略 watchPaths 过滤，即使提供了 diffBase 也全量部署。
+     */
+    forceAll?: boolean;
+}
 /**
  * 执行 Vercel 部署工作流
  * @description
@@ -150,7 +177,7 @@ declare function getConfig(): Promise<VercelDeployConfig>;
  * 4. UserCommands + CopyDist 阶段（并行目标，串行步骤）
  * 5. Deploy + Alias 阶段（并行目标，串行步骤）
  */
-declare function executeDeploymentWorkflow(config: VercelDeployConfig): Promise<void>;
+declare function executeDeploymentWorkflow(config: VercelDeployConfig, options?: DeploymentWorkflowOptions): Promise<void>;
 
 /**
  * Vercel 的空配置