ai-yuca 1.6.3 → 1.6.4

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 ## [Unreleased]
 
+## [1.6.4] - 2026-06-08
+
+### Added
+- 新增 `pm2-release` 命令，可读取项目 `package.json` 的 `ai-yuca.pm2Release` 配置，统一执行 PM2 远程 `setup` / `deploy`。
+- `pm2-release` 支持运行时生成临时 PM2 ecosystem 配置，项目侧只需维护 `package.json` 的发布差异配置。
+- `pm2-release` 支持 SSH alias 预检、SSH ControlMaster 复用、发布 ref 覆盖、PM2 命令覆盖，以及 test/prod/all 目标。
+
 ## [1.6.3] - 2026-06-05
 
 ### Added

package/README.md

@@ -39,6 +39,9 @@ ai-yuca upload-config
 # 部署到测试环境
 ai-yuca deploy -e test
 
+# 通过 PM2 发布当前项目
+ai-yuca pm2-release deploy prod
+
 # 压缩图片
 ai-yuca sharp -s ./assets -o ./assets-compressed -q 80
 
@@ -59,6 +62,7 @@ ai-yuca proxy-upload-image -f ./logo.png --raw
 | `download` | 从 GCP 存储桶下载文件或目录 |
 | `upload-config` | 基于 `vs.config.json` 批量上传 |
 | `deploy` | 一键部署到指定环境 |
+| `pm2-release` | 读取项目配置并通过 PM2 远程发布 |
 | `init` | 交互生成或更新 `vs.config.json` |
 | `sharp` | 使用 sharp 本地压缩 jpg/png/webp |
 | `tinify` | 使用 Tinify API 压缩 jpg/png/webp |
@@ -182,6 +186,59 @@ ai-yuca deploy -e test --show-config
 ai-yuca deploy -e test --replace-config-name-with-package
 ```
 
+### PM2 远程发布
+
+`pm2-release` 读取当前项目 `package.json` 的 `ai-yuca.pm2Release` 配置，用于把多个前端项目统一到一套 PM2 发布命令。命令会先检查本机 SSH alias 是否配置了有效 `HostName`，再运行时生成临时 PM2 ecosystem 配置并复用 SSH master 连接执行 PM2；项目内不需要保留 `ecosystem.config.cjs`。
+
+```bash
+# 初始化 test 和 prod 远端目录
+ai-yuca pm2-release setup
+
+# 发布测试环境
+ai-yuca pm2-release deploy test
+
+# 发布生产环境
+ai-yuca pm2-release deploy prod
+
+# 指定分支或 ref
+ai-yuca pm2-release deploy test --ref feat_xxx
+ai-yuca pm2-release deploy prod --ref origin/main
+```
+
+`package.json` 配置示例：
+
+```json
+{
+  "scripts": {
+    "pm2:setup": "ai-yuca pm2-release setup",
+    "pm2:deploy": "ai-yuca pm2-release deploy prod",
+    "pm2:deploy:test": "ai-yuca pm2-release deploy test"
+  },
+  "ai-yuca": {
+      "pm2Release": {
+      "repo": "git@github.com:HEchooo/project.git",
+      "packageManager": "pnpm",
+      "pm2Command": "pnpm exec pm2",
+      "deployName": "server",
+      "environments": {
+        "test": {
+          "hosts": "test",
+          "path": "/home/echooo/fed/project-test",
+          "ref": "origin/main",
+          "script": "ai:test"
+        },
+        "prod": {
+          "hosts": "test",
+          "path": "/home/echooo/fed/project",
+          "ref": "origin/main",
+          "script": "ai"
+        }
+      }
+    }
+  }
+}
+```
+
 ## 资源处理
 
 ### sharp 本地压缩

package/dist/bin/cli.js

@@ -59,6 +59,7 @@ const gKeys_1 = require("../src/gKeys");
 const font_1 = require("../src/font");
 const ico_1 = require("../src/ico");
 const proxyUploadImage_1 = require("../src/proxyUploadImage");
+const pm2Release_1 = require("../src/pm2Release");
 const program = new commander_1.Command();
 // 设置版本和描述
 program
@@ -230,6 +231,33 @@ program
         process.exit(1);
     }
 });
+// 添加 PM2 远程发布命令
+program
+    .command('pm2-release')
+    .description('通过当前项目 package.json 的 ai-yuca.pm2Release 配置执行 PM2 远程发布')
+    .argument('<action>', '操作类型：setup 或 deploy')
+    .argument('[target]', '发布目标：test、prod 或 all，setup 默认 all，deploy 默认 prod')
+    .option('-c, --config <path>', '指定 package.json 路径，默认向上查找当前项目 package.json')
+    .option('--ref <ref>', '指定发布分支或 ref，例如 main、origin/main、refs/heads/main')
+    .option('--env-name <name>', '覆盖注入到 PM2_DEPLOY_ENV 的环境名')
+    .option('--package-manager <name>', '覆盖 PM2 执行器推断，支持 npm 或 pnpm')
+    .option('--pm2-command <command>', '自定义 PM2 命令，例如 "pnpm exec pm2" 或 "npx pm2"')
+    .action((action, target, options) => {
+    try {
+        if (action !== 'setup' && action !== 'deploy') {
+            throw new Error('action 只能是 setup 或 deploy。');
+        }
+        const resolvedTarget = target || (action === 'setup' ? 'all' : 'prod');
+        if (resolvedTarget !== 'test' && resolvedTarget !== 'prod' && resolvedTarget !== 'all') {
+            throw new Error('target 只能是 test、prod 或 all。');
+        }
+        (0, pm2Release_1.pm2Release)(action, resolvedTarget, options);
+    }
+    catch (err) {
+        console.error(`PM2 发布错误: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+});
 // 使用从types导入的UploadCommandOptions接口
 // 添加upload命令
 program

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "ai-yuca",
-    "version": "1.6.3",
+    "version": "1.6.4",
     "description": "一个用AI生成的开发辅助工具",
     "main": "dist/src/index.js",
     "types": "dist/src/index.d.ts",

package/dist/src/pm2Release.d.ts

@@ -0,0 +1,2 @@
+import { Pm2ReleaseAction, Pm2ReleaseCommandOptions, Pm2ReleaseTarget } from './types/pm2Release';
+export declare function pm2Release(action: Pm2ReleaseAction, target: Pm2ReleaseTarget | 'all', options?: Pm2ReleaseCommandOptions): void;

package/dist/src/pm2Release.js

@@ -0,0 +1,321 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pm2Release = pm2Release;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+function readJson(filePath) {
+    return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+}
+function findPackageJson(startDir) {
+    let currentDir = path.resolve(startDir);
+    while (true) {
+        const packagePath = path.join(currentDir, 'package.json');
+        if (fs.existsSync(packagePath)) {
+            return packagePath;
+        }
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir) {
+            throw new Error('未找到 package.json，请在项目根目录或子目录中执行。');
+        }
+        currentDir = parentDir;
+    }
+}
+function normalizeRef(ref) {
+    if (ref.startsWith('origin/') || ref.startsWith('refs/')) {
+        return ref;
+    }
+    return `origin/${ref}`;
+}
+function normalizeHosts(hosts) {
+    const hostList = Array.isArray(hosts) ? hosts : (hosts || 'test').split(',');
+    return hostList.map((host) => host.trim()).filter(Boolean);
+}
+function getRepoUrl(packageRoot, config) {
+    if (config.repo) {
+        return config.repo;
+    }
+    try {
+        return (0, child_process_1.execFileSync)('git', ['remote', 'get-url', 'origin'], {
+            cwd: packageRoot,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch (_a) {
+        throw new Error('未检测到 git origin，请在 package.json 的 ai-yuca.pm2Release.repo 中配置仓库地址。');
+    }
+}
+function buildSshControlPath(config, projectName, packageRoot) {
+    if (config.sshControlPath) {
+        return config.sshControlPath;
+    }
+    const controlDir = config.sshControlDir || process.env.PM2_SSH_CONTROL_DIR || '/tmp';
+    fs.mkdirSync(controlDir, { recursive: true });
+    if (controlDir !== '/tmp') {
+        fs.chmodSync(controlDir, 0o700);
+    }
+    // ControlPath 使用项目名隔离，避免多个项目共享 master 连接时互相覆盖。
+    const safeName = projectName || path.basename(packageRoot);
+    return path.join(controlDir, `${safeName}-pm2-%C`);
+}
+function ensureSshAliases(hosts) {
+    var _a;
+    for (const host of hosts) {
+        let sshConfig = '';
+        try {
+            sshConfig = (0, child_process_1.execFileSync)('ssh', ['-G', host], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] });
+        }
+        catch (_b) {
+            throw new Error(`未找到 ssh 配置别名: ${host}，请先在 ~/.ssh/config 中配置 Host ${host}。`);
+        }
+        const hostname = (_a = sshConfig
+            .split('\n')
+            .map((line) => line.trim().split(/\s+/))
+            .find(([key]) => key === 'hostname')) === null || _a === void 0 ? void 0 : _a[1];
+        if (!hostname || hostname === host) {
+            throw new Error(`ssh ${host} 未配置有效 HostName，请先在 ~/.ssh/config 中配置 Host ${host}。`);
+        }
+    }
+}
+function warmSshMaster(hosts, controlPath) {
+    for (const host of hosts) {
+        const sharedOptions = [
+            '-o',
+            'ControlMaster=auto',
+            '-o',
+            'ControlPersist=10m',
+            '-o',
+            `ControlPath=${controlPath}`,
+        ];
+        try {
+            (0, child_process_1.execFileSync)('ssh', [...sharedOptions, '-O', 'check', host], { stdio: 'ignore' });
+            continue;
+        }
+        catch (_a) {
+            // check 失败时建立 master 连接，后续 PM2 可复用登录态。
+        }
+        try {
+            (0, child_process_1.execFileSync)('ssh', ['-MNf', '-o', 'ControlMaster=yes', '-o', 'ControlPersist=10m', '-o', `ControlPath=${controlPath}`, host], {
+                stdio: 'inherit',
+            });
+        }
+        catch (_b) {
+            console.warn(`SSH master 连接预热失败，继续由 PM2 直接连接: ${host}`);
+        }
+    }
+}
+function shellQuote(value) {
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function hasRemoteSource(hosts, controlPath, deployPath) {
+    const sourcePath = path.posix.join(deployPath, 'source', '.git');
+    for (const host of hosts) {
+        try {
+            const output = (0, child_process_1.execFileSync)('ssh', [
+                '-o',
+                'ControlMaster=auto',
+                '-o',
+                'ControlPersist=10m',
+                '-o',
+                `ControlPath=${controlPath}`,
+                host,
+                'sh',
+                '-lc',
+                `test -d ${shellQuote(sourcePath)} && echo exists || echo missing`,
+            ], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] }).trim();
+            if (!output.split(/\s+/).includes('exists')) {
+                return false;
+            }
+        }
+        catch (_a) {
+            return false;
+        }
+    }
+    return true;
+}
+function getPm2Command(config, options) {
+    const command = options.pm2Command || config.pm2Command;
+    if (command) {
+        const [bin, ...args] = command.split(/\s+/).filter(Boolean);
+        return [bin, args];
+    }
+    const packageManager = options.packageManager || config.packageManager || 'npm';
+    if (packageManager === 'pnpm') {
+        return ['pnpm', ['exec', 'pm2']];
+    }
+    return ['npx', ['pm2']];
+}
+function getInstallCommand(config) {
+    if (config.installCommand) {
+        return config.installCommand;
+    }
+    return config.packageManager === 'pnpm' ? 'pnpm install --frozen-lockfile' : 'npm ci';
+}
+function getRunCommand(config) {
+    if (config.runCommand) {
+        return config.runCommand;
+    }
+    return config.packageManager === 'pnpm' ? 'pnpm run' : 'npm run';
+}
+function escapeJsString(value) {
+    return value.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+}
+function createTempEcosystem(packageRoot, packageJson, config, controlPath) {
+    const projectName = packageJson.name || path.basename(packageRoot);
+    const repo = getRepoUrl(packageRoot, config);
+    const prodConfig = getEnvConfig(config, 'prod');
+    const prodHosts = normalizeHosts(prodConfig.hosts).join(',');
+    const prodRef = normalizeRef(prodConfig.ref || 'origin/main');
+    const prodScript = prodConfig.script || 'ai';
+    const installCommand = getInstallCommand(config);
+    const runCommand = getRunCommand(config);
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ai-yuca-pm2-'));
+    const ecosystemPath = path.join(tempDir, 'ecosystem.config.cjs');
+    const content = `const REPO = '${escapeJsString(repo)}';
+const DEPLOY_HOST = (process.env.PM2_DEPLOY_HOST || '${escapeJsString(prodHosts || 'test')}')
+  .split(',')
+  .map((host) => host.trim())
+  .filter(Boolean);
+const DEPLOY_PATH = process.env.PM2_DEPLOY_PATH || '${escapeJsString(prodConfig.path)}';
+const DEPLOY_REF = process.env.PM2_DEPLOY_REF || '${escapeJsString(prodRef)}';
+const DEPLOY_ENV = process.env.PM2_DEPLOY_ENV || 'prod';
+const DEPLOY_SCRIPT = process.env.PM2_DEPLOY_SCRIPT || '${escapeJsString(prodScript)}';
+const SSH_CONTROL_PATH =
+  process.env.PM2_SSH_CONTROL_PATH || '${escapeJsString(controlPath)}';
+const SSH_OPTIONS = [
+  'ControlMaster=auto',
+  'ControlPersist=10m',
+  \`ControlPath=\${SSH_CONTROL_PATH}\`,
+];
+
+const withNvm = (command) =>
+  [
+    '. ~/.nvm/nvm.sh',
+    'corepack enable',
+    'export PATH=$(pnpm config get global-bin-dir 2>/dev/null || npm config get prefix)/bin:$HOME/.npm-global/bin:$HOME/.local/bin:$PATH',
+    \`echo pm2-release-env=\${DEPLOY_ENV} script=\${DEPLOY_SCRIPT} path=$PWD\`,
+    'echo node=$(command -v node) pnpm=$(command -v pnpm || true) npm=$(command -v npm) ai-yuca=$(command -v ai-yuca || true)',
+    command,
+  ].join(' && ');
+
+module.exports = {
+  deploy: {
+    server: {
+      host: DEPLOY_HOST.length === 1 ? DEPLOY_HOST[0] : DEPLOY_HOST,
+      ref: DEPLOY_REF,
+      repo: REPO,
+      path: DEPLOY_PATH,
+      // 发布目标由 ai-yuca pm2-release 注入，避免项目维护 ecosystem.config.cjs。
+      ssh_options: SSH_OPTIONS,
+      'post-deploy': withNvm(
+        \`${escapeJsString(installCommand)} && ${escapeJsString(runCommand)} \${DEPLOY_SCRIPT}\`,
+      ),
+    },
+  },
+};
+`;
+    fs.writeFileSync(ecosystemPath, content);
+    return ecosystemPath;
+}
+function getEnvConfig(config, target) {
+    var _a;
+    const envConfig = (_a = config.environments) === null || _a === void 0 ? void 0 : _a[target];
+    if (!(envConfig === null || envConfig === void 0 ? void 0 : envConfig.path)) {
+        throw new Error(`pm2Release.environments.${target}.path 不能为空。`);
+    }
+    return envConfig;
+}
+function runPm2(packageRoot, packageJson, config, action, target, options) {
+    const envConfig = getEnvConfig(config, target);
+    const hosts = normalizeHosts(envConfig.hosts);
+    const controlPath = buildSshControlPath(config, packageJson.name || '', packageRoot);
+    const deployName = config.deployName || 'server';
+    const ref = normalizeRef(options.ref || envConfig.ref || 'origin/main');
+    const script = envConfig.script || (target === 'test' ? 'ai:test' : 'ai');
+    const [pm2Bin, pm2Args] = getPm2Command(config, options);
+    const ecosystem = createTempEcosystem(packageRoot, packageJson, config, controlPath);
+    ensureSshAliases(hosts);
+    warmSshMaster(hosts, controlPath);
+    const env = {
+        ...process.env,
+        PM2_DEPLOY_HOST: hosts.join(','),
+        PM2_DEPLOY_PATH: envConfig.path,
+        PM2_DEPLOY_REF: action === 'setup' ? normalizeRef(envConfig.setupRef || ref) : ref,
+        PM2_DEPLOY_ENV: options.envName || target,
+        PM2_DEPLOY_SCRIPT: action === 'setup' ? envConfig.setupScript || script : script,
+        PM2_SSH_CONTROL_PATH: controlPath,
+    };
+    console.log(`PM2 ${action} target: env=${target} host=${hosts.join(',')} path=${envConfig.path} script=${env.PM2_DEPLOY_SCRIPT} ref=${env.PM2_DEPLOY_REF}`);
+    if (action === 'setup' && hasRemoteSource(hosts, controlPath, envConfig.path)) {
+        console.log(`PM2 setup skipped: ${envConfig.path}/source already exists on ${hosts.join(',')}`);
+        return;
+    }
+    try {
+        const args = [...pm2Args, 'deploy', ecosystem, deployName];
+        if (action === 'setup') {
+            args.push('setup');
+        }
+        else {
+            args.push('--force');
+        }
+        (0, child_process_1.execFileSync)(pm2Bin, args, {
+            cwd: packageRoot,
+            env,
+            stdio: 'inherit',
+        });
+    }
+    finally {
+        fs.rmSync(path.dirname(ecosystem), { recursive: true, force: true });
+    }
+}
+function pm2Release(action, target, options = {}) {
+    var _a;
+    const packagePath = options.config
+        ? path.resolve(options.config)
+        : findPackageJson(process.cwd());
+    const packageRoot = path.dirname(packagePath);
+    const packageJson = readJson(packagePath);
+    const config = (_a = packageJson['ai-yuca']) === null || _a === void 0 ? void 0 : _a.pm2Release;
+    if (!config) {
+        throw new Error('package.json 缺少 ai-yuca.pm2Release 配置。');
+    }
+    const targets = target === 'all' ? ['test', 'prod'] : [target];
+    for (const releaseTarget of targets) {
+        runPm2(packageRoot, packageJson, config, action, releaseTarget, options);
+    }
+}

package/dist/src/types/index.d.ts

@@ -16,3 +16,4 @@ export * from './gKeys';
 export * from './font';
 export * from './ico';
 export * from './proxyUploadImage';
+export * from './pm2Release';

package/dist/src/types/index.js

@@ -40,3 +40,4 @@ __exportStar(require("./gKeys"), exports);
 __exportStar(require("./font"), exports);
 __exportStar(require("./ico"), exports);
 __exportStar(require("./proxyUploadImage"), exports);
+__exportStar(require("./pm2Release"), exports);

package/dist/src/types/pm2Release.d.ts

@@ -0,0 +1,31 @@
+export type Pm2ReleaseAction = 'setup' | 'deploy';
+export type Pm2ReleaseTarget = 'test' | 'prod';
+export interface Pm2ReleaseCommandOptions {
+    config?: string;
+    packageManager?: string;
+    pm2Command?: string;
+    envName?: string;
+    ref?: string;
+}
+export interface Pm2ReleaseEnvConfig {
+    hosts?: string | string[];
+    path: string;
+    ref?: string;
+    script?: string;
+    setupRef?: string;
+    setupScript?: string;
+}
+export interface Pm2ReleaseConfig {
+    repo?: string;
+    deployName?: string;
+    sshControlDir?: string;
+    sshControlPath?: string;
+    packageManager?: string;
+    pm2Command?: string;
+    installCommand?: string;
+    runCommand?: string;
+    environments: {
+        test: Pm2ReleaseEnvConfig;
+        prod: Pm2ReleaseEnvConfig;
+    };
+}

package/dist/src/types/pm2Release.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-yuca",
-  "version": "1.6.3",
+  "version": "1.6.4",
   "description": "一个用AI生成的开发辅助工具",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",