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

package/src/core/git-diff-filter.ts

@@ -0,0 +1,90 @@
+import { spawnSync } from "node:child_process";
+import picomatch from "picomatch";
+import { consola } from "consola";
+import type { DeployTarget } from "../config/schema";
+
+/**
+ * git diff 检测结果
+ * @description
+ * - `string[]` - git 执行成功，返回变更文件列表（可能为空数组，表示确实无变更）
+ * - `null` - git 不可用或执行失败，调用方应降级为全量部署
+ */
+export type ChangedFilesResult = string[] | null;
+
+/**
+ * 获取 git diff 变更的文件列表
+ * @description
+ * 执行 `git diff --name-only <diffBase> HEAD`，返回相对于 monorepo 根目录的变更文件路径列表。
+ *
+ * 返回值说明：
+ * - `string[]` - git 执行成功，返回变更文件列表（空数组表示确实无变更）
+ * - `null` - git 命令不可用、ref 无效或执行失败，调用方应降级为全量部署
+ */
+export function getChangedFiles(diffBase: string): ChangedFilesResult {
+	if (!diffBase) {
+		consola.warn("未提供 diffBase，无法检测变更文件，将降级为全量部署");
+		return null;
+	}
+
+	const result = spawnSync("git", ["diff", "--name-only", diffBase, "HEAD"], {
+		encoding: "utf-8",
+	});
+
+	if (result.error) {
+		consola.warn(`git 命令不可用或执行失败: ${result.error.message}，将降级为全量部署`);
+		return null;
+	}
+
+	if (result.status !== 0) {
+		consola.warn(`git diff 返回非零退出码 ${result.status}，将降级为全量部署`);
+		if (result.stderr?.trim()) {
+			consola.warn(result.stderr.trim());
+		}
+		return null;
+	}
+
+	const output = result.stdout?.trim();
+	if (!output) {
+		return [];
+	}
+
+	return output.split("\n").filter(Boolean);
+}
+
+/** 过滤结果 */
+export interface FilterResult {
+	/** 需要部署的目标 */
+	deploy: DeployTarget[];
+	/** 跳过的目标 */
+	skipped: DeployTarget[];
+}
+
+/**
+ * 根据 git diff 变更文件列表过滤部署目标
+ * @description
+ * 对每个 DeployTarget，若配置了 watchPaths，则检查变更文件中是否有匹配 watchPaths 的文件。
+ * 有匹配则纳入部署列表，无匹配则跳过。
+ * 未配置 watchPaths 的目标，默认纳入部署列表（向后兼容）。
+ */
+export function filterTargetsByDiff(targets: DeployTarget[], changedFiles: string[]): FilterResult {
+	const deploy: DeployTarget[] = [];
+	const skipped: DeployTarget[] = [];
+
+	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 };
+}

package/src/core/tasks/index.ts

@@ -5,6 +5,7 @@ import { task, executeSequential } from "../executor";
 import type { VercelDeployConfig } from "../../config/schema";
 import { isDeployTargetWithUserCommands, isNeedVercelBuild, getIsCopyDist } from "../../utils/type-guards";
 import { VERCEL_NULL_CONFIG, VERCEL_NULL_CONFIG_PATH } from "../../utils/vercel-null-config";
+import { getChangedFiles, filterTargetsByDiff } from "../git-diff-filter";
 import { createLinkTask } from "./link";
 import { createBuildTask } from "./build";
 import { createAfterBuildTasks } from "./after-build";
@@ -23,6 +24,24 @@ async function generateVercelNullConfig() {
 	consola.success(`生成 Vercel 空配置文件: ${VERCEL_NULL_CONFIG_PATH}`);
 }
 
+/** 部署工作流的可选参数 */
+export interface DeploymentWorkflowOptions {
+	/**
+	 * Git ref，与 HEAD 对比检测变更文件
+	 * @description
+	 * 提供后，会通过 git diff 过滤出只有 watchPaths 匹配的目标才被部署。
+	 * 未提供则不做过滤，全量部署。
+	 */
+	diffBase?: string;
+
+	/**
+	 * 强制部署所有目标
+	 * @description
+	 * 为 true 时忽略 watchPaths 过滤，即使提供了 diffBase 也全量部署。
+	 */
+	forceAll?: boolean;
+}
+
 /**
  * 执行 Vercel 部署工作流
  * @description
@@ -35,7 +54,7 @@ async function generateVercelNullConfig() {
  * 4. UserCommands + CopyDist 阶段（并行目标，串行步骤）
  * 5. Deploy + Alias 阶段（并行目标，串行步骤）
  */
-export async function executeDeploymentWorkflow(config: VercelDeployConfig) {
+export async function executeDeploymentWorkflow(config: VercelDeployConfig, options?: DeploymentWorkflowOptions) {
 	// 0. 生成 Vercel 空配置文件
 	await generateVercelNullConfig();
 
@@ -59,16 +78,53 @@ export async function executeDeploymentWorkflow(config: VercelDeployConfig) {
 	}
 
 	await task("Vercel 部署工作流", async ({ task }) => {
+		// 0. 检测变更范围，确定最终部署目标
+		const { result: finalTargets } = await task("0. 检测变更范围", async ({ setTitle }) => {
+			if (options?.forceAll) {
+				setTitle("0. 强制全量部署（--force-all）");
+				return availableTargets;
+			}
+
+			if (!options?.diffBase) {
+				setTitle("0. 全量部署（未指定 --diff-base）");
+				return availableTargets;
+			}
+
+			const changedFiles = getChangedFiles(options.diffBase);
+
+			if (changedFiles === null) {
+				setTitle("0. Git 不可用，已降级为全量部署");
+				return availableTargets;
+			}
+
+			if (changedFiles.length === 0) {
+				setTitle("0. 无文件变更，跳过所有部署");
+				return [];
+			}
+
+			const { deploy, skipped } = filterTargetsByDiff(availableTargets, changedFiles);
+
+			skipped.forEach((t) => consola.info(`跳过未变更目标: ${t.targetCWD}`));
+
+			setTitle(`0. 精确部署: ${deploy.length} / ${availableTargets.length} 个目标`);
+			return deploy;
+		});
+
+		if (finalTargets.length === 0) {
+			consola.success("所有目标均无变更，无需部署");
+			return;
+		}
+
 		// 1. Link 阶段（并行）
 		await task("1. Link 项目", async () => {
-			const linkTasks = availableTargets.map((target) => createLinkTask(config, target));
+			const linkTasks = finalTargets.map((target) => createLinkTask(config, target));
 
 			await task.group((task) => linkTasks.map((t) => task(t.name, t.fn)));
 		});
 
 		// 2. Build 阶段（并行）
 		await task("2. 构建项目", 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) {
 				consola.warn("没有需要执行 build 的目标");
@@ -87,7 +143,7 @@ export async function executeDeploymentWorkflow(config: VercelDeployConfig) {
 
 		// 4. UserCommands + CopyDist 阶段（并行目标，串行步骤）
 		await task("4. 执行用户命令与文件复制", async () => {
-			const targetTasks = availableTargets.map((target) => ({
+			const targetTasks = finalTargets.map((target) => ({
 				name: `处理目标: ${target.targetCWD}`,
 				fn: async () => {
 					// 如果不是 userCommands 类型，跳过
@@ -116,7 +172,7 @@ export async function executeDeploymentWorkflow(config: VercelDeployConfig) {
 
 		// 5. Deploy + Alias 阶段（并行目标，串行步骤）
 		await task("5. 部署与设置别名", async () => {
-			const deployAliasTasks = availableTargets.map((target) => ({
+			const deployAliasTasks = finalTargets.map((target) => ({
 				name: `部署与别名: ${target.targetCWD}`,
 				fn: async () => {
 					// 5.1 部署