@noahyu/cd-cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2023-present, Noah Yu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,367 @@
+# CD CLI - 简易部署工具
+
+一个简易的部署工具，支持版本管理和零停机部署。
+
+## 功能特性
+
+- 🚀 一键部署：本地构建 → 压缩 → 上传 → 解压 → 重启服务
+- 📦 版本管理：支持版本号管理，保留多个历史版本
+- 🔄 零停机部署：使用软链接实现原子性切换
+- ⏪ 快速回滚：一键回滚到任意历史版本
+- 📝 版本列表：查看服务器上所有已部署版本
+- 🔒 安全连接：支持密码和私钥认证
+- 🔄 PM2 集成：自动重启 PM2 应用
+- 📝 配置灵活：支持部署前后执行自定义命令
+- 🎯 文件过滤：支持排除不需要的文件
+
+## 安装
+
+### 全局安装
+
+```bash
+npm install -g @noahyu/cd-cli
+```
+
+安装后可在任何项目中使用 `pcli-cd` 命令。
+
+## 快速开始
+
+### 1. 在项目中初始化配置
+
+```bash
+cd your-project
+pcli-cd init
+```
+
+这会在项目根目录创建 `pcli-cd.config.js` 配置文件。
+
+- **重要** `pcli-cd.config.js` 文件不应该提交到 Git
+
+### 2. 部署项目
+
+```bash
+pcli-cd deploy
+# 或者使用别名
+pcli-cd cd
+
+# 指定版本号部署
+pcli-cd deploy --version v1.0.0
+```
+
+### 3. 查看版本列表
+
+```bash
+pcli-cd list
+# 或者使用别名
+pcli-cd ls
+```
+
+### 4. 回滚到指定版本
+
+```bash
+pcli-cd rollback
+# 或者使用别名
+pcli-cd rb
+
+# 直接指定版本回滚
+pcli-cd rollback --version v1.0.0
+```
+
+## 部署架构
+
+部署后的服务器目录结构：
+
+```
+/var/www/your-app/
+├── .output -> .output-v1.0.1     # 软链接指向当前版本
+├── .output-v1.0.0/               # 历史版本
+├── .output-v1.0.1/               # 当前版本
+│   └── server/
+│       └── index.mjs             # PM2 启动文件
+└── .output-v1.0.2/               # 新版本 (如果有)
+```
+
+PM2 配置始终指向软链接 `.output/server/index.mjs`，这样切换版本时无需修改 PM2 配置。
+
+## 配置文件
+
+配置文件 `pcli-cd.config.js` 示例：
+
+> **重要** `pcli-cd.config.js` 文件不应该提交到 Git
+
+```javascript
+// pcli-cd 部署配置文件
+export default {
+  // 构建命令 (可选)
+  buildCommand: 'npm run build',
+
+  // 构建输出目录
+  buildDir: '.output',
+
+  // 版本号 (可选，不指定会在部署时询问)
+  version: 'v1.0.0',
+
+  // 服务器配置
+  server: {
+    host: '192.168.1.100',
+    port: 22,
+    username: 'root',
+    password: 'your-password', // 密码或私钥二选一
+    // privateKey: '/path/to/private/key',
+    deployPath: '/var/www/your-app',
+  },
+
+  // PM2 配置 (可选)
+  pm2: {
+    appName: 'your-app-name',
+    restart: true,
+  },
+
+  // 排除的文件 (可选) - 作用于构建产物目录
+  // 请根据构建输出的实际内容谨慎配置
+  excludeFiles: [
+    // '**/*.map',        // Source Map 文件
+    // '**/.DS_Store',    // macOS 系统文件
+    // '**/Thumbs.db'     // Windows 缩略图缓存
+  ],
+
+  // 部署前命令 (可选)
+  beforeDeploy: ['npm run test'],
+
+  // 部署后命令 (可选)
+  afterDeploy: ['npm install --production'],
+}
+```
+
+## 配置选项
+
+| 选项                | 类型     | 必填 | 说明                             |
+| ------------------- | -------- | ---- | -------------------------------- |
+| `buildCommand`      | string   | 否   | 构建命令，如 "npm run build"     |
+| `buildDir`          | string   | 是   | 构建输出目录，如 ".output"       |
+| `version`           | string   | 否   | 版本号，不指定会在部署时询问     |
+| `server.host`       | string   | 是   | 服务器地址                       |
+| `server.port`       | number   | 否   | SSH 端口，默认 22                |
+| `server.username`   | string   | 是   | 用户名                           |
+| `server.password`   | string   | 否   | 密码                             |
+| `server.privateKey` | string   | 否   | 私钥路径                         |
+| `server.deployPath` | string   | 是   | 服务器部署路径                   |
+| `pm2.appName`       | string   | 否   | PM2 应用名称                     |
+| `pm2.restart`       | boolean  | 否   | 是否重启 PM2 应用                |
+| `excludeFiles`      | string[] | 否   | 排除的文件模式（相对于构建目录） |
+| `beforeDeploy`      | string[] | 否   | 部署前执行的命令                 |
+| `afterDeploy`       | string[] | 否   | 部署后执行的命令                 |
+
+## 命令详解
+
+### deploy (cd)
+
+部署项目到服务器
+
+```bash
+pcli-cd deploy [options]
+
+Options:
+  -c, --config <config>    配置文件路径 (默认: ./pcli-cd.config.js)
+  -v, --version <version>  指定版本号
+  -h, --help              显示帮助信息
+```
+
+### list (ls)
+
+列出服务器上的所有版本
+
+```bash
+pcli-cd list [options]
+
+Options:
+  -c, --config <config>    配置文件路径 (默认: ./pcli-cd.config.js)
+  -h, --help              显示帮助信息
+```
+
+### rollback (rb)
+
+回滚到指定版本
+
+```bash
+pcli-cd rollback [options]
+
+Options:
+  -c, --config <config>    配置文件路径 (默认: ./pcli-cd.config.js)
+  -v, --version <version>  回滚到的版本号
+  -h, --help              显示帮助信息
+```
+
+### init
+
+初始化配置文件
+
+```bash
+pcli-cd init
+```
+
+## 使用场景
+
+### 1. Nuxt 3 项目部署
+
+```javascript
+// Nuxt.js 项目配置
+export default {
+  buildCommand: 'npm run build',
+  buildDir: '.output',
+  server: {
+    host: 'your-server.com',
+    username: 'root',
+    password: 'your-password',
+    deployPath: '/var/www/nuxt-app',
+  },
+  pm2: {
+    appName: 'nuxt-app',
+    restart: true,
+  },
+  excludeFiles: [
+    // 注意：以下路径相对于 .output 目录
+    // 请根据实际构建产物内容调整
+    'src/**', // 如果源码被复制到输出目录
+    '**/.DS_Store', // macOS 系统文件
+  ],
+}
+```
+
+### 2. Node.js API 项目部署
+
+```javascript
+// Node.js API 项目配置
+export default {
+  buildCommand: 'npm run build',
+  buildDir: 'dist',
+  server: {
+    host: 'your-server.com',
+    username: 'root',
+    privateKey: '~/.ssh/id_rsa',
+    deployPath: '/var/www/api'
+  },
+  pm2: {
+    appName: 'api-server',
+    restart: true
+  },
+  excludeFiles: [
+    // 注意：以下路径相对于 dist 目录
+    // 请根据实际构建产物内容调整
+    'src/**',         // 如果源码被复制到输出目录
+    '**/.DS_Store', // macOS 系统文件
+  ]
+  afterDeploy: [
+    'npm install --production'
+  ]
+}
+```
+
+## excludeFiles 配置说明
+
+⚠️ **重要提醒**：`excludeFiles` 作用于**构建产物目录**（如 `dist/`、`.output/` 等），不是项目根目录。
+
+### 工作原理
+
+1. 首先执行 `buildCommand` 生成构建产物到 `buildDir`
+2. 然后对 `buildDir` 目录进行压缩，此时应用 `excludeFiles` 规则
+3. 将压缩包上传到服务器
+
+### 配置建议
+
+```javascript
+// ❌ 错误理解：认为排除的是项目根目录文件
+export default {
+  excludeFiles: ['src/**', 'node_modules/**']
+}
+
+// ✅ 正确理解：排除的是构建目录内的文件
+export default {
+  excludeFiles: [
+    // 只有当这些文件确实出现在构建目录中，且确认不需要时才排除
+    '**/*.map',        // Source Map 文件（通常不需要）
+    '**/.DS_Store',    // macOS 系统文件
+    '**/Thumbs.db'     // Windows 缩略图缓存
+  ]
+}
+```
+
+### 注意事项
+
+- **运行时依赖**：某些框架（如 Nuxt、Next.js）的构建产物可能包含必需的 `node_modules`
+- **建议**：初次使用时保持 `excludeFiles: []`，观察构建产物内容后再配置
+
+## 版本管理
+
+### 零停机部署流程
+
+1. 构建项目到本地 `.output` 目录
+2. 压缩并上传到服务器的新版本目录 `.output-v1.0.1`
+3. 在新版本目录执行部署后命令（如安装依赖）
+4. 原子性切换软链接 `.output` 指向新版本目录
+5. 重启 PM2 应用
+6. 清理旧版本（保留最近3个版本）
+
+### 版本命名规则
+
+- 自动生成：`v20250820-114530`（基于时间戳）
+- 手动指定：`v1.0.0`、`v2.1.3` 等
+- 版本号可以是任意字符串，建议使用语义化版本
+
+### 回滚机制
+
+回滚只需要切换软链接指向，无需重新上传文件，速度极快：
+
+```bash
+# 查看所有版本
+pcli-cd list
+
+# 回滚到指定版本
+pcli-cd rollback --version v1.0.0
+
+# 交互式选择版本回滚
+pcli-cd rollback
+```
+
+## 配置文件
+
+每个项目只需要一个 `pcli-cd.config.js` 配置文件，工具会自动读取当前目录下的配置。
+
+⚠️ **重要提醒** `pcli-cd.config.js` 文件不应该提交到 Git
+
+## 注意事项
+
+- **全局安装后首次使用**：安装后可在任意目录使用 `pcli-cd` 命令
+- **配置文件位置**：每个项目根目录需要有 `pcli-cd.config.js` 配置文件
+- 确保服务器已安装 `unzip` 命令
+- 如果使用 PM2，确保服务器已安装 PM2
+- 私钥文件需要有正确的权限 (600)
+- 建议在生产环境使用私钥认证而非密码
+- PM2 配置文件中的启动路径应该指向软链接而非具体版本目录
+- 部署过程中会自动清理旧版本，默认保留最近3个版本
+
+## 故障排除
+
+### 找不到 pcli-cd 命令
+
+```bash
+# 检查是否正确安装
+npm list -g @noahyu/cd-cli
+
+# 重新安装
+npm install -g @noahyu/cd-cli
+```
+
+### 配置文件错误
+
+```bash
+# 检查配置文件是否存在
+ls pcli-cd.config.js
+
+# 重新初始化配置
+pcli-cd init
+```
+
+## License
+
+MIT

package/dist/bin/cli.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+import { deployCommand, initConfig, listVersions, rollbackVersion } from '../src/index.js';
+
+program.version('1.0.0').description('Simple CI/CD deployment tool');
+program
+    .command('deploy')
+    .alias('cd')
+    .description('Build and deploy project to server')
+    .option('-c, --config <config>', 'Configuration file path', './pcli-cd.config.js')
+    .option('-v, --version <version>', 'Specify version number')
+    .action(deployCommand);
+program.command('init').description('Initialize CD configuration file').action(initConfig);
+program
+    .command('list')
+    .alias('ls')
+    .description('List deployed versions on server')
+    .option('-c, --config <config>', 'Configuration file path', './pcli-cd.config.js')
+    .action(listVersions);
+program
+    .command('rollback')
+    .alias('rb')
+    .description('Rollback to a previous version')
+    .option('-c, --config <config>', 'Configuration file path', './pcli-cd.config.js')
+    .option('-v, --version <version>', 'Version to rollback to')
+    .action(rollbackVersion);
+program.parse(process.argv);

package/dist/src/index.js

@@ -0,0 +1,454 @@
+#!/usr/bin/env node
+import { existsSync } from 'fs';
+import { resolve, join } from 'path';
+import { execa } from 'execa';
+import fse from 'fs-extra';
+import archiver from 'archiver';
+import { NodeSSH } from 'node-ssh';
+import ora from 'ora';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+
+async function deployCommand(options) {
+    const configPath = resolve(process.cwd(), options.config);
+    if (!existsSync(configPath)) {
+        console.log(chalk.red(`❌ 配置文件不存在: ${configPath}`));
+        console.log(chalk.yellow('💡 请创建 pcli-cd.config.js 配置文件'));
+        process.exit(1);
+    }
+    let config;
+    try {
+        const configModule = await import(configPath);
+        config = configModule.default || configModule;
+    }
+    catch (error) {
+        console.log(chalk.red(`❌ 配置文件读取失败: ${error}`));
+        process.exit(1);
+    }
+    if (!config.version && !options.version) {
+        const answers = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'version',
+                message: '请输入版本号 (例如: v1.0.0):',
+                default: `v${new Date().toISOString().slice(0, 19).replace(/[-:]/g, '').replace('T', '-')}`,
+                validate: (input) => input.trim() !== '' || '版本号不能为空',
+            },
+        ]);
+        config.version = answers.version;
+    }
+    else {
+        config.version = options.version || config.version;
+    }
+    await deploy(config);
+}
+async function deploy(config) {
+    const spinner = ora();
+    const tempDir = join(process.cwd(), '.deploy-temp');
+    const zipPath = join(tempDir, 'build.zip');
+    const version = config.version || `v${Date.now()}`;
+    const buildDirName = config.buildDir.split('/').pop() || 'build';
+    try {
+        await fse.remove(tempDir);
+        await fse.ensureDir(tempDir);
+        if (config.beforeDeploy) {
+            spinner.start('执行构建前命令...');
+            for (const cmd of config.beforeDeploy) {
+                await execa('bash', ['-c', cmd], { stdio: 'inherit' });
+            }
+            spinner.succeed('构建前命令执行完成');
+        }
+        if (config.buildCommand) {
+            spinner.start('正在构建项目...');
+            await execa('bash', ['-c', config.buildCommand], { stdio: 'inherit' });
+            spinner.succeed('项目构建完成');
+        }
+        const buildPath = resolve(process.cwd(), config.buildDir);
+        if (!existsSync(buildPath)) {
+            throw new Error(`构建目录不存在: ${buildPath}`);
+        }
+        spinner.start('正在压缩文件...');
+        await createZip(buildPath, zipPath, config.excludeFiles);
+        spinner.succeed('文件压缩完成');
+        spinner.start('正在连接服务器...');
+        const ssh = new NodeSSH();
+        await ssh.connect({
+            host: config.server.host,
+            port: config.server.port || 22,
+            username: config.server.username,
+            password: config.server.password,
+            privateKey: config.server.privateKey,
+        });
+        spinner.succeed('服务器连接成功');
+        const versionDirName = `${buildDirName}-${version}`;
+        const versionPath = join(config.server.deployPath, versionDirName);
+        const currentLinkPath = join(config.server.deployPath, buildDirName);
+        spinner.start('正在准备部署目录...');
+        await ssh.execCommand(`mkdir -p ${config.server.deployPath}`);
+        await ssh.execCommand(`mkdir -p ${versionPath}`);
+        spinner.succeed('部署目录准备完成');
+        spinner.start(`正在上传文件到版本目录 ${versionDirName}...`);
+        const remoteZipPath = join(versionPath, 'build.zip');
+        await ssh.putFile(zipPath, remoteZipPath);
+        spinner.succeed('文件上传完成');
+        spinner.start('正在解压文件...');
+        await ssh.execCommand(`cd ${versionPath} && unzip -o build.zip && rm build.zip`);
+        await ssh.execCommand(`
+      cd ${versionPath} && 
+      if [ -d "${buildDirName}" ]; then 
+        mv ${buildDirName}/* . 2>/dev/null || true
+        mv ${buildDirName}/.[!.]* . 2>/dev/null || true
+        rmdir ${buildDirName} 2>/dev/null || true
+      fi
+    `);
+        spinner.succeed('文件解压完成');
+        if (config.afterDeploy) {
+            spinner.start('执行部署后命令...');
+            for (const cmd of config.afterDeploy) {
+                await ssh.execCommand(cmd, { cwd: versionPath });
+            }
+            spinner.succeed('部署后命令执行完成');
+        }
+        spinner.start(`正在切换到新版本 ${version}...`);
+        const tempLinkPath = `${currentLinkPath}.tmp.${Date.now()}`;
+        await ssh.execCommand(`ln -sfn ${versionPath} ${tempLinkPath}`);
+        await ssh.execCommand(`mv ${tempLinkPath} ${currentLinkPath}`);
+        spinner.succeed(`版本切换完成: ${buildDirName} -> ${versionDirName}`);
+        if (config.pm2) {
+            spinner.start('正在重启 PM2 应用...');
+            const { appName, restart = true } = config.pm2;
+            if (restart) {
+                await new Promise((resolve) => setTimeout(resolve, 1000));
+                const result = await ssh.execCommand(`pm2 restart ${appName}`);
+                if (result.code === 0) {
+                    spinner.succeed('PM2 应用重启成功');
+                }
+                else {
+                    const startResult = await ssh.execCommand(`pm2 start ${appName}`);
+                    if (startResult.code === 0) {
+                        spinner.succeed('PM2 应用启动成功');
+                    }
+                    else {
+                        spinner.warn('PM2 操作失败，请手动检查');
+                        console.log(chalk.yellow(`重启命令: pm2 restart ${appName}`));
+                        console.log(chalk.yellow(`启动命令: pm2 start ${appName}`));
+                    }
+                }
+            }
+        }
+        spinner.start('正在清理旧版本...');
+        await cleanOldVersions(ssh, config.server.deployPath, buildDirName, 3);
+        spinner.succeed('旧版本清理完成');
+        ssh.dispose();
+        await fse.remove(tempDir);
+        console.log(chalk.green('\n🎉 部署完成!'));
+        console.log(chalk.blue(`📦 版本: ${version}`));
+        console.log(chalk.blue(`🔗 当前链接: ${currentLinkPath} -> ${versionPath}`));
+        if (config.pm2) {
+            console.log(chalk.blue(`⚡ PM2 应用: ${config.pm2.appName}`));
+            console.log(chalk.gray(`   启动文件: ${currentLinkPath}/server/index.mjs`));
+        }
+    }
+    catch (error) {
+        spinner.fail('部署失败');
+        console.error(chalk.red(`❌ 错误: ${error}`));
+        await fse.remove(tempDir);
+        process.exit(1);
+    }
+}
+async function createZip(sourcePath, outputPath, excludeFiles = []) {
+    return new Promise((resolve, reject) => {
+        const output = fse.createWriteStream(outputPath);
+        const archive = archiver('zip', { zlib: { level: 9 } });
+        output.on('close', () => resolve());
+        archive.on('error', (err) => reject(err));
+        archive.pipe(output);
+        archive.glob('**/*', {
+            cwd: sourcePath,
+            ignore: excludeFiles,
+        });
+        archive.finalize();
+    });
+}
+async function cleanOldVersions(ssh, deployPath, buildDirName, keepCount) {
+    try {
+        const result = await ssh.execCommand(`find ${deployPath} -maxdepth 1 -type d -name "${buildDirName}-*" | sort -V`);
+        if (result.code !== 0) {
+            return;
+        }
+        const versionDirs = result.stdout
+            .split('\n')
+            .filter((dir) => dir.trim())
+            .map((dir) => dir.trim());
+        if (versionDirs.length > keepCount) {
+            const dirsToDelete = versionDirs.slice(0, -keepCount);
+            for (const dir of dirsToDelete) {
+                await ssh.execCommand(`rm -rf "${dir}"`);
+            }
+        }
+    }
+    catch (error) {
+        console.warn(chalk.yellow(`⚠️ 清理旧版本时出现警告: ${error}`));
+    }
+}
+async function initConfig() {
+    console.log(chalk.blue('🚀 初始化配置文件'));
+    const answers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'buildCommand',
+            message: '构建命令 (如: npm run build):',
+            default: 'npm run build',
+        },
+        {
+            type: 'input',
+            name: 'buildDir',
+            message: '构建输出目录:',
+            default: 'dist',
+        },
+        {
+            type: 'input',
+            name: 'host',
+            message: '服务器地址:',
+            validate: (input) => input.trim() !== '' || '请输入服务器地址',
+        },
+        {
+            type: 'input',
+            name: 'port',
+            message: '服务器端口:',
+            default: '22',
+        },
+        {
+            type: 'input',
+            name: 'username',
+            message: '用户名:',
+            validate: (input) => input.trim() !== '' || '请输入用户名',
+        },
+        {
+            type: 'password',
+            name: 'password',
+            message: '密码 (留空使用私钥):',
+            mask: '*',
+        },
+        {
+            type: 'input',
+            name: 'deployPath',
+            message: '服务器部署路径:',
+            validate: (input) => input.trim() !== '' || '请输入部署路径',
+        },
+        {
+            type: 'input',
+            name: 'pm2AppName',
+            message: 'PM2 应用名称 (可选):',
+        },
+    ]);
+    const config = {
+        buildCommand: answers.buildCommand,
+        buildDir: answers.buildDir,
+        server: {
+            host: answers.host,
+            port: parseInt(answers.port),
+            username: answers.username,
+            password: answers.password || undefined,
+            deployPath: answers.deployPath,
+        },
+        excludeFiles: [],
+    };
+    if (answers.pm2AppName) {
+        config.pm2 = {
+            appName: answers.pm2AppName,
+            restart: true,
+        };
+    }
+    const configContent = `// pcli-cd 部署配置文件
+export default ${JSON.stringify(config, null, 2)}`;
+    await fse.writeFile('pcli-cd.config.js', configContent);
+    console.log(chalk.green('✅ 配置文件已创建: pcli-cd.config.js'));
+}
+async function listVersions(options) {
+    const configPath = resolve(process.cwd(), options.config);
+    if (!existsSync(configPath)) {
+        console.log(chalk.red(`❌ 配置文件不存在: ${configPath}`));
+        process.exit(1);
+    }
+    let config;
+    try {
+        const configModule = await import(configPath);
+        config = configModule.default || configModule;
+    }
+    catch (error) {
+        console.log(chalk.red(`❌ 配置文件读取失败: ${error}`));
+        process.exit(1);
+    }
+    const spinner = ora('正在获取版本列表...');
+    spinner.start();
+    try {
+        const ssh = new NodeSSH();
+        await ssh.connect({
+            host: config.server.host,
+            port: config.server.port || 22,
+            username: config.server.username,
+            password: config.server.password,
+            privateKey: config.server.privateKey,
+        });
+        const buildDirName = config.buildDir.split('/').pop() || 'build';
+        const currentLinkPath = join(config.server.deployPath, buildDirName);
+        const currentResult = await ssh.execCommand(`readlink ${currentLinkPath}`);
+        const currentVersion = currentResult.code === 0
+            ? currentResult.stdout.trim().split('/').pop()?.replace(`${buildDirName}-`, '') || 'unknown'
+            : 'unknown';
+        const result = await ssh.execCommand(`find ${config.server.deployPath} -maxdepth 1 -type d -name "${buildDirName}-*" | sort -V`);
+        if (result.code !== 0) {
+            throw new Error('无法获取版本列表');
+        }
+        const versions = result.stdout
+            .split('\n')
+            .filter((dir) => dir.trim())
+            .map((dir) => {
+            const version = dir.trim().split('/').pop()?.replace(`${buildDirName}-`, '') || '';
+            return {
+                version,
+                path: dir.trim(),
+                isCurrent: version === currentVersion,
+            };
+        })
+            .reverse();
+        spinner.succeed('版本列表获取成功');
+        if (versions.length === 0) {
+            console.log(chalk.yellow('📦 服务器上没有找到任何版本'));
+            return;
+        }
+        console.log(chalk.blue('\n📦 已部署的版本:'));
+        console.log('─'.repeat(50));
+        versions.forEach((version) => {
+            const prefix = version.isCurrent ? chalk.green('●') : chalk.gray('○');
+            const label = version.isCurrent ? chalk.green(' (当前)') : '';
+            const versionText = version.isCurrent
+                ? chalk.green(version.version)
+                : chalk.white(version.version);
+            console.log(`${prefix} ${versionText}${label}`);
+        });
+        console.log('─'.repeat(50));
+        console.log(chalk.gray(`总计: ${versions.length} 个版本`));
+        ssh.dispose();
+    }
+    catch (error) {
+        spinner.fail('获取版本列表失败');
+        console.error(chalk.red(`❌ 错误: ${error}`));
+        process.exit(1);
+    }
+}
+async function rollbackVersion(options) {
+    const configPath = resolve(process.cwd(), options.config);
+    if (!existsSync(configPath)) {
+        console.log(chalk.red(`❌ 配置文件不存在: ${configPath}`));
+        process.exit(1);
+    }
+    let config;
+    try {
+        const configModule = await import(configPath);
+        config = configModule.default || configModule;
+    }
+    catch (error) {
+        console.log(chalk.red(`❌ 配置文件读取失败: ${error}`));
+        process.exit(1);
+    }
+    const buildDirName = config.buildDir.split('/').pop() || 'build';
+    let targetVersion = options.version;
+    if (!targetVersion) {
+        const ssh = new NodeSSH();
+        await ssh.connect({
+            host: config.server.host,
+            port: config.server.port || 22,
+            username: config.server.username,
+            password: config.server.password,
+            privateKey: config.server.privateKey,
+        });
+        const result = await ssh.execCommand(`find ${config.server.deployPath} -maxdepth 1 -type d -name "${buildDirName}-*" | sort -V`);
+        if (result.code !== 0) {
+            console.log(chalk.red('❌ 无法获取版本列表'));
+            process.exit(1);
+        }
+        const versions = result.stdout
+            .split('\n')
+            .filter((dir) => dir.trim())
+            .map((dir) => dir.trim().split('/').pop()?.replace(`${buildDirName}-`, '') || '')
+            .filter(Boolean)
+            .reverse();
+        if (versions.length === 0) {
+            console.log(chalk.yellow('📦 服务器上没有找到任何可回滚的版本'));
+            ssh.dispose();
+            return;
+        }
+        const answers = await inquirer.prompt([
+            {
+                type: 'list',
+                name: 'version',
+                message: '选择要回滚到的版本:',
+                choices: versions,
+            },
+        ]);
+        targetVersion = answers.version;
+        ssh.dispose();
+    }
+    if (!targetVersion) {
+        throw new Error('未指定回滚版本');
+    }
+    await performRollback(config, targetVersion, buildDirName);
+}
+async function performRollback(config, targetVersion, buildDirName) {
+    const spinner = ora();
+    try {
+        spinner.start('正在连接服务器...');
+        const ssh = new NodeSSH();
+        await ssh.connect({
+            host: config.server.host,
+            port: config.server.port || 22,
+            username: config.server.username,
+            password: config.server.password,
+            privateKey: config.server.privateKey,
+        });
+        spinner.succeed('服务器连接成功');
+        const versionDirName = `${buildDirName}-${targetVersion}`;
+        const versionPath = join(config.server.deployPath, versionDirName);
+        const currentLinkPath = join(config.server.deployPath, buildDirName);
+        spinner.start('正在检查目标版本...');
+        const checkResult = await ssh.execCommand(`test -d ${versionPath}`);
+        if (checkResult.code !== 0) {
+            throw new Error(`版本 ${targetVersion} 不存在`);
+        }
+        spinner.succeed('目标版本检查通过');
+        spinner.start(`正在回滚到版本 ${targetVersion}...`);
+        const tempLinkPath = `${currentLinkPath}.tmp.${Date.now()}`;
+        await ssh.execCommand(`ln -sfn ${versionPath} ${tempLinkPath}`);
+        await ssh.execCommand(`mv ${tempLinkPath} ${currentLinkPath}`);
+        spinner.succeed(`回滚完成: ${buildDirName} -> ${versionDirName}`);
+        if (config.pm2) {
+            spinner.start('正在重启 PM2 应用...');
+            const { appName } = config.pm2;
+            await new Promise((resolve) => setTimeout(resolve, 1000));
+            const result = await ssh.execCommand(`pm2 restart ${appName}`);
+            if (result.code === 0) {
+                spinner.succeed('PM2 应用重启成功');
+            }
+            else {
+                spinner.warn('PM2 重启失败，请手动检查');
+                console.log(chalk.yellow(`手动重启命令: pm2 restart ${appName}`));
+            }
+        }
+        ssh.dispose();
+        console.log(chalk.green('\n🎉 回滚完成!'));
+        console.log(chalk.blue(`📦 当前版本: ${targetVersion}`));
+        console.log(chalk.blue(`🔗 当前链接: ${currentLinkPath} -> ${versionPath}`));
+        if (config.pm2) {
+            console.log(chalk.blue(`⚡ PM2 应用: ${config.pm2.appName}`));
+        }
+    }
+    catch (error) {
+        spinner.fail('回滚失败');
+        console.error(chalk.red(`❌ 错误: ${error}`));
+        process.exit(1);
+    }
+}
+
+export { deployCommand, initConfig, listVersions, rollbackVersion };

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@noahyu/cd-cli",
+  "version": "1.0.0",
+  "description": "Global CLI tool for simple project deployment with version management",
+  "type": "module",
+  "main": "./dist/bin/cli.js",
+  "files": [
+    "/dist"
+  ],
+  "bin": {
+    "pcli-cd": "./dist/bin/cli.js"
+  },
+  "keywords": [
+    "deployment",
+    "ci-cd",
+    "cli",
+    "global",
+    "version-management",
+    "zero-downtime"
+  ],
+  "author": "Noah Yu",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Noah-Ywh/project-cli.git"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "boxen": "^8.0.1",
+    "chalk": "^5.6.0",
+    "commander": "^14.0.0",
+    "ejs": "^3.1.10",
+    "execa": "^9.6.0",
+    "fs-extra": "^11.3.1",
+    "globby": "^14.1.0",
+    "inquirer": "^12.9.3",
+    "ora": "^8.2.0",
+    "parse-json": "^8.3.0",
+    "progress": "^2.0.3",
+    "semver": "^7.7.2",
+    "tslib": "^2.8.1",
+    "validate-npm-package-name": "^6.0.2",
+    "node-ssh": "^13.2.0",
+    "archiver": "^7.0.1"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^28.0.6",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^16.0.1",
+    "@rollup/plugin-typescript": "^12.1.4",
+    "@types/ejs": "^3.1.5",
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.9",
+    "@types/node": "^24.3.0",
+    "@types/parse-json": "^7.0.0",
+    "@types/progress": "^2.0.7",
+    "@types/semver": "^7.7.0",
+    "@types/validate-npm-package-name": "^4.0.2",
+    "@types/archiver": "^6.0.2",
+    "rollup": "^4.46.3",
+    "rollup-plugin-copy": "^3.5.0"
+  },
+  "scripts": {
+    "build": "rollup -c",
+    "build:w": "rollup -c -w",
+    "changelog": "conventional-changelog -n '../../changelog.config.js' -i CHANGELOG.md -s -r 0 -k ./package.json --commit-path ./",
+    "prettier": "prettier --config .prettierrc --write ./**/*.md",
+    "vitest": "vitest",
+    "vitest:c": "vitest run --coverage",
+    "vitest:u": "vitest --coverage --ui"
+  }
+}