@ranger1/dx 0.1.0

package/lib/logger.js

@@ -0,0 +1,188 @@
+import { writeFileSync, mkdirSync } from 'node:fs'
+import { join } from 'node:path'
+
+function resolveProjectRoot() {
+  return process.env.DX_PROJECT_ROOT || process.cwd()
+}
+
+// 处理输出管道被关闭导致的 EPIPE 错误，避免进程在清理阶段崩溃
+try {
+  const handleBrokenPipe = err => {
+    if (err && (err.code === 'EPIPE' || err.code === 'ERR_STREAM_WRITE_AFTER_END')) {
+      // 静默忽略，允许进程优雅退出
+      try {
+        /* noop */
+      } catch {}
+    }
+  }
+  if (process?.stdout?.on) process.stdout.on('error', handleBrokenPipe)
+  if (process?.stderr?.on) process.stderr.on('error', handleBrokenPipe)
+} catch {
+  /* 安全保护，忽略环境不支持的情况 */
+}
+
+export class Logger {
+  constructor(options = {}) {
+    this.logLevel = options.level || 'info'
+    this.enableFile = options.enableFile || false
+    this.logDir = options.logDir || join(resolveProjectRoot(), 'dx', 'logs')
+
+    if (this.enableFile) {
+      this.ensureLogDir()
+    }
+  }
+
+  // 确保日志目录存在
+  ensureLogDir() {
+    try {
+      mkdirSync(this.logDir, { recursive: true })
+    } catch (error) {
+      // 目录可能已存在，忽略错误
+    }
+  }
+
+  // 格式化时间戳
+  formatTimestamp() {
+    return new Date().toLocaleString('zh-CN')
+  }
+
+  // 基础日志方法
+  info(message, prefix = '🚀') {
+    const output = `${prefix} ${message}`
+    console.log(output)
+    this.writeLog('info', message)
+  }
+
+  success(message) {
+    const output = `✅ ${message}`
+    console.log(output)
+    this.writeLog('success', message)
+  }
+
+  warn(message) {
+    const output = `⚠️  ${message}`
+    console.log(output)
+    this.writeLog('warn', message)
+  }
+
+  error(message) {
+    const output = `❌ ${message}`
+    console.log(output)
+    this.writeLog('error', message)
+  }
+
+  debug(message) {
+    if (this.logLevel === 'debug') {
+      const output = `🐛 ${message}`
+      console.log(output)
+      this.writeLog('debug', message)
+    }
+  }
+
+  // 步骤显示
+  step(message, stepNumber = null) {
+    const prefix = stepNumber ? `步骤 ${stepNumber}:` : '执行:'
+    const separator = '=================================='
+
+    console.log(`\n${separator}`)
+    console.log(`🚀 ${prefix} ${message}`)
+    console.log(separator)
+
+    this.writeLog('step', `${prefix} ${message}`)
+  }
+
+  // 进度显示
+  progress(message) {
+    process.stdout.write(`⌛ ${message}...`)
+    this.writeLog('progress', `开始: ${message}`)
+  }
+
+  progressDone() {
+    console.log(' 完成')
+    this.writeLog('progress', '完成')
+  }
+
+  // 命令执行日志
+  command(command) {
+    console.log(`💻 执行: ${command}`)
+    this.writeLog('command', command)
+  }
+
+  // 分隔符
+  separator() {
+    console.log(`\n${'='.repeat(50)}`)
+  }
+
+  // 表格显示
+  table(data, headers = []) {
+    if (data.length === 0) return
+
+    if (headers.length > 0) {
+      console.log(`\n${headers.join('\t')}`)
+      console.log('-'.repeat(headers.join('\t').length))
+    }
+
+    data.forEach(row => {
+      if (Array.isArray(row)) {
+        console.log(row.join('\t'))
+      } else {
+        console.log(row)
+      }
+    })
+    console.log()
+  }
+
+  // 端口信息显示
+  ports(portInfo) {
+    console.log('\n📡 服务端口信息:')
+    portInfo.forEach(({ service, port, url }) => {
+      console.log(`  ${service}: http://localhost:${port} ${url ? `(${url})` : ''}`)
+    })
+    console.log()
+  }
+
+  // 写入日志文件
+  writeLog(level, message) {
+    if (!this.enableFile) return
+
+    try {
+      const timestamp = this.formatTimestamp()
+      const logLine = `[${timestamp}] [${level.toUpperCase()}] ${message}\n`
+
+      const logFile = join(this.logDir, `ai-cli-${new Date().toISOString().split('T')[0]}.log`)
+      writeFileSync(logFile, logLine, { flag: 'a', encoding: 'utf8' })
+    } catch (error) {
+      // 写入日志失败时静默处理，避免影响主流程
+    }
+  }
+
+  // 创建子日志器
+  createChild(prefix) {
+    const childLogger = new Logger({
+      level: this.logLevel,
+      enableFile: this.enableFile,
+      logDir: this.logDir,
+    })
+
+    // 重写方法以添加前缀
+    const originalMethods = ['info', 'success', 'warn', 'error', 'debug']
+    originalMethods.forEach(method => {
+      const originalMethod = childLogger[method].bind(childLogger)
+      childLogger[method] = (message, customPrefix) => {
+        const finalPrefix = customPrefix || prefix
+        originalMethod(message, finalPrefix)
+      }
+    })
+
+    return childLogger
+  }
+}
+
+// 导出默认实例
+export const logger = new Logger()
+
+// 导出带文件日志的实例
+export const fileLogger = new Logger({ enableFile: true })
+
+// 导出调试日志实例
+export const debugLogger = new Logger({ level: 'debug', enableFile: true })

package/lib/run-with-version-env.js

@@ -0,0 +1,173 @@
+#!/usr/bin/env node
+
+import { spawn, execSync } from 'node:child_process'
+import { readFile } from 'node:fs/promises'
+import { resolve, join, dirname } from 'node:path'
+import { existsSync } from 'node:fs'
+
+const allowedApps = ['backend', 'front', 'admin']
+
+function findWorkspaceRoot(startDir) {
+  let current = resolve(startDir)
+  while (true) {
+    if (existsSync(join(current, 'dx', 'config', 'commands.json'))) return current
+    if (existsSync(join(current, 'pnpm-workspace.yaml'))) return current
+    const parent = dirname(current)
+    if (parent === current) return startDir
+    current = parent
+  }
+}
+
+function parseArgs(argv) {
+  const args = [...argv]
+  let app = null
+  const extraEnv = {}
+  while (args.length > 0) {
+    const current = args.shift()
+    if (current === '--') {
+      return { app, command: args, extraEnv }
+    }
+    if ((current === '--app' || current === '-a') && args.length > 0) {
+      app = args.shift()
+      continue
+    }
+    if (current.startsWith('--set=')) {
+      const pair = current.slice('--set='.length)
+      const [key, ...rest] = pair.split('=')
+      extraEnv[key] = rest.join('=') ?? ''
+      continue
+    }
+    throw new Error(`无法识别的参数 ${current}`)
+  }
+  throw new Error('缺少命令分隔符 --')
+}
+
+async function readPackageVersion(app) {
+  const root = process.env.DX_PROJECT_ROOT || findWorkspaceRoot(process.cwd())
+  const appDirMap = {
+    backend: 'apps/backend/package.json',
+    front: 'apps/front/package.json',
+    admin: 'apps/admin-front/package.json',
+  }
+  const pkgPath = appDirMap[app]
+  if (!pkgPath) return '0.0.0'
+  const absPath = resolve(root, pkgPath)
+  try {
+    const raw = await readFile(absPath, 'utf8')
+    const pkg = JSON.parse(raw)
+    return typeof pkg.version === 'string' ? pkg.version : '0.0.0'
+  } catch (error) {
+    console.warn(`[with-version-env] 读取 ${pkgPath} 失败，使用默认版本 0.0.0`, error)
+    return '0.0.0'
+  }
+}
+
+function resolveGitSha() {
+  try {
+    const root = process.env.DX_PROJECT_ROOT || findWorkspaceRoot(process.cwd())
+    const sha = execSync('git rev-parse HEAD', { encoding: 'utf8', cwd: root }).trim()
+    return sha
+  } catch (error) {
+    console.warn('[with-version-env] 获取 Git SHA 失败，使用 unknown', error)
+    return 'unknown'
+  }
+}
+
+function buildEnv(app, baseEnv, extraEnv) {
+  const now = new Date().toISOString()
+  const gitSha = resolveGitSha()
+  const gitShort = gitSha && gitSha !== 'unknown' ? gitSha.slice(0, 7) : 'unknown'
+  const buildNumber =
+    process.env.BUILD_NUMBER || process.env.GITHUB_RUN_NUMBER || process.env.CI_PIPELINE_IID || ''
+
+  const result = { ...baseEnv, ...extraEnv }
+
+  const assign = (entries = []) => {
+    entries.forEach(([key, value]) => {
+      if (value !== undefined && value !== null) {
+        result[key] = String(value)
+      }
+    })
+  }
+
+  switch (app) {
+    case 'backend': {
+      const version = baseEnv.__APP_VERSION__
+      assign([
+        ['APP_VERSION', version],
+        ['APP_BUILD_VERSION', version],
+        ['GIT_SHA', gitSha],
+        ['GIT_SHORT_SHA', gitShort],
+        ['BUILD_GIT_SHA', gitSha],
+        ['BUILD_TIME', now],
+        ['BUILD_TIMESTAMP', now],
+        ['BUILD_NUMBER', buildNumber],
+      ])
+      break
+    }
+    case 'front': {
+      const version = baseEnv.__APP_VERSION__
+      assign([
+        ['NEXT_PUBLIC_APP_VERSION', version],
+        ['NEXT_PUBLIC_GIT_SHA', gitSha],
+        ['NEXT_PUBLIC_GIT_SHORT_SHA', gitShort],
+        ['NEXT_PUBLIC_BUILD_TIME', now],
+        ['NEXT_PUBLIC_BUILD_NUMBER', buildNumber],
+      ])
+      break
+    }
+    case 'admin': {
+      const version = baseEnv.__APP_VERSION__
+      assign([
+        ['VITE_APP_VERSION', version],
+        ['VITE_GIT_SHA', gitSha],
+        ['VITE_GIT_SHORT_SHA', gitShort],
+        ['VITE_BUILD_TIME', now],
+        ['VITE_BUILD_NUMBER', buildNumber],
+      ])
+      break
+    }
+    default:
+      break
+  }
+
+  delete result.__APP_VERSION__
+  return result
+}
+
+export async function runWithVersionEnv(argv = []) {
+  const { app, command, extraEnv } = parseArgs(Array.isArray(argv) ? argv : [])
+  if (!app || !allowedApps.includes(app)) {
+    throw new Error(`必须使用 --app 指定 ${allowedApps.join(', ')} 之一`)
+  }
+  if (!command || command.length === 0) {
+    throw new Error('缺少待执行命令')
+  }
+
+  const version = await readPackageVersion(app)
+  const env = buildEnv(app, { ...process.env, __APP_VERSION__: version }, extraEnv)
+
+  const child = spawn(command[0], command.slice(1), {
+    stdio: 'inherit',
+    env,
+    shell: false,
+  })
+
+  child.on('exit', code => {
+    process.exit(code ?? 0)
+  })
+
+  child.on('error', error => {
+    console.error('[with-version-env] 启动命令失败', error)
+    process.exit(1)
+  })
+}
+
+async function main() {
+  await runWithVersionEnv(process.argv.slice(2))
+}
+
+main().catch(error => {
+  console.error('[with-version-env] 执行失败:', error)
+  process.exit(1)
+})