@mindbase/deploy 1.1.5 → 1.2.1

package/README.md

@@ -0,0 +1,229 @@
+# deploy CLI
+
+多项目部署工具，支持批量部署到多台服务器。
+
+## 功能特点
+
+- **交互式部署**：通过友好的命令行界面选择目标服务器和项目
+- **笛卡尔组合部署**：选中的每个服务器都会部署全部选中的项目（N 个服务器 × M 个项目 = N×M 次部署）
+- **灵活配置**：项目部署步骤完全自定义，支持本地命令、远程命令、文件上传/下载等
+- **多环境支持**：部署时现场选择目标服务器，不再写死在配置中
+
+## 命令结构
+
+```bash
+deploy              # 部署：选择服务器 → 选择项目 → 开始部署
+deploy init [path]  # 初始化项目配置（path 缺省为当前目录）
+deploy server ...   # 服务器管理
+```
+
+## 快速开始
+
+### 1. 配置服务器
+
+首次使用需要先添加目标服务器：
+
+```bash
+# 添加服务器
+deploy server add
+
+# 列出所有服务器
+deploy server list
+
+# 测试连接
+deploy server test
+```
+
+服务器配置保存在 `~/.mindbase/deploy.json`，支持密码和私钥两种认证方式。
+
+### 2. 初始化项目
+
+在项目目录下运行：
+
+```bash
+cd /path/to/your/project
+deploy init
+```
+
+交互式引导会询问：
+- 项目名称
+- 目标服务器（选择已配置的服务器，用于 SFTP 连接浏览远端目录）
+- 本地目录（默认 `./`）
+- 远端目录（可浏览服务器目录或手动输入）
+- 部署步骤（添加构建、上传、重启等步骤）
+
+完成后会在当前目录生成 `deploy.config.json` 配置文件。
+
+### 3. 部署
+
+在包含多个 `deploy.config.json` 的目录（如 monorepo 根目录）运行：
+
+```bash
+deploy
+```
+
+交互流程：
+1. **选择服务器**（多选，空格切换，a 全选）
+2. **选择项目**（多选）
+3. **确认摘要**（显示 N×M=K 次部署）
+4. **开始部署**（依次连接每个服务器，部署所有选中项目）
+
+## 配置文件结构
+
+`deploy.config.json` 示例：
+
+```json
+{
+  "name": "photo",
+  "localDir": "./",
+  "remoteDir": "/application/lightUp-web/photo/",
+  "steps": [
+    { "type": "log", "message": "构建相册" },
+    { "type": "local", "cmd": "pnpm run build", "cwd": "${localDir}" },
+    { "type": "remote", "cmd": "mkdir -p ${remoteDir}" },
+    { "type": "uploadDir", "local": "${localDir}/dist", "remote": "${remoteDir}" }
+  ]
+}
+```
+
+### 配置字段说明
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `name` | string | 项目显示名称 |
+| `localDir` | string | 本地目录（相对或绝对路径） |
+| `remoteDir` | string | 远端部署目录 |
+| `steps` | Step[] | 部署步骤数组 |
+
+### 步骤类型（Step）
+
+| 类型 | 说明 | 示例 |
+|---|---|---|
+| `log` | 输出日志信息 | `{ "type": "log", "message": "开始构建" }` |
+| `local` | 本地执行命令 | `{ "type": "local", "cmd": "npm run build", "cwd": "${localDir}" }` |
+| `remote` | 远程执行命令 | `{ "type": "remote", "cmd": "pm2 restart myapp" }` |
+| `uploadDir` | 上传整个目录 | `{ "type": "uploadDir", "local": "./dist", "remote": "/app/dist" }` |
+| `uploadFile` | 上传单个文件 | `{ "type": "uploadFile", "local": "./package.json", "remote": "/app/package.json" }` |
+| `downloadDir` | 下载目录（备份） | `{ "type": "downloadDir", "remote": "/app/data", "local": "./backup" }` |
+| `downloadFile` | 下载文件（备份） | `{ "type": "downloadFile", "remote": "/app/config.json", "local": "./backup.json" }` |
+
+### 变量替换
+
+步骤中支持以下变量，运行时自动替换：
+
+| 变量 | 说明 | 示例值 |
+|---|---|---|
+| `${localDir}` | 项目本地目录 | `/path/to/project` |
+| `${remoteDir}` | 项目远端目录 | `/app/photo/` |
+| `${projectName}` | 项目名称 | `photo` |
+| `${date}` | 当前日期 | `2026-06-17` |
+| `${datetime}` | 当前日期时间 | `2026-06-17_14-30-52` |
+| `${timestamp}` | Unix 毫秒时间戳 | `1718621452000` |
+
+日期变量可用 `${name:格式}` 自定义格式，如 `${datetime:YYYYMMDD-HHmmss}` → `20260617-143052`。
+
+备份示例：
+
+```json
+{
+  "type": "downloadDir",
+  "remote": "${remoteDir}",
+  "local": "${localDir}/backup_${datetime}"
+}
+```
+
+## 服务器管理
+
+```bash
+# 添加服务器
+deploy server add
+
+# 编辑服务器
+deploy server edit
+
+# 删除服务器
+deploy server delete
+
+# 测试连接
+deploy server test
+
+# 列出所有服务器
+deploy server list
+```
+
+### 全局配置文件
+
+服务器配置保存在 `~/.mindbase/deploy.json`：
+
+```json
+{
+  "servers": {
+    "own": {
+      "host": "192.168.1.100",
+      "port": 22,
+      "username": "root",
+      "password": "***"
+    },
+    "backup": {
+      "host": "192.168.1.101",
+      "port": 22,
+      "username": "root",
+      "privateKeyPath": "~/.ssh/id_rsa",
+      "passphrase": "***"
+    }
+  }
+}
+```
+
+## 使用场景
+
+### Monorepo 批量部署
+
+```bash
+cd /path/to/monorepo  # 包含多个子项目，每个都有 deploy.config.json
+deploy                # 选择服务器和项目，一键部署所有
+```
+
+### 单项目部署
+
+```bash
+cd /path/to/project
+deploy                # 单选本项目，部署到选中服务器
+```
+
+### 多环境部署
+
+```bash
+deploy                # 多选 staging、production 两台服务器
+                      # 选择所有项目，一次性部署到所有环境
+```
+
+## 边界情况处理
+
+- **服务器连接失败**：询问是否跳过并继续下一个服务器
+- **项目部署失败**：询问是否继续部署下一个项目（当前服务器连接保持）
+- **无可用服务器**：提示先运行 `deploy server add`
+- **无可用项目**：提示先运行 `deploy init`
+- **用户取消**：任何交互步骤按 Ctrl+C 均可安全退出
+
+## 技术实现
+
+- **依赖**：`@clack/prompts`（交互）、`ssh2-sftp-client`（SFTP）、`commander.js`（命令框架）
+- **变量解析**：步骤中的变量在运行时替换
+- **错误处理**：失败时询问用户决策，支持跳过/中止
+- **日志输出**：统一使用 `@clack/prompts` 格式，逐行显示命令输出
+
+## 开发
+
+```bash
+# 直接运行（无需构建）
+cd cli/apps/deploy
+tsx bin/index.ts
+
+# 或在项目根目录
+tsx cli/apps/deploy/bin/index.ts
+```
+
+## License
+
+MIT

package/bin/shared.ts

@@ -1,6 +1,6 @@
 import { Command } from 'commander';
 import * as clack from '@clack/prompts';
-import { runApp, runProject, showConfig } from '../src/app.js';
+import { runApp } from '../src/app.js';
 import { runInit } from '../src/init/app.js';
 import { createServerCommand } from '../src/server/app.js';
 
@@ -14,14 +14,12 @@ export function createDeployProgram(): Command {
     .description('部署工具')
     .version('1.0.0')
     .action(async () => {
-      clack.intro('deploy');
       try {
         await runApp();
       } catch (err) {
         clack.log.error(`执行失败: ${err}`);
         process.exit(1);
       }
-      clack.outro('再见');
     });
 
   program
@@ -37,27 +35,6 @@ export function createDeployProgram(): Command {
       }
     });
 
-  program
-    .command('run [path]')
-    .description('部署单个项目（path 缺省为 cwd，可传目录或 deploy.config.json）')
-    .option('-s, --server <server>', '覆盖项目配置中的 server')
-    .action(async (path: string | undefined, options: { server?: string }) => {
-      clack.intro('deploy run');
-      try {
-        await runProject(path, options.server);
-      } catch (err) {
-        clack.log.error(`执行失败: ${err}`);
-        process.exit(1);
-      }
-    });
-
-  program
-    .command('config')
-    .description('查看全局 servers 配置')
-    .action(() => {
-      showConfig();
-    });
-
   // 服务器管理子命令
   program.addCommand(createServerCommand());
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindbase/deploy",
-  "version": "1.1.5",
+  "version": "1.2.1",
   "description": "MindBase 部署工具",
   "type": "module",
   "bin": {
@@ -21,6 +21,7 @@
     "@clack/prompts": "^0.9.1",
     "commander": "^12.0.0",
     "cross-spawn": "^7.0.6",
+    "dayjs": "^1.11.13",
     "picocolors": "^1.1.1",
     "ssh2-sftp-client": "^9.1.0",
     "tsx": "^4.19.0",

package/src/app.ts

@@ -2,7 +2,7 @@ import * as clack from '@clack/prompts';
 import pc from 'picocolors';
 import { relative } from 'path';
 import { noteBox } from '@mindbase/cli-ui';
-import { getConfig, getConfigPath, discoverProjectConfigs, loadProjectConfig } from './config/manager.js';
+import { getConfig, discoverProjectConfigs } from './config/manager.js';
 import type { ProjectConfig } from './config/schema.js';
 import { connectSftp } from './ssh/client.js';
 import { runSteps } from './script/runner.js';
@@ -17,86 +17,18 @@ function handleCancel<T>(result: T | symbol): T {
 }
 
 /**
- * 查看配置
- */
-export function showConfig(): void {
-  clack.intro('配置信息');
-  const config = getConfig();
-  const path = getConfigPath();
-  noteBox(`配置文件: ${path}\n\n${JSON.stringify(config, null, 2)}`, '当前配置');
-  clack.outro('完成');
-}
-
-/**
- * 显示项目配置摘要并让用户确认部署
- */
-async function confirmProjectDeploy(project: ProjectConfig, serverId: string): Promise<boolean> {
-  const summary = [
-    `名称: ${project.name}`,
-    `服务器: ${serverId}`,
-    `本地目录: ${project.localDir}`,
-    `远端目录: ${project.remoteDir}`,
-    `步骤数: ${project.steps.length}`,
-  ].join('\n');
-  noteBox(summary, '即将部署');
-  return handleCancel<boolean>(
-    await clack.confirm({ message: '确认部署？', initialValue: true })
-  );
-}
-
-/**
- * 直接运行指定项目（单项目模式）
- */
-export async function runProject(targetPath?: string, serverOverride?: string): Promise<void> {
-  const project = loadProjectConfig(targetPath);
-  const globalConfig = getConfig();
-
-  const serverId = serverOverride || project.server;
-  const serverConfig = globalConfig.servers[serverId];
-  if (!serverConfig) {
-    clack.log.error(`服务器 "${serverId}" 不存在，请先运行 deploy server add`);
-    process.exit(1);
-  }
-
-  clack.intro(`部署 ${pc.cyan(project.name)} → ${pc.cyan(serverId)}`);
-
-  if (!(await confirmProjectDeploy(project, serverId))) {
-    clack.log.info('已取消');
-    clack.outro('完成');
-    return;
-  }
-
-  const spinner = clack.spinner();
-  spinner.start('连接服务器...');
-  const sftp = await connectSftp(project.name, serverConfig);
-  spinner.stop('已连接');
-
-  try {
-    await runSteps(project.steps, project, sftp);
-    clack.log.success(`${project.name} 部署完成`);
-  } catch (err) {
-    clack.log.error(`部署失败: ${err}`);
-  } finally {
-    await sftp.end();
-  }
-
-  clack.outro('完成');
-}
-
-/**
- * 交互式主流程：扫描 cwd 下所有 deploy.config.json → 多选 → 按 server 分组部署
+ * 交互式主流程：选 server → 选项目 → 按笛卡尔分组部署
  */
 export async function runApp(): Promise<void> {
   const cwd = process.cwd();
   const discovered = discoverProjectConfigs(cwd);
   const globalConfig = getConfig();
 
+  // 边界校验（intro 之前）
   if (discovered.length === 0) {
     clack.log.error(`未在 ${cwd} 下找到任何 deploy.config.json，请先运行 deploy init`);
     return;
   }
-
-  // 0 个服务器直接报错
   if (Object.keys(globalConfig.servers).length === 0) {
     clack.log.error('没有已配置的服务器，请先运行 deploy server add');
     return;
@@ -104,8 +36,21 @@ export async function runApp(): Promise<void> {
 
   clack.intro('deploy');
 
-  // 选择项目
-  let selected: { path: string; config: ProjectConfig }[];
+  // 多选 server
+  const serverIds = Object.keys(globalConfig.servers);
+  const selectedServers = handleCancel<string[]>(
+    await clack.multiselect({
+      message: '选择要部署到的服务器（空格切换，a 全选）',
+      options: serverIds.map((id) => ({
+        value: id,
+        label: `${id} (${globalConfig.servers[id].host})`,
+      })),
+      required: true,
+    })
+  );
+
+  // 多选项目
+  let selectedProjects: typeof discovered;
 
   if (discovered.length === 1) {
     const only = discovered[0];
@@ -117,57 +62,68 @@ export async function runApp(): Promise<void> {
       clack.outro('已取消');
       return;
     }
-    selected = [only];
+    selectedProjects = [only];
   } else {
-    selected = handleCancel<typeof discovered>(
+    selectedProjects = handleCancel<typeof discovered>(
       await clack.multiselect({
         message: '选择要部署的项目（空格切换，a 全选）',
         options: discovered.map((item) => ({
           value: item,
-          label: `${item.config.name} (${relative(cwd, item.path) || item.path}) → ${pc.dim(item.config.server)}`,
+          label: `${item.config.name} (${relative(cwd, item.path) || item.path})`,
         })),
         required: true,
       })
     );
   }
 
-  // 校验所有选中项目的 server 都存在
-  const missingServers = new Set<string>();
-  for (const item of selected) {
-    if (!globalConfig.servers[item.config.server]) {
-      missingServers.add(item.config.server);
-    }
-  }
-  if (missingServers.size > 0) {
-    clack.log.error(`以下服务器未配置: ${[...missingServers].join(', ')}`);
-    clack.outro('已中止');
-    return;
-  }
+  // 确认摘要
+  const summaryLines = [
+    `服务器: ${selectedServers.map((s) => `${s} (${globalConfig.servers[s].host})`).join(', ')}`,
+    `项目:   ${selectedProjects.map((p) => p.config.name).join(', ')}`,
+  ].join('\n');
+  noteBox(summaryLines, '即将部署');
 
-  // 按 server 分组
-  const groups = new Map<string, { path: string; config: ProjectConfig }[]>();
-  for (const item of selected) {
-    const arr = groups.get(item.config.server) ?? [];
-    arr.push(item);
-    groups.set(item.config.server, arr);
+  const confirmed = handleCancel<boolean>(
+    await clack.confirm({ message: '确认开始部署？', initialValue: true })
+  );
+  if (!confirmed) {
+    clack.outro('已取消');
+    return;
   }
 
-  // 依次连接每个 server，组内项目依次部署
-  for (const [serverId, items] of groups) {
+  // 按 server 分组遍历（笛卡尔：每个 server 部署全部选中项目）
+  let anyFailure = false;
+  for (const serverId of selectedServers) {
     const serverConfig = globalConfig.servers[serverId];
     const spinner = clack.spinner();
-    spinner.start(`连接 ${serverId}...`);
-    const sftp = await connectSftp('deploy', serverConfig);
-    spinner.stop('已连接');
+    spinner.start(`连接 ${serverId} (${serverConfig.host})...`);
+    let sftp;
+    try {
+      sftp = await connectSftp('deploy', serverConfig);
+    } catch (err) {
+      spinner.stop(`连接失败: ${serverId}`);
+      clack.log.error(`${serverId} 连接失败: ${err}`);
+      anyFailure = true;
+      const cont = handleCancel<boolean>(
+        await clack.confirm({ message: `${serverId} 不可用，是否跳过并继续下一个服务器？` })
+      );
+      if (!cont) {
+        clack.outro('已中止');
+        return;
+      }
+      continue;
+    }
+    spinner.stop(`已连接 ${serverId}`);
 
     try {
-      for (const { config } of items) {
+      for (const { config } of selectedProjects) {
         clack.log.step(`开始部署 ${pc.cyan(config.name)} → ${pc.cyan(serverId)}`);
         try {
           await runSteps(config.steps, config, sftp);
-          clack.log.success(`${config.name} 部署完成`);
+          clack.log.success(`${config.name} → ${serverId} 完成`);
         } catch (err) {
-          clack.log.error(`${config.name} 部署失败: ${err}`);
+          anyFailure = true;
+          clack.log.error(`${config.name} → ${serverId} 失败: ${err}`);
           const cont = handleCancel<boolean>(
             await clack.confirm({ message: '是否继续部署下一个项目？' })
           );
@@ -179,5 +135,5 @@ export async function runApp(): Promise<void> {
     }
   }
 
-  clack.outro('全部完成');
+  clack.outro(anyFailure ? '完成（存在失败项）' : '全部完成');
 }

package/src/config/schema.ts

@@ -85,8 +85,6 @@ export interface ProjectConfig {
   name: string;
   /** 本地目录（绝对路径或相对配置文件的路径，加载时解析为绝对路径） */
   localDir: string;
-  /** 目标服务器 ID（引用全局 servers） */
-  server: string;
   /** 远端目录 */
   remoteDir: string;
   /** 部署步骤 */

package/src/init/app.ts

@@ -50,6 +50,11 @@ const VARS_REFERENCE = [
   '  ${localDir}    项目本地目录',
   '  ${remoteDir}   项目远程目录',
   '  ${projectName} 项目名称',
+  '  ${date}        日期 (YYYY-MM-DD)',
+  '  ${datetime}    日期时间 (YYYY-MM-DD_HH-mm-ss)',
+  '  ${timestamp}   Unix 毫秒时间戳',
+  '',
+  '  可用 ${name:格式} 自定义，如 ${datetime:YYYYMMDD-HHmmss}',
 ].join('\n');
 
 /** 步骤类型示例 */
@@ -94,15 +99,15 @@ const STEP_EXAMPLES: Record<StepType, string> = {
     VARS_REFERENCE,
     '',
     '示例:',
-    '  远端: ${remoteDir}backup/',
-    '  本地: ${localDir}/backup',
+    '  远端: ${remoteDir}',
+    '  本地: ${localDir}/backup_${datetime}',
   ].join('\n'),
   downloadFile: [
     VARS_REFERENCE,
     '',
     '示例:',
     '  远端: ${remoteDir}config.json',
-    '  本地: ${localDir}/config.json.bak',
+    '  本地: ${localDir}/config.json.bak_${date}',
   ].join('\n'),
 };
 
@@ -384,7 +389,6 @@ export async function runInit(targetPath?: string): Promise<void> {
   const projectConfig: ProjectConfig = {
     name,
     localDir,
-    server: serverId,
     remoteDir,
     steps,
   };

package/src/script/parser.ts

@@ -1,22 +1,62 @@
+import dayjs from 'dayjs';
 import type { ProjectConfig } from '../config/schema.js';
 
-/**
- * 内置变量名
- */
-const BUILT_IN_VARS = ['localDir', 'remoteDir', 'projectName'] as const;
+/** 内置变量名（含日期时间变量） */
+const BUILT_IN_VARS = ['localDir', 'remoteDir', 'projectName', 'date', 'datetime', 'timestamp'] as const;
+
+/** 日期变量预设及其默认格式（timestamp 固定为毫秒，无 format） */
+const DATE_VAR_DEFAULTS: Record<string, string | null> = {
+  date: 'YYYY-MM-DD',
+  datetime: 'YYYY-MM-DD_HH-mm-ss',
+  timestamp: null, // 特殊：输出毫秒
+};
+
+/** 变量解析上下文（运行时动态变量） */
+export interface ResolveContext {
+  /** 时间锚点；缺省取当前时间。同一次部署应传同一个 Date 保证一致性 */
+  now?: Date;
+}
 
 /**
- * 替换字符串中的 ${varName} 占位符
+ * 替换字符串中的 ${varName} 或 ${name:format} 占位符
+ * - 静态变量：${localDir}、${remoteDir}、${projectName}
+ * - 日期变量：${date}、${datetime}、${timestamp}，可加 :format 自定义格式，如 ${datetime:YYYYMMDD-HHmmss}
+ * - 未知变量：原样保留（向后兼容）
  */
-export function resolveVariables(template: string, project: ProjectConfig): string {
-  const vars: Record<string, string> = {
+export function resolveVariables(
+  template: string,
+  project: ProjectConfig,
+  ctx: ResolveContext = {},
+): string {
+  const staticVars: Record<string, string> = {
     localDir: project.localDir,
     remoteDir: project.remoteDir,
     projectName: project.name,
   };
+  const now = ctx.now ?? new Date();
+
+  return template.replace(/\$\{([^}]+)\}/g, (match, expr: string) => {
+    // 按第一个冒号分割 name 和 format（format 内部可能含冒号，如 HH:mm:ss）
+    const colon = expr.indexOf(':');
+    const name = colon === -1 ? expr : expr.slice(0, colon);
+    const format = colon === -1 ? '' : expr.slice(colon + 1);
+
+    // 1. 静态变量优先
+    if (staticVars[name] !== undefined) {
+      return staticVars[name];
+    }
+
+    // 2. 日期变量
+    if (name in DATE_VAR_DEFAULTS) {
+      if (name === 'timestamp') {
+        return String(dayjs(now).valueOf());
+      }
+      // date/datetime 用默认格式或自定义格式
+      return dayjs(now).format(format || (DATE_VAR_DEFAULTS[name] as string));
+    }
 
-  return template.replace(/\$\{(\w+)\}/g, (match, key: string) => {
-    return vars[key] !== undefined ? vars[key] : match;
+    // 3. 未知变量原样保留（向后兼容）
+    return match;
   });
 }
 

package/src/script/runner.ts

@@ -38,27 +38,27 @@ function runLocal(cmd: string, cwd?: string): Promise<void> {
 /**
  * 执行单个步骤
  */
-async function runStep(step: Step, project: ProjectConfig, sftp: SftpClient): Promise<void> {
+async function runStep(step: Step, project: ProjectConfig, sftp: SftpClient, now: Date): Promise<void> {
   switch (step.type) {
     case 'log': {
-      const msg = resolveVariables(step.message, project);
+      const msg = resolveVariables(step.message, project, { now });
       clack.log.message(msg);
       break;
     }
     case 'local': {
-      const cmd = resolveVariables(step.cmd, project);
-      const cwd = step.cwd ? resolveVariables(step.cwd, project) : undefined;
+      const cmd = resolveVariables(step.cmd, project, { now });
+      const cwd = step.cwd ? resolveVariables(step.cwd, project, { now }) : undefined;
       await runLocal(cmd, cwd);
       break;
     }
     case 'remote': {
-      const cmd = resolveVariables(step.cmd, project);
+      const cmd = resolveVariables(step.cmd, project, { now });
       await execRemote(sftp, cmd);
       break;
     }
     case 'uploadDir': {
-      const local = resolveVariables(step.local, project);
-      const remote = resolveVariables(step.remote, project);
+      const local = resolveVariables(step.local, project, { now });
+      const remote = resolveVariables(step.remote, project, { now });
       clack.log.step(`上传目录: ${local} → ${remote}`);
       await sftp.mkdir(remote, true);
       await sftp.uploadDir(local, remote, { useFastput: true });
@@ -66,24 +66,24 @@ async function runStep(step: Step, project: ProjectConfig, sftp: SftpClient): Pr
       break;
     }
     case 'uploadFile': {
-      const local = resolveVariables(step.local, project);
-      const remote = resolveVariables(step.remote, project);
+      const local = resolveVariables(step.local, project, { now });
+      const remote = resolveVariables(step.remote, project, { now });
       clack.log.step(`上传文件: ${local} → ${remote}`);
       await sftp.fastPut(local, remote);
       clack.log.success('上传文件完成');
       break;
     }
     case 'downloadDir': {
-      const remote = resolveVariables(step.remote, project);
-      const local = resolveVariables(step.local, project);
+      const remote = resolveVariables(step.remote, project, { now });
+      const local = resolveVariables(step.local, project, { now });
       clack.log.step(`下载目录: ${remote} → ${local}`);
       await sftp.downloadDir(remote, local);
       clack.log.success('下载目录完成');
       break;
     }
     case 'downloadFile': {
-      const remote = resolveVariables(step.remote, project);
-      const local = resolveVariables(step.local, project);
+      const remote = resolveVariables(step.remote, project, { now });
+      const local = resolveVariables(step.local, project, { now });
       clack.log.step(`下载文件: ${remote} → ${local}`);
       await sftp.fastGet(remote, local);
       clack.log.success('下载文件完成');
@@ -96,7 +96,8 @@ async function runStep(step: Step, project: ProjectConfig, sftp: SftpClient): Pr
  * 执行项目的所有步骤
  */
 export async function runSteps(steps: Step[], project: ProjectConfig, sftp: SftpClient): Promise<void> {
+  const now = new Date(); // 整个项目部署共用同一时间戳
   for (const step of steps) {
-    await runStep(step, project, sftp);
+    await runStep(step, project, sftp, now);
   }
 }