@zhengyizhao/deploy-helper 0.1.0

package/src/commands/rollback.js

@@ -0,0 +1,188 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import inquirer from 'inquirer';
+import { connectSSH, runRemoteSilent } from '../utils/ssh.js';
+import { loadConfig, saveConfig } from '../utils/config.js';
+
+const SNAPSHOTS_DIR = '/var/deploy-helper/snapshots';
+
+/**
+ * 部署时调用：把当前版本打快照存起来
+ * 保留最近 5 个版本，多余的自动删除
+ */
+export async function createSnapshot(ssh, config) {
+  const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+  const snapshotName = `${config.appName}_${timestamp}`;
+  const snapshotPath = `${SNAPSHOTS_DIR}/${snapshotName}`;
+
+  await runRemoteSilent(ssh, `mkdir -p ${SNAPSHOTS_DIR}`);
+
+  // 如果当前部署目录存在，就复制一份作为快照
+  const exists = await runRemoteSilent(ssh, `test -d ${config.remotePath} && echo yes || echo no`);
+  if (exists.stdout.trim() === 'yes') {
+    await runRemoteSilent(ssh, `cp -r ${config.remotePath} ${snapshotPath}`);
+
+    // 记录快照元信息
+    const meta = JSON.stringify({
+      name: snapshotName,
+      timestamp,
+      appName: config.appName,
+      remotePath: config.remotePath,
+    });
+    await runRemoteSilent(ssh, `echo '${meta}' > ${snapshotPath}/.snapshot-meta.json`);
+
+    // 只保留最近 5 个快照
+    await runRemoteSilent(
+      ssh,
+      `ls -t ${SNAPSHOTS_DIR} | grep "^${config.appName}_" | tail -n +6 | xargs -I{} rm -rf ${SNAPSHOTS_DIR}/{}`
+    );
+
+    return snapshotName;
+  }
+  return null;
+}
+
+/**
+ * 列出服务器上的所有快照
+ */
+async function listSnapshots(ssh, config) {
+  const result = await runRemoteSilent(
+    ssh,
+    `ls -t ${SNAPSHOTS_DIR} 2>/dev/null | grep "^${config.appName}_" || echo ""`
+  );
+  const names = result.stdout.trim().split('\n').filter(Boolean);
+
+  const snapshots = [];
+  for (const name of names) {
+    const metaResult = await runRemoteSilent(
+      ssh,
+      `cat ${SNAPSHOTS_DIR}/${name}/.snapshot-meta.json 2>/dev/null || echo "{}"`
+    );
+    try {
+      const meta = JSON.parse(metaResult.stdout);
+      snapshots.push({ name, ...meta });
+    } catch {
+      snapshots.push({ name, timestamp: name.replace(`${config.appName}_`, '') });
+    }
+  }
+  return snapshots;
+}
+
+/**
+ * rollback 命令主体
+ */
+export async function deployRollback() {
+  const config = loadConfig();
+  if (!config) {
+    console.log(chalk.red('\n没有找到部署配置，请先运行：') + chalk.cyan(' deploy-helper init\n'));
+    return;
+  }
+
+  let ssh;
+  const spinner = ora('连接服务器...').start();
+  try {
+    ssh = await connectSSH(config);
+    spinner.succeed('连接成功');
+  } catch (err) {
+    spinner.fail('连接失败：' + err.message);
+    return;
+  }
+
+  // 获取快照列表
+  const listSpinner = ora('获取历史版本列表...').start();
+  const snapshots = await listSnapshots(ssh, config);
+  listSpinner.stop();
+
+  if (snapshots.length === 0) {
+    console.log(chalk.yellow('\n没有找到任何历史快照。'));
+    console.log(chalk.gray('提示：从下次部署开始会自动创建快照。\n'));
+    ssh.dispose();
+    return;
+  }
+
+  // 展示快照列表供用户选择
+  console.log(chalk.bold(`\n找到 ${snapshots.length} 个历史版本：\n`));
+
+  const choices = snapshots.map((s, i) => {
+    const date = s.timestamp
+      ? new Date(s.timestamp.replace(/-(\d{2})-(\d{2})-(\d{2})-(\d{2})$/, 'T$1:$2:$3')).toLocaleString('zh-CN')
+      : s.timestamp;
+    const label = i === 0 ? chalk.gray(' ← 上一个版本') : '';
+    return {
+      name: `${chalk.cyan(s.name)}  ${chalk.gray(date)}${label}`,
+      value: s.name,
+      short: s.name,
+    };
+  });
+
+  const { selectedSnapshot } = await inquirer.prompt([{
+    type: 'list',
+    name: 'selectedSnapshot',
+    message: '选择要回滚到的版本：',
+    choices,
+  }]);
+
+  const { confirm } = await inquirer.prompt([{
+    type: 'confirm',
+    name: 'confirm',
+    message: chalk.yellow(`确认回滚？当前版本将被替换，此操作不可撤销。`),
+    default: false,
+  }]);
+
+  if (!confirm) {
+    console.log(chalk.gray('\n已取消回滚。\n'));
+    ssh.dispose();
+    return;
+  }
+
+  // 执行回滚
+  console.log('');
+  try {
+    // 把当前版本也存一个"回滚前"的快照
+    const preRollbackSpinner = ora('备份当前版本...').start();
+    await createSnapshot(ssh, config);
+    preRollbackSpinner.succeed('当前版本已备份');
+
+    // 停止服务
+    const stopSpinner = ora('停止当前服务...').start();
+    if (config.projectType === 'nodejs') {
+      await runRemoteSilent(ssh, `pm2 stop ${config.appName} 2>/dev/null || true`);
+    } else if (config.projectType === 'python') {
+      await runRemoteSilent(ssh, `supervisorctl stop ${config.appName} 2>/dev/null || true`);
+    } else if (config.projectType === 'docker') {
+      await runRemoteSilent(ssh, `cd ${config.remotePath} && docker compose down 2>/dev/null || true`);
+    }
+    stopSpinner.succeed('服务已停止');
+
+    // 替换代码目录
+    const restoreSpinner = ora(`还原版本 ${selectedSnapshot}...`).start();
+    await runRemoteSilent(ssh, `rm -rf ${config.remotePath}`);
+    await runRemoteSilent(ssh, `cp -r ${SNAPSHOTS_DIR}/${selectedSnapshot} ${config.remotePath}`);
+    await runRemoteSilent(ssh, `rm -f ${config.remotePath}/.snapshot-meta.json`);
+    restoreSpinner.succeed('版本已还原');
+
+    // 重启服务
+    const startSpinner = ora('重启服务...').start();
+    if (config.projectType === 'nodejs') {
+      await runRemoteSilent(ssh, `cd ${config.remotePath} && pm2 restart ${config.appName} || pm2 start ${config.startCmd} --name ${config.appName}`);
+    } else if (config.projectType === 'python') {
+      await runRemoteSilent(ssh, `supervisorctl start ${config.appName}`);
+    } else if (config.projectType === 'docker') {
+      await runRemoteSilent(ssh, `cd ${config.remotePath} && docker compose up -d`);
+    } else if (config.projectType === 'static') {
+      await runRemoteSilent(ssh, `chown -R www-data:www-data ${config.remotePath}`);
+    }
+    startSpinner.succeed('服务已重启');
+
+    ssh.dispose();
+    console.log(chalk.green.bold('\n✅ 回滚成功！'));
+    console.log(chalk.gray(`  已恢复到版本：${selectedSnapshot}\n`));
+
+  } catch (err) {
+    console.log(chalk.red('\n回滚失败：' + err.message));
+    ssh.dispose();
+  }
+}
+
+// 导出给 update.js 调用
+export { connectSSH } from '../utils/ssh.js';

package/src/commands/status.js

@@ -0,0 +1,105 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import inquirer from 'inquirer';
+import { connectSSH, runRemoteSilent } from '../utils/ssh.js';
+import { loadConfig } from '../utils/config.js';
+
+export async function deployStatus() {
+  const config = loadConfig();
+
+  if (!config) {
+    console.log(chalk.red('\n没有找到部署配置，请先运行：') + chalk.cyan(' deploy-helper init\n'));
+    return;
+  }
+
+  let ssh;
+  const spinner = ora('连接服务器获取状态...').start();
+  try {
+    ssh = await connectSSH(config);
+    spinner.succeed('已连接');
+  } catch (err) {
+    spinner.fail('连接失败：' + err.message);
+    return;
+  }
+
+  console.log(chalk.bold('\n📊 服务器状态报告\n'));
+
+  // 系统基本信息
+  const [uptime, memInfo, diskInfo] = await Promise.all([
+    runRemoteSilent(ssh, "uptime -p"),
+    runRemoteSilent(ssh, "free -m | awk 'NR==2{printf \"%s MB / %s MB\", $3, $2}'"),
+    runRemoteSilent(ssh, "df -h / | awk 'NR==2{printf \"%s / %s (%s)\", $3, $2, $5}'"),
+  ]);
+
+  console.log(chalk.gray('  系统运行时间：') + uptime.stdout);
+  console.log(chalk.gray('  内存占用：    ') + memInfo.stdout);
+  console.log(chalk.gray('  磁盘占用：    ') + diskInfo.stdout);
+
+  // 应用状态
+  console.log(chalk.bold('\n  应用状态：'));
+
+  if (config.projectType === 'nodejs') {
+    const pm2Status = await runRemoteSilent(ssh, `pm2 jlist`);
+    try {
+      const list = JSON.parse(pm2Status.stdout);
+      const app = list.find(p => p.name === config.appName);
+      if (app) {
+        const statusColor = app.pm2_env.status === 'online' ? chalk.green : chalk.red;
+        console.log(`  ${statusColor('●')} ${config.appName}`);
+        console.log(chalk.gray(`    状态：${statusColor(app.pm2_env.status)}`));
+        console.log(chalk.gray(`    PID：${app.pid}`));
+        console.log(chalk.gray(`    重启次数：${app.pm2_env.restart_time}`));
+        console.log(chalk.gray(`    运行时间：${formatUptime(app.pm2_env.pm_uptime)}`));
+        console.log(chalk.gray(`    CPU：${app.monit?.cpu ?? 0}%  内存：${Math.round((app.monit?.memory ?? 0) / 1024 / 1024)}MB`));
+      } else {
+        console.log(chalk.red(`  ✗ 未找到 ${config.appName}，服务可能没有运行`));
+      }
+    } catch {
+      console.log(chalk.yellow('  无法解析 PM2 状态'));
+    }
+
+    // 最近日志
+    console.log(chalk.bold('\n  最近日志（最后 20 行）：'));
+    const logs = await runRemoteSilent(ssh, `pm2 logs ${config.appName} --lines 20 --nostream 2>&1 | tail -20`);
+    if (logs.stdout) {
+      logs.stdout.split('\n').forEach(line => {
+        if (line.includes('error') || line.includes('Error')) {
+          console.log(chalk.red('    ' + line));
+        } else {
+          console.log(chalk.gray('    ' + line));
+        }
+      });
+    }
+
+  } else if (config.projectType === 'python') {
+    const supStatus = await runRemoteSilent(ssh, `supervisorctl status ${config.appName}`);
+    console.log(chalk.gray('    ') + supStatus.stdout);
+
+  } else if (config.projectType === 'docker') {
+    const dockerStatus = await runRemoteSilent(ssh, `cd ${config.remotePath} && docker compose ps`);
+    console.log(chalk.gray(dockerStatus.stdout));
+  }
+
+  // Nginx 状态
+  console.log(chalk.bold('\n  Nginx 状态：'));
+  const nginxStatus = await runRemoteSilent(ssh, `systemctl is-active nginx`);
+  const isActive = nginxStatus.stdout.trim() === 'active';
+  console.log(`  ${isActive ? chalk.green('● 运行中') : chalk.red('✗ 未运行')}`);
+
+  // 访问地址
+  const accessUrl = config.useHttps && config.domain
+    ? `https://${config.domain}`
+    : config.domain ? `http://${config.domain}` : `http://${config.host}`;
+  console.log(chalk.bold('\n  访问地址：') + chalk.cyan.underline(accessUrl));
+
+  console.log(chalk.gray(`\n  上次部署：${new Date(config.deployedAt).toLocaleString('zh-CN')}\n`));
+
+  ssh.dispose();
+}
+
+function formatUptime(timestamp) {
+  const ms = Date.now() - timestamp;
+  const h = Math.floor(ms / 3600000);
+  const m = Math.floor((ms % 3600000) / 60000);
+  return `${h}小时 ${m}分钟`;
+}

package/src/commands/update.js

@@ -0,0 +1,284 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import inquirer from 'inquirer';
+import { connectSSH, runRemoteSilent, uploadDirectory } from '../utils/ssh.js';
+import { loadConfig, saveConfig } from '../utils/config.js';
+import { createSnapshot } from './rollback.js';
+import { doBackup } from './backup.js';
+
+const info = (msg) => console.log(chalk.gray('  ℹ ') + msg);
+
+/**
+ * 对单台服务器执行部署流程
+ */
+async function deployToServer(serverConfig) {
+  const label = serverConfig.label ? chalk.cyan(`[${serverConfig.label}] `) : '';
+
+  let ssh;
+  const connectSpinner = ora(`${label}连接服务器 ${serverConfig.host}...`).start();
+  try {
+    ssh = await connectSSH(serverConfig);
+    connectSpinner.succeed(`${label}连接成功`);
+  } catch (err) {
+    connectSpinner.fail(`${label}连接失败：${err.message}`);
+    return false;
+  }
+
+  try {
+    // 1. 创建快照（部署前备份当前版本）
+    const snapSpinner = ora(`${label}创建版本快照...`).start();
+    const snapName = await createSnapshot(ssh, serverConfig);
+    if (snapName) {
+      snapSpinner.succeed(`${label}快照已创建：${chalk.gray(snapName)}`);
+    } else {
+      snapSpinner.info(`${label}跳过快照（首次部署）`);
+    }
+
+    // 2. 上传代码
+    const uploadSpinner = ora(`${label}上传代码...`).start();
+    await uploadDirectory(ssh, process.cwd(), serverConfig.remotePath);
+    uploadSpinner.succeed(`${label}代码上传完成`);
+
+    // 3. 安装依赖 & 重启
+    if (serverConfig.projectType === 'nodejs') {
+      const sp = ora(`${label}安装依赖 & 重启...`).start();
+      await runRemoteSilent(ssh, `cd ${serverConfig.remotePath} && npm install --production --silent`);
+      await runRemoteSilent(ssh, `pm2 restart ${serverConfig.appName} || pm2 start ${serverConfig.startCmd} --name ${serverConfig.appName}`);
+      sp.succeed(`${label}Node.js 服务已重启`);
+
+    } else if (serverConfig.projectType === 'python') {
+      const sp = ora(`${label}更新依赖 & 重启...`).start();
+      await runRemoteSilent(ssh, `cd ${serverConfig.remotePath} && pip3 install -r requirements.txt -q`);
+      await runRemoteSilent(ssh, `supervisorctl restart ${serverConfig.appName}`);
+      sp.succeed(`${label}Python 服务已重启`);
+
+    } else if (serverConfig.projectType === 'docker') {
+      const sp = ora(`${label}重新构建容器...`).start();
+      await runRemoteSilent(ssh, `cd ${serverConfig.remotePath} && docker compose up -d --build`);
+      sp.succeed(`${label}容器已更新`);
+
+    } else if (serverConfig.projectType === 'static') {
+      const sp = ora(`${label}刷新文件权限...`).start();
+      await runRemoteSilent(ssh, `chown -R www-data:www-data ${serverConfig.remotePath}`);
+      sp.succeed(`${label}静态文件已更新`);
+    }
+
+    ssh.dispose();
+    return true;
+
+  } catch (err) {
+    console.log(chalk.red(`\n${label}部署失败：${err.message}`));
+    console.log(chalk.gray(`  运行 deploy-helper rollback 可恢复上一个版本`));
+    ssh.dispose();
+    return false;
+  }
+}
+
+export async function deployUpdate() {
+  const config = loadConfig();
+  if (!config) {
+    console.log(chalk.red('\n没有找到部署配置，请先运行：') + chalk.cyan(' deploy-helper init\n'));
+    return;
+  }
+
+  // 兼容单台和多台服务器配置
+  const servers = config.servers
+    ? config.servers
+    : [{ ...config, label: null }];
+
+  // 显示目标信息
+  console.log('');
+  if (servers.length === 1) {
+    info(`服务器：${servers[0].host}   应用：${config.appName}`);
+  } else {
+    info(`将部署到 ${chalk.bold(servers.length)} 台服务器：`);
+    servers.forEach(s => {
+      console.log(chalk.gray(`    • ${s.label || s.host}  (${s.host})`));
+    });
+  }
+
+  // 询问部署选项
+  const promptList = [
+    {
+      type: 'confirm',
+      name: 'confirm',
+      message: '确认推送当前代码到服务器？',
+      default: true,
+    },
+    {
+      type: 'confirm',
+      name: 'backupDb',
+      message: '部署前备份数据库？',
+      default: true,
+      when: (a) => a.confirm && !!config.database,
+    },
+  ];
+
+  if (servers.length > 1) {
+    promptList.push({
+      type: 'list',
+      name: 'strategy',
+      message: '多服务器部署策略：',
+      choices: [
+        { name: '并行（同时部署所有服务器，速度最快）', value: 'parallel' },
+        { name: '串行（逐台部署，出错可停止）', value: 'serial' },
+        { name: '滚动（每台完成后确认再继续下一台）', value: 'rolling' },
+      ],
+      when: (a) => a.confirm,
+    });
+  }
+
+  const options = await inquirer.prompt(promptList);
+  if (!options.confirm) return;
+
+  console.log('');
+
+  // 部署前数据库备份
+  if (options.backupDb && config.database) {
+    console.log(chalk.bold('📦 部署前数据库备份\n'));
+    await doBackup(config, true);
+    console.log('');
+  }
+
+  // 执行部署
+  console.log(chalk.bold('🚀 开始部署\n'));
+  const strategy = options.strategy || 'serial';
+  const results = [];
+
+  if (servers.length === 1 || strategy === 'parallel') {
+    const outcomes = await Promise.all(servers.map(s => deployToServer(s)));
+    results.push(...outcomes);
+
+  } else if (strategy === 'serial') {
+    for (const server of servers) {
+      const ok = await deployToServer(server);
+      results.push(ok);
+      if (!ok) {
+        const { continueAnyway } = await inquirer.prompt([{
+          type: 'confirm',
+          name: 'continueAnyway',
+          message: chalk.yellow(`${server.label || server.host} 失败，继续其余服务器？`),
+          default: false,
+        }]);
+        if (!continueAnyway) break;
+      }
+    }
+
+  } else if (strategy === 'rolling') {
+    for (let i = 0; i < servers.length; i++) {
+      const ok = await deployToServer(servers[i]);
+      results.push(ok);
+      if (ok && i < servers.length - 1) {
+        const { goNext } = await inquirer.prompt([{
+          type: 'confirm',
+          name: 'goNext',
+          message: `继续下一台 ${servers[i + 1].label || servers[i + 1].host}？`,
+          default: true,
+        }]);
+        if (!goNext) break;
+      }
+    }
+  }
+
+  // 汇总
+  const successCount = results.filter(Boolean).length;
+  const failCount = results.length - successCount;
+
+  console.log('');
+  if (failCount === 0) {
+    console.log(chalk.green.bold(`✅ 全部 ${successCount} 台服务器部署成功！`));
+  } else {
+    console.log(chalk.yellow.bold(`⚠  ${successCount} 台成功，${failCount} 台失败`));
+    console.log(chalk.gray('  运行 deploy-helper rollback 可回滚'));
+  }
+
+  const main = servers[0];
+  const url = main.useHttps && main.domain
+    ? `https://${main.domain}`
+    : main.domain ? `http://${main.domain}` : `http://${main.host}`;
+  console.log(`  访问地址：${chalk.cyan.underline(url)}\n`);
+}
+
+/**
+ * 多服务器配置管理命令
+ */
+export async function manageServers() {
+  const config = loadConfig();
+  if (!config) {
+    console.log(chalk.red('\n没有找到部署配置，请先运行：') + chalk.cyan(' deploy-helper init\n'));
+    return;
+  }
+
+  const servers = config.servers || [{ ...config, label: '主服务器' }];
+
+  const { action } = await inquirer.prompt([{
+    type: 'list',
+    name: 'action',
+    message: '服务器管理：',
+    choices: [
+      { name: `查看列表（当前 ${servers.length} 台）`, value: 'list' },
+      { name: '添加服务器', value: 'add' },
+      { name: '删除服务器', value: 'remove' },
+    ],
+  }]);
+
+  if (action === 'list') {
+    console.log(chalk.bold(`\n  服务器列表（${servers.length} 台）：\n`));
+    servers.forEach((s, i) => {
+      console.log(`  ${chalk.cyan(i + 1 + '.')} ${chalk.bold(s.label || s.host)}`);
+      console.log(chalk.gray(`     ${s.user}@${s.host}:${s.port || 22}  →  ${s.remotePath}`));
+    });
+    console.log('');
+
+  } else if (action === 'add') {
+    const newServer = await inquirer.prompt([
+      { type: 'input', name: 'label', message: '服务器别名（如"备用节点"）：' },
+      { type: 'input', name: 'host', message: 'IP 地址：', validate: v => v.trim() ? true : '必填' },
+      { type: 'input', name: 'port', message: 'SSH 端口：', default: '22' },
+      { type: 'input', name: 'user', message: '用户名：', default: config.user || 'root' },
+      {
+        type: 'list', name: 'authType', message: '登录方式：',
+        choices: [{ name: 'SSH 密钥', value: 'key' }, { name: '密码', value: 'password' }],
+        default: config.authType,
+      },
+      {
+        type: 'input', name: 'keyPath', message: 'SSH 密钥路径：',
+        default: config.keyPath, when: a => a.authType === 'key',
+      },
+      {
+        type: 'password', name: 'password', message: '密码：',
+        mask: '*', when: a => a.authType === 'password',
+      },
+      { type: 'input', name: 'remotePath', message: '部署路径：', default: config.remotePath },
+    ]);
+
+    const sp = ora('测试连接...').start();
+    try {
+      const ssh = await connectSSH({ ...config, ...newServer });
+      ssh.dispose();
+      sp.succeed('连接测试成功');
+    } catch (err) {
+      sp.fail('连接测试失败：' + err.message);
+      return;
+    }
+
+    const updatedServers = [...servers, { ...config, ...newServer }];
+    saveConfig({ ...config, servers: updatedServers });
+    console.log(chalk.green(`\n✅ 服务器 "${newServer.label || newServer.host}" 已添加。\n`));
+
+  } else if (action === 'remove') {
+    if (servers.length === 1) {
+      console.log(chalk.yellow('\n只剩一台服务器，无法删除。\n'));
+      return;
+    }
+    const { toRemove } = await inquirer.prompt([{
+      type: 'checkbox',
+      name: 'toRemove',
+      message: '选择要删除的服务器：',
+      choices: servers.map((s, i) => ({ name: `${s.label || s.host} (${s.host})`, value: i })),
+    }]);
+    const remaining = servers.filter((_, i) => !toRemove.includes(i));
+    saveConfig({ ...config, servers: remaining });
+    console.log(chalk.green(`\n✅ 已删除 ${toRemove.length} 台服务器。\n`));
+  }
+}

package/src/index.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+import chalk from 'chalk';
+import { deployInit } from './commands/init.js';
+import { deployUpdate, manageServers } from './commands/update.js';
+import { deployStatus } from './commands/status.js';
+import { deployRollback } from './commands/rollback.js';
+import { deployEnv } from './commands/env.js';
+import { deployBackup } from './commands/backup.js';
+
+console.log(chalk.cyan.bold('\n🚀 deploy-helper') + chalk.gray(' v0.2.0 — 把项目部署到服务器，就这么简单\n'));
+
+program
+  .name('deploy-helper')
+  .description('交互式部署工具，帮你把项目从本地跑到任意 VPS 服务器上')
+  .version('0.2.0');
+
+program
+  .command('init')
+  .description('首次部署：引导你完成全套配置')
+  .action(deployInit);
+
+program
+  .command('update')
+  .description('更新部署：推送最新代码并重启（支持多服务器）')
+  .action(deployUpdate);
+
+program
+  .command('status')
+  .description('查看服务运行状态、内存占用、最近日志')
+  .action(deployStatus);
+
+program
+  .command('rollback')
+  .description('版本回滚：从历史快照中选择一个版本还原')
+  .action(deployRollback);
+
+program
+  .command('env')
+  .description('环境变量管理：上传/下载/对比 .env 文件')
+  .action(deployEnv);
+
+program
+  .command('backup')
+  .description('数据库备份：MySQL / PostgreSQL / MongoDB，支持定时任务')
+  .action(deployBackup);
+
+program
+  .command('servers')
+  .description('服务器管理：查看、添加、删除多台服务器')
+  .action(manageServers);
+
+// 无命令时显示帮助 + 进入 init
+if (process.argv.length === 2) {
+  console.log(chalk.bold('可用命令：\n'));
+  console.log(`  ${chalk.cyan('init')}      首次部署，全程引导`);
+  console.log(`  ${chalk.cyan('update')}    推送新代码到服务器（支持多台）`);
+  console.log(`  ${chalk.cyan('rollback')}  回滚到历史版本`);
+  console.log(`  ${chalk.cyan('env')}       管理 .env 环境变量`);
+  console.log(`  ${chalk.cyan('backup')}    数据库备份`);
+  console.log(`  ${chalk.cyan('servers')}   管理多台服务器`);
+  console.log(`  ${chalk.cyan('status')}    查看运行状态\n`);
+  console.log(chalk.gray('首次使用？运行：') + chalk.cyan(' deploy-helper init\n'));
+} else {
+  program.parse();
+}

package/src/utils/config.js

@@ -0,0 +1,23 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+
+const CONFIG_DIR = path.join(os.homedir(), '.deploy-helper');
+const CONFIG_FILE = path.join(process.cwd(), '.deploy-config.json');
+
+export function saveConfig(config) {
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+
+export function loadConfig() {
+  if (!fs.existsSync(CONFIG_FILE)) return null;
+  try {
+    return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+  } catch {
+    return null;
+  }
+}
+
+export function configExists() {
+  return fs.existsSync(CONFIG_FILE);
+}