@mindbase/deploy 1.0.0 → 1.1.0

package/bin/index.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env tsx
+import { createDeployProgram } from './shared.js';
+createDeployProgram().parse();

package/bin/shared.ts

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

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@mindbase/deploy",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "MindBase 部署工具",
   "type": "module",
   "bin": {
-    "deploy": "./dist/bin/index.js"
+    "deploy": "./bin/index.ts"
   },
   "files": [
-    "dist"
+    "bin",
+    "src",
+    "scripts"
   ],
   "engines": {
     "node": ">=20.0.0"
@@ -16,11 +18,9 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "clean": "rm -rf dist",
-    "start": "node dist/bin/index.js",
-    "prepublishOnly": "npm run build"
+    "dev": "tsx bin/index.ts",
+    "start": "tsx bin/index.ts",
+    "postinstall": "node scripts/ensure-tsx.cjs"
   },
   "dependencies": {
     "@clack/prompts": "^0.9.1",
@@ -28,13 +28,13 @@
     "commander": "^12.0.0",
     "cross-spawn": "^7.0.6",
     "picocolors": "^1.1.1",
-    "ssh2-sftp-client": "^9.1.0"
+    "ssh2-sftp-client": "^9.1.0",
+    "tsx": "^4.19.0"
   },
   "devDependencies": {
     "@types/cross-spawn": "^6.0.6",
     "@types/node": "^20.0.0",
     "@types/ssh2-sftp-client": "^9.0.4",
-    "tsup": "^8.0.0",
     "typescript": "^5.1.3"
   }
-}
+}

package/scripts/ensure-tsx.cjs

@@ -0,0 +1,18 @@
+const { execSync } = require('child_process');
+
+// 跳过检查（用于 CI/CD）
+if (process.env.MINDBASE_SKIP_TSX_CHECK) {
+  process.exit(0);
+}
+
+try {
+  execSync('tsx --version', { stdio: 'pipe' });
+} catch (err) {
+  console.log('\n📦 未检测到 tsx，正在全局安装...\n');
+  try {
+    execSync('npm install -g tsx', { stdio: 'inherit' });
+  } catch (installErr) {
+    console.error('\n❌ 安装失败，请手动执行：npm install -g tsx\n');
+    process.exit(1);
+  }
+}

package/src/app.ts

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

package/src/config/manager.ts

@@ -0,0 +1,172 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, statSync } from 'fs';
+import { dirname, join, resolve, isAbsolute } from 'path';
+import { homedir } from 'os';
+import type { GlobalConfig, ProjectConfig } from './schema.js';
+
+/** 项目级配置文件名 */
+export const PROJECT_CONFIG_FILE = 'deploy.config.json';
+
+/** 扫描时忽略的目录名 */
+const SCAN_IGNORE_DIRS = new Set([
+  'node_modules',
+  '.git',
+  'dist',
+  'build',
+  'target',
+  '.next',
+  'coverage',
+  '.cache',
+]);
+
+/** 扫描深度上限 */
+const SCAN_MAX_DEPTH = 5;
+
+/** 默认全局配置 */
+const defaultGlobalConfig: GlobalConfig = {
+  servers: {},
+};
+
+/** 全局配置目录与文件路径 */
+const CONFIG_DIR = join(homedir(), '.mindbase');
+const CONFIG_PATH = join(CONFIG_DIR, 'deploy.json');
+
+/**
+ * 确保配置目录存在
+ */
+function ensureConfigDir(): void {
+  if (!existsSync(CONFIG_DIR)) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+}
+
+/**
+ * 读取全局配置（servers）
+ */
+export function getConfig(): GlobalConfig {
+  if (!existsSync(CONFIG_PATH)) {
+    ensureConfigDir();
+    writeFileSync(CONFIG_PATH, JSON.stringify(defaultGlobalConfig, null, 2), 'utf-8');
+    return structuredClone(defaultGlobalConfig);
+  }
+
+  try {
+    const content = readFileSync(CONFIG_PATH, 'utf-8');
+    const parsed = JSON.parse(content);
+    return { servers: parsed.servers ?? {} };
+  } catch {
+    return structuredClone(defaultGlobalConfig);
+  }
+}
+
+/**
+ * 写入全局配置
+ */
+export function setConfig(config: GlobalConfig): void {
+  ensureConfigDir();
+  writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2), 'utf-8');
+}
+
+/**
+ * 获取全局配置文件路径
+ */
+export function getConfigPath(): string {
+  return CONFIG_PATH;
+}
+
+/**
+ * 解析配置文件实际路径：目录 → 拼 deploy.config.json；文件 → 直接用
+ */
+function resolveConfigFilePath(targetPath?: string): string {
+  const cwd = targetPath ?? process.cwd();
+  const abs = isAbsolute(cwd) ? cwd : resolve(process.cwd(), cwd);
+  const stat = existsSync(abs) ? statSync(abs) : null;
+  if (stat && stat.isFile()) return abs;
+  return join(abs, PROJECT_CONFIG_FILE);
+}
+
+/**
+ * 解析 localDir 为绝对路径（相对配置文件所在目录）
+ */
+function resolveLocalDir(localDir: string, configFilePath: string): string {
+  if (isAbsolute(localDir)) return localDir;
+  return resolve(dirname(configFilePath), localDir);
+}
+
+/**
+ * 加载项目级配置
+ * @param targetPath 目录或文件路径，缺省为 cwd
+ */
+export function loadProjectConfig(targetPath?: string): ProjectConfig {
+  const configFilePath = resolveConfigFilePath(targetPath);
+  if (!existsSync(configFilePath)) {
+    throw new Error(`项目配置文件不存在: ${configFilePath}`);
+  }
+
+  const raw = readFileSync(configFilePath, 'utf-8');
+  const parsed = JSON.parse(raw) as ProjectConfig;
+  parsed.localDir = resolveLocalDir(parsed.localDir ?? '.', configFilePath);
+  return parsed;
+}
+
+/**
+ * 写入项目级配置
+ * @param config 项目配置
+ * @param targetPath 目录或文件路径，缺省为 cwd
+ */
+export function saveProjectConfig(config: ProjectConfig, targetPath?: string): void {
+  const configFilePath = resolveConfigFilePath(targetPath);
+  mkdirSync(dirname(configFilePath), { recursive: true });
+  writeFileSync(configFilePath, JSON.stringify(config, null, 2), 'utf-8');
+}
+
+/** 发现结果 */
+export interface DiscoveredProject {
+  /** 配置文件绝对路径 */
+  path: string;
+  /** 已解析的 ProjectConfig */
+  config: ProjectConfig;
+}
+
+/**
+ * 扫描 rootPath 下所有 deploy.config.json
+ */
+export function discoverProjectConfigs(rootPath?: string): DiscoveredProject[] {
+  const root = rootPath ?? process.cwd();
+  const results: DiscoveredProject[] = [];
+
+  function walk(dir: string, depth: number): void {
+    if (depth > SCAN_MAX_DEPTH) return;
+
+    let entries;
+    try {
+      entries = readdirSync(dir);
+    } catch {
+      return;
+    }
+
+    for (const entry of entries) {
+      if (SCAN_IGNORE_DIRS.has(entry)) continue;
+      const full = join(dir, entry);
+      let stat;
+      try {
+        stat = statSync(full);
+      } catch {
+        continue;
+      }
+
+      if (stat.isDirectory()) {
+        walk(full, depth + 1);
+      } else if (entry === PROJECT_CONFIG_FILE) {
+        try {
+          const config = loadProjectConfig(full);
+          results.push({ path: full, config });
+        } catch {
+          /* 跳过损坏的配置文件 */
+        }
+      }
+    }
+  }
+
+  walk(root, 0);
+  return results;
+}

package/src/config/schema.ts

@@ -0,0 +1,100 @@
+/** 步骤类型 */
+export type StepType = 'log' | 'local' | 'remote' | 'uploadDir' | 'uploadFile' | 'downloadDir' | 'downloadFile';
+
+/** 基础步骤 */
+interface StepBase {
+  type: StepType;
+}
+
+/** 日志步骤 */
+export interface LogStep extends StepBase {
+  type: 'log';
+  message: string;
+}
+
+/** 本地命令步骤 */
+export interface LocalStep extends StepBase {
+  type: 'local';
+  cmd: string;
+  cwd?: string;
+}
+
+/** 远程命令步骤 */
+export interface RemoteStep extends StepBase {
+  type: 'remote';
+  cmd: string;
+}
+
+/** 上传目录步骤 */
+export interface UploadDirStep extends StepBase {
+  type: 'uploadDir';
+  local: string;
+  remote: string;
+}
+
+/** 上传文件步骤 */
+export interface UploadFileStep extends StepBase {
+  type: 'uploadFile';
+  local: string;
+  remote: string;
+}
+
+/** 下载目录步骤（备份） */
+export interface DownloadDirStep extends StepBase {
+  type: 'downloadDir';
+  remote: string;
+  local: string;
+}
+
+/** 下载文件步骤（备份） */
+export interface DownloadFileStep extends StepBase {
+  type: 'downloadFile';
+  remote: string;
+  local: string;
+}
+
+/** 所有步骤类型联合 */
+export type Step = LogStep | LocalStep | RemoteStep | UploadDirStep | UploadFileStep | DownloadDirStep | DownloadFileStep;
+
+/** 服务器配置 - 密码认证 */
+export interface PasswordServerConfig {
+  host: string;
+  port: number;
+  username: string;
+  password: string;
+  privateKeyPath?: never;
+  passphrase?: never;
+}
+
+/** 服务器配置 - 私钥认证 */
+export interface PrivateKeyServerConfig {
+  host: string;
+  port: number;
+  username: string;
+  password?: never;
+  privateKeyPath: string;
+  passphrase?: string;
+}
+
+/** 服务器配置 */
+export type ServerConfig = PasswordServerConfig | PrivateKeyServerConfig;
+
+/** 项目配置（项目级 deploy.config.json） */
+export interface ProjectConfig {
+  /** 项目显示名称 */
+  name: string;
+  /** 本地目录（绝对路径或相对配置文件的路径，加载时解析为绝对路径） */
+  localDir: string;
+  /** 目标服务器 ID（引用全局 servers） */
+  server: string;
+  /** 远端目录 */
+  remoteDir: string;
+  /** 部署步骤 */
+  steps: Step[];
+}
+
+/** 全局配置结构（~/.mindbase/deploy.json） */
+export interface GlobalConfig {
+  /** 服务器列表 */
+  servers: Record<string, ServerConfig>;
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export { runApp, runProject, showConfig } from './app.js';
+export { runInit } from './init/app.js';