@ranger1/dx 0.1.0

package/lib/cli/commands/core.js

@@ -0,0 +1,233 @@
+import { logger } from '../../logger.js'
+import { confirmManager } from '../../confirm.js'
+import { execManager } from '../../exec.js'
+import { showHelp, showCommandHelp } from '../help.js'
+
+export function handleHelp(cli, args = []) {
+  void cli
+  if (args[0]) showCommandHelp(args[0])
+  else showHelp()
+}
+
+export function handleDev(cli, args = []) {
+  return cli.reportDevCommandRemoved(args)
+}
+
+export async function handleBuild(cli, args) {
+  const target = args[0] || 'all'
+  const environment = cli.determineEnvironment()
+  const envKey = cli.normalizeEnvKey(environment)
+
+  const buildConfig = cli.commands.build[target]
+  if (!buildConfig) {
+    // 兼容用户误输入或快捷命令，把 "all./scripts/dx" 这类粘连错误拆分
+    const fixed = String(target).split(/\s|\t|\r|\n|\u00A0|\.|\//)[0]
+    if (fixed && cli.commands.build[fixed]) {
+      logger.warn(`自动修正构建目标: ${target} -> ${fixed}`)
+      return await handleBuild(cli, [fixed])
+    }
+    logger.error(`未找到构建目标: ${target}`)
+    process.exitCode = 1
+    return
+  }
+
+  logger.step(`构建 ${target} (${environment})`)
+
+  // 处理嵌套配置
+  let config = buildConfig
+  if (typeof config === 'object' && !config.command) {
+    // 如果是嵌套配置，尝试获取环境特定的配置（兼容 dev/prod 与 development/production 命名）
+    if (config[envKey]) config = config[envKey]
+    else if (envKey === 'staging' && config.prod) config = config.prod
+    else config = config.dev || config
+  }
+
+  if (config.concurrent) {
+    await cli.handleConcurrentCommands(config.commands, 'build', envKey)
+  } else if (config.sequential) {
+    await cli.handleSequentialCommands(config.commands, envKey)
+  } else {
+    await cli.executeCommand(config)
+  }
+}
+
+export async function handleTest(cli, args) {
+  const type = args[0] || 'e2e'
+  const target = args[1] || 'all'
+  const testPath = args[2] // 可选的测试文件路径
+
+  // 解析 -t 参数用于指定特定测试用例（使用原始参数列表）
+  const allArgs = cli.args  // 使用原始参数列表包含所有标志
+  const testNamePatternIndex = allArgs.indexOf('-t')
+  let testNamePattern = null
+  if (testNamePatternIndex !== -1 && testNamePatternIndex + 1 < allArgs.length) {
+    testNamePattern = allArgs[testNamePatternIndex + 1]
+  }
+
+  // 根据测试类型自动设置环境标志
+  if (type === 'e2e' && !cli.flags.e2e) {
+    cli.flags.e2e = true
+  } else if (type === 'unit' && !cli.flags.test) {
+    cli.flags.test = true
+  }
+
+  let testConfig = cli.commands.test[type]?.[target] || cli.commands.test[type]
+
+  if (!testConfig) {
+    logger.error(`未找到测试配置: ${type}.${target}`)
+    process.exitCode = 1
+    return
+  }
+
+  // 如果提供了测试文件路径，使用专门的单文件测试配置
+  if (testPath && type === 'e2e' && target === 'backend') {
+    let command = `pnpm --filter ./apps/backend run test:e2e:file ${testPath}`
+
+    // 如果指定了测试用例名称，添加 -t 参数
+    if (testNamePattern) {
+      const escapedPattern = String(testNamePattern).replace(/(["`\\$])/g, '\\$1')
+      command += ` -t "${escapedPattern}"`
+    }
+
+    testConfig = {
+      ...testConfig,
+      command: command,
+      description: testNamePattern
+        ? `运行单个E2E测试文件的特定用例: ${testPath} -> ${testNamePattern}`
+        : `运行单个E2E测试文件: ${testPath}`
+    }
+
+    if (testNamePattern) {
+      logger.step(`运行 ${type} 测试用例: ${testNamePattern} (文件: ${testPath})`)
+    } else {
+      logger.step(`运行单个 ${type} 测试: ${testPath}`)
+    }
+  } else {
+    logger.step(`运行 ${type} 测试`)
+  }
+
+  await cli.executeCommand(testConfig)
+}
+
+export async function handleLint(cli, args) {
+  void args
+  const baseConfig = cli.commands.lint
+  if (!baseConfig || !baseConfig.command) {
+    logger.error('未找到 lint 命令配置')
+    process.exitCode = 1
+    return
+  }
+
+  const config = { ...baseConfig }
+
+  if (cli.flags.fix) {
+    logger.step('运行代码检查（自动修复模式: --fix）')
+    const cmd = String(config.command)
+    // 若已包含 ` -- ` 分隔符，直接在末尾追加 --fix；否则通过 `--` 传递给 Nx 下游
+    config.command = cmd.includes(' -- ')
+      ? `${cmd} --fix`
+      : `${cmd} -- --fix`
+  } else {
+    logger.step('运行代码检查')
+  }
+
+  await cli.executeCommand(config)
+}
+
+export async function handleClean(cli, args) {
+  const target = args[0] || 'all'
+  const cleanConfig = cli.commands.clean[target]
+
+  if (!cleanConfig) {
+    logger.error(`未找到清理目标: ${target}`)
+    process.exitCode = 1
+    return
+  }
+
+  // 危险操作确认
+  if (cleanConfig.dangerous) {
+    const confirmed = await confirmManager.confirmDangerous(
+      `清理操作: ${target}`,
+      '当前环境',
+      cli.flags.Y
+    )
+
+    if (!confirmed) {
+      logger.info('操作已取消')
+      return
+    }
+  }
+
+  logger.step(`清理 ${target}`)
+  await cli.executeCommand(cleanConfig)
+}
+
+export async function handleCache(cli, args) {
+  const action = args[0] || 'clear'
+  const cacheConfig = cli.commands.cache?.[action]
+
+  if (!cacheConfig) {
+    logger.error(`未找到缓存操作: ${action}`)
+    logger.info('用法: dx cache clear')
+    process.exitCode = 1
+    return
+  }
+
+  // 危险操作确认
+  if (cacheConfig.dangerous) {
+    const confirmed = await confirmManager.confirmDangerous(
+      `缓存清理: ${action}`,
+      '当前环境',
+      cli.flags.Y
+    )
+
+    if (!confirmed) {
+      logger.info('操作已取消')
+      return
+    }
+
+    // 二次确认（更醒目）：强调将清理全局 pnpm store 与 ~/.pnpm-store
+    if (!cli.flags.Y && action === 'clear') {
+      const second = await confirmManager.confirm(
+        '二次确认：将清理全局 pnpm store 与 ~/.pnpm-store，可能影响其他项目，是否继续？',
+        false,
+        false
+      )
+      if (!second) {
+        logger.info('操作已取消')
+        return
+      }
+    }
+  }
+
+  logger.step(`执行缓存操作: ${action}`)
+  await cli.executeCommand(cacheConfig)
+}
+
+export async function handleInstall(cli, args) {
+  void args
+  const installConfig = cli.commands.install
+  if (!installConfig) {
+    logger.error('未找到 install 命令配置')
+    process.exitCode = 1
+    return
+  }
+
+  logger.step('安装依赖')
+  await cli.executeCommand(installConfig)
+}
+
+export async function handleStatus(cli, args) {
+  void args
+  logger.step('系统状态')
+
+  const status = execManager.getStatus()
+  console.log(`运行中的进程: ${status.runningProcesses}`)
+
+  if (status.processes.length > 0) {
+    logger.table(
+      status.processes.map(p => [p.id, p.command, `${Math.round(p.duration/1000)}s`]),
+      ['进程ID', '命令', '运行时长']
+    )
+  }
+}

package/lib/cli/commands/db.js

@@ -0,0 +1,239 @@
+import { logger } from '../../logger.js'
+import { confirmManager } from '../../confirm.js'
+import { envManager } from '../../env.js'
+import { getPassthroughArgs } from '../args.js'
+
+export async function handleDatabase(cli, args) {
+  const action = args[0]
+  if (!action) {
+    logger.error('请指定数据库操作: generate, migrate, deploy, reset, seed, format, script')
+    process.exitCode = 1
+    return
+  }
+
+  const dbConfig = cli.commands.db[action]
+  if (!dbConfig) {
+    logger.error(`未找到数据库操作: ${action}`)
+    process.exitCode = 1
+    return
+  }
+
+  const environment = cli.determineEnvironment()
+  const envKey = cli.normalizeEnvKey(environment)
+
+  // 兼容旧用法：非 dev 环境使用 migrate 时给出明确提示，推荐改用 deploy
+  if (action === 'migrate' && envKey && envKey !== 'dev') {
+    const envFlag = cli.getEnvironmentFlagExample(envKey) || `--${envKey}`
+    logger.warn(`检测到在非开发环境执行 migrate: ${environment || envKey}`)
+    logger.info('建议仅在开发环境使用 `dx db migrate --dev --name <migration-name>` 创建迁移。')
+    logger.info(`如需在当前环境应用已有迁移，请使用: ${cli.invocation} db deploy ${envFlag}`)
+  }
+
+  // 处理 script 子命令
+  if (action === 'script') {
+    const scriptName = args[1]
+    if (!scriptName) {
+      logger.error('请指定要运行的脚本名称')
+      logger.info('用法: dx db script <script-name> [环境标志]')
+      logger.info('示例: dx db script fix-email-verified-status --dev')
+      process.exitCode = 1
+      return
+    }
+    return await handleDatabaseScript(cli, scriptName, envKey, dbConfig)
+  }
+
+  logger.step(`执行数据库操作: ${action} (${environment})`)
+
+  // 处理嵌套配置
+  let config = dbConfig
+  if (typeof config === 'object' && !config.command) {
+    // 如果是嵌套配置，尝试获取环境特定的配置（兼容 dev/prod 与 development/production 命名）
+    if (config[envKey]) config = config[envKey]
+    else if (envKey === 'staging' && config.prod) config = config.prod
+    else config = config.dev || config
+  }
+
+  // 危险操作确认
+  if (config.dangerous) {
+    const confirmed = await confirmManager.confirmDatabaseOperation(
+      action,
+      envManager.getEnvironmentDescription(environment),
+      cli.flags.Y,
+    )
+
+    if (!confirmed) {
+      logger.info('操作已取消')
+      return
+    }
+  }
+
+  // 支持为 migrate 传入迁移名：--name/-n
+  let command = config.command
+  if (action === 'migrate' && envKey === 'dev') {
+    const allArgs = cli.args
+    let migrationName = null
+    // 优先解析显式标志 --name/-n
+    const nameIdx = allArgs.indexOf('--name')
+    const shortIdx = allArgs.indexOf('-n')
+    if (nameIdx !== -1 && nameIdx + 1 < allArgs.length) {
+      migrationName = allArgs[nameIdx + 1]
+    } else if (shortIdx !== -1 && shortIdx + 1 < allArgs.length) {
+      migrationName = allArgs[shortIdx + 1]
+    }
+
+    if (!migrationName) {
+      logger.error('开发环境执行 migrate 时必须通过 --name 或 -n 指定迁移名称（禁止位置参数）')
+      logger.info('原因: 缺少迁移名会进入 Prisma 的交互式输入流程，脚本将被阻塞。')
+      logger.info(`正确示例: ${cli.invocation} db migrate --dev --name init-user-table`)
+      logger.info(`如仅需应用已有迁移，请使用 ${cli.invocation} db deploy --dev。`)
+      logger.info(`提示: 执行 ${cli.invocation} help db 查看完整用法与更多示例。`)
+      process.exitCode = 1
+      return
+    }
+
+    const escaped = String(migrationName).replace(/(["`\\$])/g, '\\$1')
+    // 将参数传递给 Nx 下游 prisma：需要通过 -- 分割
+    command = `${command} -- --name "${escaped}"`
+    logger.info(`使用迁移名: ${migrationName}`)
+  }
+
+  // 对以下数据库操作固定禁用 Nx 缓存，避免命中缓存导致未实际执行：generate/migrate/deploy/reset/seed
+  const disableCacheActions = new Set(['generate', 'migrate', 'deploy', 'reset', 'seed'])
+  const extraEnv = disableCacheActions.has(action) ? { NX_CACHE: 'false' } : {}
+  if (disableCacheActions.has(action)) {
+    logger.info('为数据库操作禁用 Nx 缓存: NX_CACHE=false')
+    // 为每个子命令注入 --skip-nx-cache（支持 && || ; 拼接的多命令）
+    command = command
+      .split(/(\s*&&\s*|\s*\|\|\s*|\s*;\s*)/)
+      .map(part => {
+        // 保留分隔符原样
+        if (/^(\s*&&\s*|\s*\|\|\s*|\s*;\s*)$/.test(part)) return part
+        // 跳过空字符串
+        if (!part.trim()) return part
+        // 只对 npx nx 命令注入
+        if (!part.includes('npx nx')) return part
+        // 在 -- 之前插入，或追加到末尾
+        if (part.includes(' -- ')) {
+          return part.replace(' -- ', ' --skip-nx-cache -- ')
+        }
+        return `${part} --skip-nx-cache`
+      })
+      .join('')
+  }
+
+  if (action === 'reset' && envKey !== 'prod') {
+    extraEnv.PRISMA_USER_CONSENT_FOR_DANGEROUS_AI_ACTION = 'yes'
+    logger.info('非生产环境重置数据库，已自动确认危险操作: PRISMA_USER_CONSENT_FOR_DANGEROUS_AI_ACTION=yes')
+  }
+
+  const execFlags = { ...cli.flags }
+  ;['dev', 'development', 'prod', 'production', 'test', 'e2e', 'staging', 'stage'].forEach(
+    key => delete execFlags[key],
+  )
+  if (envKey === 'prod') execFlags.prod = true
+  else if (envKey === 'dev') execFlags.dev = true
+  else if (envKey === 'test') execFlags.test = true
+  else if (envKey === 'e2e') execFlags.e2e = true
+  else if (envKey === 'staging') execFlags.staging = true
+
+  await cli.executeCommand(
+    { ...config, command, env: { ...(config.env || {}), ...extraEnv } },
+    execFlags,
+  )
+}
+
+export async function handleDatabaseScript(cli, scriptName, envKey, dbConfig) {
+  // 自动去除 .ts 扩展名（如果用户提供了）
+  const cleanScriptName = scriptName.endsWith('.ts') ? scriptName.slice(0, -3) : scriptName
+
+  // 基础路径校验，避免路径遍历
+  if (
+    cleanScriptName.includes('/') ||
+    cleanScriptName.includes('\\') ||
+    cleanScriptName.includes('..')
+  ) {
+    logger.error(`脚本名称不能包含路径分隔符或父目录引用: ${cleanScriptName}`)
+    process.exitCode = 1
+    return
+  }
+
+  const { existsSync } = await import('fs')
+  const { join, resolve, relative } = await import('path')
+  const scriptsRoot = join(process.cwd(), 'apps/backend/prisma/scripts')
+  const scriptPath = resolve(scriptsRoot, `${cleanScriptName}.ts`)
+
+  if (relative(scriptsRoot, scriptPath).startsWith('..')) {
+    logger.error(`脚本路径解析结果已超出允许目录: ${scriptPath}`)
+    process.exitCode = 1
+    return
+  }
+
+  if (!existsSync(scriptPath)) {
+    logger.error(`脚本文件不存在: ${scriptPath}`)
+    logger.info('可用的脚本文件位于: apps/backend/prisma/scripts/')
+    process.exitCode = 1
+    return
+  }
+
+  const environment = envKey === 'dev' ? 'development' : envKey === 'prod' ? 'production' : envKey
+  logger.step(`执行数据库脚本: ${cleanScriptName} (${environment})`)
+  logger.info(`脚本路径: ${scriptPath}`)
+
+  // 处理嵌套配置
+  let config = dbConfig
+  if (typeof config === 'object' && !config.command) {
+    if (config[envKey]) config = config[envKey]
+    else if (envKey === 'staging' && config.prod) config = config.prod
+    else config = config.dev || config
+  }
+
+  // 危险操作确认
+  if (config.dangerous && envKey === 'prod') {
+    const confirmed = await confirmManager.confirmDatabaseOperation(
+      `script: ${cleanScriptName}`,
+      envManager.getEnvironmentDescription(environment),
+      cli.flags.Y,
+    )
+
+    if (!confirmed) {
+      logger.info('操作已取消')
+      return
+    }
+  }
+
+  // 替换命令中的脚本名称占位符
+  let command = config.command.replace('{SCRIPT_NAME}', cleanScriptName)
+
+  // 获取 -- 后面的 passthrough 参数并追加到命令
+  const passthroughArgs = getPassthroughArgs(cli.args)
+  if (passthroughArgs.length > 0) {
+    const escapedArgs = passthroughArgs.map(arg => {
+      // 对包含空格或特殊字符的参数加引号
+      if (/[\s"'`$\\]/.test(arg)) {
+        return `"${arg.replace(/(["`\\$])/g, '\\$1')}"`
+      }
+      return arg
+    })
+    command = `${command} ${escapedArgs.join(' ')}`
+    logger.info(`传递给脚本的参数: ${passthroughArgs.join(' ')}`)
+  }
+
+  // 为脚本执行禁用 Nx 缓存
+  const extraEnv = { NX_CACHE: 'false' }
+  logger.info('为数据库脚本禁用 Nx 缓存: NX_CACHE=false')
+
+  const execFlags = { ...cli.flags }
+  ;['dev', 'development', 'prod', 'production', 'test', 'e2e', 'staging', 'stage'].forEach(
+    key => delete execFlags[key],
+  )
+  if (envKey === 'prod') execFlags.prod = true
+  else if (envKey === 'dev') execFlags.dev = true
+  else if (envKey === 'test') execFlags.test = true
+  else if (envKey === 'e2e') execFlags.e2e = true
+  else if (envKey === 'staging') execFlags.staging = true
+
+  await cli.executeCommand(
+    { ...config, command, env: { ...(config.env || {}), ...extraEnv } },
+    execFlags,
+  )
+}

package/lib/cli/commands/deploy.js

@@ -0,0 +1,76 @@
+import { logger } from '../../logger.js'
+import { envManager } from '../../env.js'
+import { validateEnvironment } from '../../validate-env.js'
+
+export async function handleDeploy(cli, args) {
+  const target = args[0]
+  if (!target) {
+    logger.error('请指定部署目标: front, admin, all')
+    logger.info(`用法: ${cli.invocation} deploy <target> [环境标志]`)
+    logger.info(`示例: ${cli.invocation} deploy front --staging`)
+    process.exitCode = 1
+    return
+  }
+
+  const normalizedTarget = String(target).toLowerCase()
+  const deployTargets = Object.keys(cli.commands.deploy || {})
+  if (!cli.commands.deploy?.[normalizedTarget]) {
+    logger.error(`未找到部署目标: ${target}`)
+    if (deployTargets.length > 0) {
+      logger.info(`可用目标: ${deployTargets.join(', ')}`)
+    }
+    logger.info(`用法: ${cli.invocation} deploy <target> [环境标志]`)
+    process.exitCode = 1
+    return
+  }
+
+  if (cli.flags.test || cli.flags.e2e) {
+    logger.error('deploy 命令仅支持 --dev/--staging/--prod 环境标志')
+    process.exitCode = 1
+    return
+  }
+
+  const selectedEnvs = []
+  if (cli.flags.dev) selectedEnvs.push('development')
+  if (cli.flags.staging) selectedEnvs.push('staging')
+  if (cli.flags.prod) selectedEnvs.push('production')
+
+  if (selectedEnvs.length > 1) {
+    logger.error('deploy 命令不支持同时传入多个环境标志')
+    logger.info('请使用 --dev、--staging 或 --prod 中的一个')
+    process.exitCode = 1
+    return
+  }
+
+  const environment = selectedEnvs[0] || 'staging'
+
+  cli.ensureRepoRoot()
+
+  // 只执行基础环境校验（检查 .env 文件结构），跳过后端环境变量校验
+  // Vercel 部署所需的环境变量由 vercel-deploy.js 自行校验
+  try {
+    validateEnvironment()
+  } catch (error) {
+    logger.error(error.message)
+    process.exitCode = 1
+    return
+  }
+
+  // 加载环境变量层，但不校验后端必需变量
+  const layeredEnv = envManager.collectEnvFromLayers(null, environment)
+  if (envManager.latestEnvWarnings && envManager.latestEnvWarnings.length > 0) {
+    envManager.latestEnvWarnings.forEach(message => logger.warn(message))
+  }
+
+  // 仅在目标变量不存在或是占位符时才使用 .env 文件的值
+  for (const [key, value] of Object.entries(layeredEnv)) {
+    const currentValue = process.env[key]
+    if (!currentValue || envManager.isPlaceholderEnvValue(currentValue)) {
+      process.env[key] = value
+    }
+  }
+  envManager.syncEnvironments(environment)
+
+  const { deployToVercel } = await import('../../vercel-deploy.js')
+  await deployToVercel(normalizedTarget, { environment })
+}

package/lib/cli/commands/export.js

@@ -0,0 +1,34 @@
+import { logger } from '../../logger.js'
+
+export async function handleExport(cli, args) {
+  const target = args[0]
+  if (!target) {
+    logger.error('请指定导出目标')
+    logger.info(`用法: ${cli.invocation} export <target> [环境标志]`)
+    process.exitCode = 1
+    return
+  }
+
+  const exportConfig = cli.commands.export?.[target]
+  if (!exportConfig) {
+    const targets = Object.keys(cli.commands.export || {})
+    logger.error(`未找到导出目标: ${target}`)
+    if (targets.length > 0) {
+      logger.info(`可用目标: ${targets.join(', ')}`)
+    }
+    process.exitCode = 1
+    return
+  }
+
+  const environment = cli.determineEnvironment()
+  const envKey = cli.normalizeEnvKey(environment)
+  let config = exportConfig
+  if (typeof config === 'object' && !config.command) {
+    if (config[envKey]) config = config[envKey]
+    else if (envKey === 'staging' && config.prod) config = config.prod
+    else config = config.dev || config
+  }
+
+  logger.step(`导出 ${target} (${environment})`)
+  await cli.executeCommand(config)
+}

package/lib/cli/commands/package.js

@@ -0,0 +1,22 @@
+import { logger } from '../../logger.js'
+
+export async function handlePackage(cli, args) {
+  const target = args[0] || 'backend'
+  if (target !== 'backend') {
+    logger.error(`暂不支持打包目标: ${target}`)
+    logger.info(`当前仅支持 ${cli.invocation} package backend`)
+    process.exitCode = 1
+    return
+  }
+
+  cli.ensureRepoRoot()
+
+  const environment = cli.determineEnvironment()
+  const passthroughFlags = cli.args.filter(token =>
+    ['--skip-build', '--keep-workdir'].includes(token),
+  )
+
+  logger.step(`打包 ${target} (${environment})`)
+  const { runBackendPackage } = await import('../../backend-package.js')
+  await runBackendPackage([`--env=${environment}`, ...passthroughFlags])
+}