@zhengyizhao/deploy-helper 0.1.0 → 0.2.1

package/src/utils/detect.js

@@ -6,14 +6,16 @@ export function detectProjectType(projectPath = process.cwd()) {
 
   if (files.includes('package.json')) {
     const pkg = JSON.parse(fs.readFileSync(path.join(projectPath, 'package.json'), 'utf-8'));
-    // 判断是否是纯前端项目
     const deps = { ...pkg.dependencies, ...pkg.devDependencies };
-    if (deps['next'] || deps['nuxt']) return 'nodejs'; // SSR 框架当后端处理
-    if (pkg.scripts?.build && !pkg.scripts?.start) return 'static'; // 只有 build 没有 start
+    if (deps['next'] || deps['nuxt']) return 'nodejs';
+    if (pkg.scripts?.build && !pkg.scripts?.start) return 'static';
     return 'nodejs';
   }
 
-  if (files.includes('requirements.txt') || files.includes('pyproject.toml') || files.includes('setup.py')) {
+  if (
+    files.includes('requirements.txt') || files.includes('pyproject.toml') ||
+    files.includes('setup.py') || files.includes('environment.yml') || files.includes('conda-lock.yml')
+  ) {
     return 'python';
   }
 
@@ -28,6 +30,109 @@ export function detectProjectType(projectPath = process.cwd()) {
   return 'unknown';
 }
 
+// 从 .nvmrc / .node-version / package.json engines.node 读取主版本号
+export function detectNodeVersion(projectPath = process.cwd()) {
+  for (const file of ['.nvmrc', '.node-version']) {
+    const p = path.join(projectPath, file);
+    if (fs.existsSync(p)) {
+      const raw = fs.readFileSync(p, 'utf-8').trim().replace(/^v/, '');
+      const major = parseInt(raw);
+      if (!isNaN(major)) return { version: String(major), source: file };
+    }
+  }
+
+  const pkgPath = path.join(projectPath, 'package.json');
+  if (fs.existsSync(pkgPath)) {
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+    if (pkg.engines?.node) {
+      const match = pkg.engines.node.match(/(\d+)/);
+      if (match) return { version: match[1], source: 'package.json engines.node' };
+    }
+  }
+
+  return null;
+}
+
+// 检测 Python 依赖管理方式：conda（environment.yml）或 pip（requirements.txt）
+export function detectPythonEnvManager(projectPath = process.cwd()) {
+  if (
+    fs.existsSync(path.join(projectPath, 'environment.yml')) ||
+    fs.existsSync(path.join(projectPath, 'conda-lock.yml'))
+  ) return 'conda';
+  if (
+    fs.existsSync(path.join(projectPath, 'requirements.txt')) ||
+    fs.existsSync(path.join(projectPath, 'pyproject.toml'))
+  ) return 'pip';
+  return null;
+}
+
+// 从 requirements.txt 检测 Python 框架
+export function detectPythonFramework(projectPath = process.cwd()) {
+  const reqPath = path.join(projectPath, 'requirements.txt');
+  if (!fs.existsSync(reqPath)) return null;
+
+  const content = fs.readFileSync(reqPath, 'utf-8').toLowerCase();
+  // 按优先级检测，fastapi 优先（flask 是 fastapi 的间接依赖有时也会出现）
+  if (content.match(/^fastapi[>=\[<\s]/m) || content.includes('\nfastapi')) return 'fastapi';
+  if (content.match(/^django[>=\[<\s]/m) || content.includes('\ndjango')) return 'django';
+  if (content.match(/^flask[>=\[<\s]/m) || content.includes('\nflask')) return 'flask';
+  return null;
+}
+
+// 从 .python-version 或 pyproject.toml 读取 Python 版本
+export function detectPythonVersion(projectPath = process.cwd()) {
+  const pyVersionPath = path.join(projectPath, '.python-version');
+  if (fs.existsSync(pyVersionPath)) {
+    const raw = fs.readFileSync(pyVersionPath, 'utf-8').trim();
+    const match = raw.match(/^(\d+\.\d+)/);
+    if (match) return { version: match[1], source: '.python-version' };
+  }
+
+  const pyprojectPath = path.join(projectPath, 'pyproject.toml');
+  if (fs.existsSync(pyprojectPath)) {
+    const content = fs.readFileSync(pyprojectPath, 'utf-8');
+    const match = content.match(/python\s*=\s*["'][^"']*?(\d+\.\d+)/);
+    if (match) return { version: match[1], source: 'pyproject.toml' };
+  }
+
+  return null;
+}
+
+// 读取 package.json scripts.start，或扫描常见入口文件
+export function getNodeStartCommand(projectPath = process.cwd()) {
+  const pkgPath = path.join(projectPath, 'package.json');
+  if (fs.existsSync(pkgPath)) {
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+
+    if (pkg.scripts?.start) {
+      return { cmd: pkg.scripts.start, source: 'package.json scripts.start' };
+    }
+
+    const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+    if (deps['next']) return { cmd: 'next start', source: 'next.js 依赖' };
+    if (deps['nuxt']) return { cmd: 'nuxt start', source: 'nuxt.js 依赖' };
+  }
+
+  for (const file of ['index.js', 'app.js', 'server.js', 'main.js']) {
+    if (fs.existsSync(path.join(projectPath, file))) {
+      return { cmd: `node ${file}`, source: `检测到入口文件 ${file}` };
+    }
+  }
+
+  return { cmd: 'node index.js', source: '默认值' };
+}
+
+// 根据框架生成 Python 启动命令；framework 为 other 时扫描常见入口文件
+export function getPythonStartCommand(framework, appName, port, projectPath = process.cwd()) {
+  if (framework === 'fastapi') return `uvicorn main:app --host 0.0.0.0 --port ${port}`;
+  if (framework === 'django') return `gunicorn ${appName}.wsgi:application --bind 0.0.0.0:${port}`;
+  if (framework === 'flask') return `gunicorn app:app --bind 0.0.0.0:${port}`;
+  for (const file of ['main.py', 'app.py', 'run.py', 'server.py', 'manage.py']) {
+    if (fs.existsSync(path.join(projectPath, file))) return `python ${file}`;
+  }
+  return 'python main.py';
+}
+
 export const PROJECT_TYPE_LABELS = {
   nodejs: 'Node.js 应用（Express / Koa / Next.js 等）',
   python: 'Python 应用（Flask / FastAPI / Django 等）',
@@ -36,13 +141,40 @@ export const PROJECT_TYPE_LABELS = {
   unknown: '其他 / 我来手动指定',
 };
 
-// 根据项目类型返回启动命令建议
-export function getStartCommand(type, pkg) {
-  if (type === 'nodejs') {
-    if (pkg?.scripts?.start) return pkg.scripts.start;
-    return 'node index.js';
+export const PYTHON_FRAMEWORK_LABELS = {
+  fastapi: 'FastAPI',
+  django: 'Django',
+  flask: 'Flask',
+  other: '其他',
+};
+
+export function hasDockerfile(projectPath = process.cwd()) {
+  return fs.existsSync(path.join(projectPath, 'Dockerfile'));
+}
+
+export function detectComposeFile(projectPath = process.cwd()) {
+  for (const name of ['docker-compose.yml', 'docker-compose.yaml', 'compose.yml', 'compose.yaml']) {
+    if (fs.existsSync(path.join(projectPath, name))) return name;
   }
-  if (type === 'python') return 'python app.py';
-  if (type === 'docker') return 'docker-compose up -d';
-  return '';
+  return null;
+}
+
+// 从 Dockerfile EXPOSE 或 docker-compose ports 映射读取宿主机端口
+export function detectDockerPort(projectPath = process.cwd()) {
+  const dockerfilePath = path.join(projectPath, 'Dockerfile');
+  if (fs.existsSync(dockerfilePath)) {
+    const content = fs.readFileSync(dockerfilePath, 'utf-8');
+    const match = content.match(/^EXPOSE\s+(\d+)/m);
+    if (match) return { port: match[1], source: 'Dockerfile EXPOSE' };
+  }
+
+  const composeName = detectComposeFile(projectPath);
+  if (composeName) {
+    const content = fs.readFileSync(path.join(projectPath, composeName), 'utf-8');
+    // 匹配 "- 8080:3000" 或 "- '8080:3000'" 格式，取宿主机端口
+    const match = content.match(/^\s*-\s*["']?(\d+):\d+/m);
+    if (match) return { port: match[1], source: composeName };
+  }
+
+  return null;
 }

package/src/utils/setup.js

@@ -1,80 +1,298 @@
+// shell heredoc：用单引号 EOF 防止 $/反引号/% 被解释，正文本身 single-quote 也安全
+function writeFileHeredoc(remotePath, content) {
+  // 使用唯一 sentinel 避免与正文冲突
+  const sentinel = 'DEPLOY_HELPER_EOF';
+  return `cat > ${remotePath} <<'${sentinel}'\n${content}\n${sentinel}`;
+}
+
 // 返回在服务器上执行的 shell 命令数组
 export function getSetupCommands(config) {
-  const { projectType, nodeVersion = '20', pythonVersion = '3.11' } = config;
+  const { projectType, nodeVersion = '20', pythonVersion = '3.11', appMode = 'web' } = config;
   const steps = [];
 
-  // 通用：更新系统 & 安装 nginx
   steps.push({
     label: '更新系统包',
     cmd: 'apt-get update -qq',
   });
-  steps.push({
-    label: '安装 Nginx',
-    cmd: 'apt-get install -y -qq nginx',
-  });
-  steps.push({
-    label: '安装 Certbot（用于 HTTPS）',
-    cmd: 'apt-get install -y -qq certbot python3-certbot-nginx',
-  });
 
-  if (projectType === 'nodejs') {
+  // Nginx 和 Certbot 只有 web 服务需要
+  if (appMode === 'web') {
     steps.push({
-      label: `安装 Node.js ${nodeVersion}`,
-      cmd: `curl -fsSL https://deb.nodesource.com/setup_${nodeVersion}.x | bash - && apt-get install -y nodejs`,
+      label: '安装 Nginx',
+      cmd: 'apt-get install -y -qq nginx',
     });
     steps.push({
-      label: '安装 PM2（进程管理器）',
-      cmd: 'npm install -g pm2',
+      label: '安装 Certbot（用于 HTTPS）',
+      cmd: 'apt-get install -y -qq certbot python3-certbot-nginx',
     });
   }
 
-  if (projectType === 'python') {
+  if (projectType === 'nodejs') {
     steps.push({
-      label: '安装 Python & pip',
-      cmd: `apt-get install -y -qq python3 python3-pip python3-venv`,
+      label: `安装 Node.js ${nodeVersion}`,
+      cmd: `command -v node >/dev/null 2>&1 && node -v | grep -q "^v${nodeVersion}\\." || (curl -fsSL https://deb.nodesource.com/setup_${nodeVersion}.x | bash - && apt-get install -y nodejs)`,
     });
     steps.push({
-      label: '安装 supervisor（进程管理）',
-      cmd: 'apt-get install -y -qq supervisor',
+      label: '安装 PM2（进程管理器）',
+      cmd: 'command -v pm2 >/dev/null 2>&1 || npm install -g pm2',
     });
   }
 
+  if (projectType === 'python') {
+    const { pythonEnvManager = 'pip' } = config;
+
+    if (pythonEnvManager === 'conda') {
+      // 安装 Miniconda 到固定路径，已存在则跳过
+      steps.push({
+        label: '安装 Miniconda（如未安装）',
+        cmd: [
+          'command -v /opt/miniconda3/bin/conda >/dev/null 2>&1 || (',
+          '  curl -fsSL https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh -o /tmp/miniconda.sh &&',
+          '  bash /tmp/miniconda.sh -b -p /opt/miniconda3 &&',
+          '  rm /tmp/miniconda.sh',
+          ')',
+        ].join(' '),
+      });
+    } else {
+      const pyBin = `python${pythonVersion}`;
+      steps.push({
+        label: `安装 Python ${pythonVersion}（如未安装）`,
+        cmd: [
+          `command -v ${pyBin} >/dev/null 2>&1 || (`,
+          '  apt-get install -y -qq software-properties-common &&',
+          '  add-apt-repository -y ppa:deadsnakes/ppa &&',
+          '  apt-get update -qq &&',
+          `  apt-get install -y -qq ${pyBin} ${pyBin}-venv ${pyBin}-distutils`,
+          `  || apt-get install -y -qq python3 python3-venv`,
+          ')',
+          `&& (apt-get install -y -qq ${pyBin}-venv 2>/dev/null || apt-get install -y -qq python3-venv 2>/dev/null || true)`,
+        ].join(' '),
+      });
+    }
+
+    // cron 模式不需要 supervisor
+    if (appMode !== 'cron') {
+      steps.push({
+        label: '安装 supervisor（进程管理）',
+        cmd: 'command -v supervisorctl >/dev/null 2>&1 || apt-get install -y -qq supervisor',
+      });
+    }
+  }
+
   if (projectType === 'docker') {
+    // Docker 可能已预装（云服务商镜像常见），先检查再安装
     steps.push({
-      label: '安装 Docker',
-      cmd: `curl -fsSL https://get.docker.com | sh`,
+      label: '检查/安装 Docker',
+      cmd: `command -v docker >/dev/null 2>&1 || curl -fsSL https://get.docker.com | sh`,
     });
     steps.push({
-      label: '安装 docker-compose',
-      cmd: `apt-get install -y -qq docker-compose-plugin`,
+      label: '检查/安装 docker-compose-plugin',
+      cmd: `docker compose version >/dev/null 2>&1 || apt-get install -y -qq docker-compose-plugin`,
+    });
+    steps.push({
+      label: '确保 Docker 服务运行',
+      cmd: `systemctl enable docker && systemctl start docker`,
     });
   }
 
   return steps;
 }
 
+// 写入 crontab（幂等：先删除同名旧条目再添加）
+function buildCronEntry(appName, schedule, fullCmd) {
+  const marker = `deploy-helper:${appName}`;
+  const logFile = `/var/log/${appName}.log`;
+  // 注意：crontab 行本身不能有未转义的 % —— 这里 grep -v 用 marker 去重
+  // fullCmd 中如有 % 由调用方负责（typical 启动命令不会有）
+  return `(crontab -l 2>/dev/null | grep -v "${marker}"; echo "# ${marker}"; echo "${schedule} ${fullCmd} >> ${logFile} 2>&1") | crontab -`;
+}
+
 // 启动/重启应用的命令
 export function getStartCommands(config) {
-  const { projectType, remotePath, startCmd, appName, port } = config;
+  const {
+    projectType, remotePath, startCmd, appName, port,
+    pythonVersion = '3.11', pythonFramework, pythonEnvManager = 'pip',
+    appMode = 'web', cronSchedule, composeFile,
+  } = config;
 
   if (projectType === 'nodejs') {
-    return [
+    const isNpmCmd = /^npm\s/.test(startCmd);
+    const steps = [
       { label: '安装依赖', cmd: `cd ${remotePath} && npm install --production` },
-      { label: '启动应用（PM2）', cmd: `cd ${remotePath} && pm2 delete ${appName} 2>/dev/null; pm2 start ${startCmd} --name ${appName}` },
-      { label: '设置 PM2 开机自启', cmd: `pm2 save && pm2 startup | tail -1 | bash || true` },
     ];
+
+    if (appMode === 'cron') {
+      const cronFullCmd = `cd ${remotePath} && ${startCmd}`;
+      steps.push({
+        label: '写入定时任务（crontab）',
+        cmd: buildCronEntry(appName, cronSchedule, cronFullCmd),
+      });
+      steps.push({
+        label: '立即执行一次（验证）',
+        cmd: `${cronFullCmd} >> /var/log/${appName}.log 2>&1 || true`,
+      });
+      return steps;
+    }
+
+    // 非 npm 命令通过 .start.sh 包装；npm 命令用 pm2 start npm -- ...
+    const startScript = `${remotePath}/.start.sh`;
+    const startScriptContent = `#!/bin/bash\ncd ${remotePath}\nexec ${startCmd}\n`;
+
+    if (!isNpmCmd) {
+      steps.push({
+        label: '写入启动脚本',
+        cmd: `${writeFileHeredoc(startScript, startScriptContent)} && chmod +x ${startScript}`,
+      });
+    }
+
+    const pm2Target = isNpmCmd
+      ? `npm --name ${appName} -- ${startCmd.replace(/^npm\s+/, '')}`
+      : `${startScript} --name ${appName} --interpreter bash`;
+
+    // script 模式不自动重启；web 模式正常重启
+    const pm2StartCmd = appMode === 'script'
+      ? `pm2 delete ${appName} 2>/dev/null || true; pm2 start ${pm2Target} --no-autorestart`
+      : `pm2 delete ${appName} 2>/dev/null || true; pm2 start ${pm2Target}`;
+
+    steps.push(
+      { label: `启动应用（PM2${appMode === 'script' ? '，不自动重启' : ''}）`, cmd: pm2StartCmd },
+      { label: '设置 PM2 开机自启', cmd: `pm2 save && (pm2 startup | tail -1 | bash || true)` },
+    );
+
+    return steps;
   }
 
   if (projectType === 'python') {
+    const supervisorConfPath = `/etc/supervisor/conf.d/${appName}.conf`;
+
+    if (pythonEnvManager === 'conda') {
+      const condaBin = '/opt/miniconda3/bin/conda';
+      const condaCmd = `${condaBin} run -n ${appName} --no-capture-output ${startCmd}`;
+      const installSteps = [
+        {
+          label: '创建/更新 conda 环境',
+          cmd: [
+            `${condaBin} env update -f ${remotePath}/environment.yml -n ${appName} --prune 2>/dev/null`,
+            `|| ${condaBin} env create -f ${remotePath}/environment.yml -n ${appName}`,
+          ].join(' '),
+        },
+      ];
+
+      if (appMode === 'cron') {
+        return [
+          ...installSteps,
+          {
+            label: '写入定时任务（crontab）',
+            cmd: buildCronEntry(appName, cronSchedule, condaCmd),
+          },
+          {
+            label: '立即执行一次（验证）',
+            cmd: `${condaCmd} >> /var/log/${appName}.log 2>&1 || true`,
+          },
+        ];
+      }
+
+      const supervisorConf = getSupervisorConfig({
+        appName, remotePath, venvCmd: condaCmd,
+        autorestart: appMode === 'script' ? 'unexpected' : 'true',
+      });
+      return [
+        ...installSteps,
+        {
+          label: '写入 supervisor 配置',
+          cmd: writeFileHeredoc(supervisorConfPath, supervisorConf),
+        },
+        {
+          label: '启动应用（supervisor）',
+          cmd: `supervisorctl reread && supervisorctl update && (supervisorctl restart ${appName} 2>/dev/null || supervisorctl start ${appName})`,
+        },
+      ];
+    }
+
+    // pip + venv 路径
+    const pyBin = `python${pythonVersion}`;
+    const venvPip = `${remotePath}/venv/bin/pip`;
+    const venvCmd = startCmd.replace(/^(\S+)/, `${remotePath}/venv/bin/$1`);
+
+    const installSteps = [
+      {
+        label: '创建 Python 虚拟环境',
+        cmd: `test -d ${remotePath}/venv || (${pyBin} -m venv ${remotePath}/venv || python3 -m venv ${remotePath}/venv)`,
+      },
+      {
+        label: '安装 Python 依赖',
+        cmd: `cd ${remotePath} && ${venvPip} install -r requirements.txt -q`,
+      },
+    ];
+
+    if (appMode === 'web') {
+      const extraPkg = pythonFramework === 'fastapi' ? 'uvicorn' : 'gunicorn';
+      installSteps.push({
+        label: `安装 ${extraPkg}（WSGI/ASGI 服务器）`,
+        cmd: `${venvPip} install ${extraPkg} -q`,
+      });
+    }
+
+    if (appMode === 'cron') {
+      return [
+        ...installSteps,
+        {
+          label: '写入定时任务（crontab）',
+          cmd: buildCronEntry(appName, cronSchedule, `cd ${remotePath} && ${venvCmd}`),
+        },
+        {
+          label: '立即执行一次（验证）',
+          cmd: `cd ${remotePath} && ${venvCmd} >> /var/log/${appName}.log 2>&1 || true`,
+        },
+      ];
+    }
+
+    const supervisorConf = getSupervisorConfig({
+      appName, remotePath, venvCmd,
+      autorestart: appMode === 'script' ? 'unexpected' : 'true',
+    });
     return [
-      { label: '安装 Python 依赖', cmd: `cd ${remotePath} && pip3 install -r requirements.txt -q` },
-      { label: '启动应用（supervisor）', cmd: `cd ${remotePath} && supervisorctl reread && supervisorctl update && supervisorctl restart ${appName}` },
+      ...installSteps,
+      {
+        label: '写入 supervisor 配置',
+        cmd: writeFileHeredoc(supervisorConfPath, supervisorConf),
+      },
+      {
+        label: '启动应用（supervisor）',
+        cmd: `supervisorctl reread && supervisorctl update && (supervisorctl restart ${appName} 2>/dev/null || supervisorctl start ${appName})`,
+      },
     ];
   }
 
   if (projectType === 'docker') {
+    if (composeFile) {
+      const composeCmd = `docker compose -f ${composeFile}`;
+      return [
+        {
+          label: '拉取基础镜像（如有）',
+          cmd: `cd ${remotePath} && ${composeCmd} pull 2>/dev/null || true`,
+        },
+        {
+          label: '构建并启动容器',
+          cmd: `cd ${remotePath} && ${composeCmd} up -d --build --remove-orphans`,
+        },
+      ];
+    }
+
+    // 无 compose 文件：单容器模式
     return [
-      { label: '启动容器', cmd: `cd ${remotePath} && docker compose up -d --build` },
+      {
+        label: '构建 Docker 镜像',
+        cmd: `cd ${remotePath} && docker build -t ${appName} .`,
+      },
+      {
+        label: '启动容器',
+        cmd: [
+          `docker stop ${appName} 2>/dev/null || true`,
+          `docker rm ${appName} 2>/dev/null || true`,
+          `docker run -d --name ${appName} --restart unless-stopped -p ${port}:${port} ${appName}`,
+        ].join(' && '),
+      },
     ];
   }
 
@@ -87,6 +305,133 @@ export function getStartCommands(config) {
   return [];
 }
 
+// 停止服务（供 rollback 使用）
+export function getStopCommand(config) {
+  const { projectType, appName, remotePath, appMode = 'web', composeFile } = config;
+
+  if (appMode === 'cron') {
+    // cron 不需要停止；下次定时不命中即可。
+    // 如果想立即停，可以从 crontab 移除——但 rollback 之后通常想保留定时
+    return null;
+  }
+
+  if (projectType === 'nodejs') {
+    return `pm2 stop ${appName} 2>/dev/null || true`;
+  }
+  if (projectType === 'python') {
+    return `supervisorctl stop ${appName} 2>/dev/null || true`;
+  }
+  if (projectType === 'docker') {
+    if (composeFile) {
+      return `cd ${remotePath} && docker compose -f ${composeFile} down 2>/dev/null || true`;
+    }
+    return `docker stop ${appName} 2>/dev/null || true; docker rm ${appName} 2>/dev/null || true`;
+  }
+  return null;
+}
+
+// 健康检查：返回 { cmd, parse } —— parse 接受 {stdout, code} 返回 { ok, detail }
+export function getHealthCheck(config) {
+  const { projectType, appName, remotePath, appMode = 'web', composeFile, pythonEnvManager } = config;
+
+  if (appMode === 'cron') {
+    const marker = `deploy-helper:${appName}`;
+    return {
+      cmd: `crontab -l 2>/dev/null | grep -F "${marker}" | head -1`,
+      parse: ({ stdout }) => stdout
+        ? { ok: true, detail: '已写入 crontab' }
+        : { ok: false, detail: '未在 crontab 中找到该任务' },
+    };
+  }
+
+  if (projectType === 'nodejs') {
+    return {
+      cmd: `pm2 jlist 2>/dev/null`,
+      parse: ({ stdout }) => {
+        try {
+          const list = JSON.parse(stdout || '[]');
+          const app = list.find(p => p.name === appName);
+          if (!app) return { ok: false, detail: `PM2 中未找到 ${appName}` };
+          const status = app.pm2_env?.status;
+          return status === 'online'
+            ? { ok: true, detail: `PM2 状态: online (PID ${app.pid})` }
+            : { ok: false, detail: `PM2 状态: ${status}` };
+        } catch {
+          return { ok: false, detail: 'pm2 jlist 解析失败' };
+        }
+      },
+    };
+  }
+
+  if (projectType === 'python') {
+    return {
+      cmd: `supervisorctl status ${appName} 2>&1 || true`,
+      parse: ({ stdout }) => {
+        const line = stdout.trim();
+        if (/RUNNING/.test(line)) return { ok: true, detail: line };
+        return { ok: false, detail: line || 'supervisor 未返回状态' };
+      },
+    };
+  }
+
+  if (projectType === 'docker') {
+    if (composeFile) {
+      return {
+        cmd: `cd ${remotePath} && docker compose -f ${composeFile} ps --format json 2>/dev/null || true`,
+        parse: ({ stdout }) => {
+          const raw = stdout.trim();
+          if (!raw) return { ok: false, detail: 'docker compose ps 无输出' };
+          // 兼容两种格式：旧版 docker compose 输出 JSON 数组，新版输出 NDJSON
+          let services = [];
+          try {
+            const parsed = JSON.parse(raw);
+            services = Array.isArray(parsed) ? parsed : [parsed];
+          } catch {
+            services = raw.split('\n').filter(Boolean)
+              .map(l => { try { return JSON.parse(l); } catch { return null; } })
+              .filter(Boolean);
+          }
+          if (services.length === 0) return { ok: false, detail: '未找到运行中的服务' };
+          const allRunning = services.every(s => /running|up/i.test(s.State || s.Status || ''));
+          return {
+            ok: allRunning,
+            detail: services.map(s => `${s.Service || s.Name}: ${s.State || s.Status}`).join('; '),
+          };
+        },
+      };
+    }
+    return {
+      cmd: `docker inspect -f '{{.State.Status}}' ${appName} 2>/dev/null || echo missing`,
+      parse: ({ stdout }) => stdout.trim() === 'running'
+        ? { ok: true, detail: '容器运行中' }
+        : { ok: false, detail: `容器状态: ${stdout.trim()}` },
+    };
+  }
+
+  // static 没有进程，认为只要 Nginx 在跑即可
+  return {
+    cmd: `systemctl is-active nginx 2>/dev/null || true`,
+    parse: ({ stdout }) => stdout.trim() === 'active'
+      ? { ok: true, detail: 'Nginx active' }
+      : { ok: false, detail: `Nginx 状态: ${stdout.trim()}` },
+  };
+}
+
+// 生成 supervisor 配置内容（heredoc 写入，使用真实换行）
+// autorestart: 'true'（始终重启）| 'unexpected'（仅崩溃时重启）| 'false'
+function getSupervisorConfig({ appName, remotePath, venvCmd, autorestart = 'true' }) {
+  return [
+    `[program:${appName}]`,
+    `command=${venvCmd}`,
+    `directory=${remotePath}`,
+    `autostart=true`,
+    `autorestart=${autorestart}`,
+    `stderr_logfile=/var/log/${appName}.err.log`,
+    `stdout_logfile=/var/log/${appName}.out.log`,
+    ``,
+  ].join('\n');
+}
+
 // 生成 Nginx 配置
 export function getNginxConfig(config) {
   const { domain, port, projectType, remotePath } = config;
@@ -124,3 +469,6 @@ export function getNginxConfig(config) {
     }
 }`;
 }
+
+// 把任意字符串内容写入服务器文件的 shell 命令（heredoc 方式）
+export { writeFileHeredoc };