wukong-gitlog-cli 1.0.38 → 1.0.40

package/src/index.mjs

@@ -1,658 +1,154 @@
-import chalk from 'chalk'
+#!/usr/bin/env node
 import { Command } from 'commander'
-import dayjs from 'dayjs'
-import isoWeek from 'dayjs/plugin/isoWeek.js'
-import fs from 'fs'
-import ora from 'ora'
-import path from 'path'
-import { fileURLToPath } from 'url'
-import { createProfiler } from 'wukong-profiler'
 
-import { parseOptions } from './cli/parseOptions.mjs'
-// eslint-disable-next-line no-unused-vars
-import { CLI_NAME } from './constants/index.mjs'
-import {
-  exportExcel,
-  exportExcelAuthorChangeStats,
-  exportExcelPerPeriodSheets
-} from './excel.mjs'
-import { getGitLogsFast } from './git.mjs'
-import { handleServe } from './handlers/handleServe.mjs'
-import { renderAuthorChangesJson } from './json.mjs'
-import { setConfig } from './lib/configStore.mjs'
-import { createOvertimeStats } from './overtime/createOvertimeStats.mjs'
-import {
-  renderOvertimeCsv,
-  renderOvertimeTab,
-  renderOvertimeText
-} from './overtime/overtime.mjs'
-import { renderAuthorMapText } from './renderAuthorMapText.mjs'
-import { startServer } from './server.mjs'
-import { renderChangedLinesText, renderText } from './text.mjs'
-import { checkUpdateWithPatch } from './utils/checkUpdate.mjs'
-import { handleSuccess } from './utils/handleSuccess.mjs'
-import {
-  groupRecords,
-  outputFilePath,
-  writeJSON,
-  writeTextFile
-} from './utils/index.mjs'
-import { logDev } from './utils/logDev.mjs'
-import { showVersionInfo } from './utils/showVersionInfo.mjs'
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url))
-
-const pkg = JSON.parse(
-  fs.readFileSync(path.resolve(__dirname, '../package.json'), 'utf8')
-)
-
-dayjs.extend(isoWeek)
-
-const PKG_NAME = pkg.name
-const VERSION = pkg.version
-
-let profiler
-
-const autoCheckUpdate = async () => {
-  // === CLI 主逻辑完成后提示更新 ===
-  await checkUpdateWithPatch({
-    pkg: {
-      name: PKG_NAME,
-      version: VERSION
-    },
-    force: true
-  })
-}
-
-const version = async () => {
-  showVersionInfo(VERSION)
-  await autoCheckUpdate()
-  process.exit(0)
-}
-
-/** 将 "2025-W48" → { start: '2025-11-24', end: '2025-11-30' } */
-export function getWeekRange(periodStr) {
-  // periodStr = "2025-W48"
-  const [year, w] = periodStr.split('-W')
-  const week = parseInt(w, 10)
+import { runGitPreflight, showGitInfo } from '#src/domain/git/index.mjs'
 
-  const start = dayjs().year(year).isoWeek(week).startOf('week') // Monday
-  const end = dayjs().year(year).isoWeek(week).endOf('week') // Sunday
-
-  return {
-    start: start.format('YYYY-MM-DD'),
-    end: end.format('YYYY-MM-DD')
-  }
-}
+import { analyzeAction } from './app/analyzeAction.mjs'
+import { exportAction } from './app/exportAction.mjs'
+// import { initAction } from './app/initAction.mjs'
+import { initActionWithTemp as initAction } from './app/initActionWithTemp.mjs'
+import { journalAction } from './app/journalAction.mjs'
+import { overtimeAction } from './app/overtimeAction.mjs'
+import { serveAction } from './app/serveAction.mjs'
+import { versionAction } from './app/versionAction.mjs'
+import {
+  addAnalysisOptions,
+  addGitSourceOptions,
+  addOutputOptions,
+  addPerformanceOptions,
+  addServeOptions,
+  setupBaseProgram
+} from './cli/defineOptions.mjs'
+import { initI18n, t } from './i18n/index.mjs'
+import { loadRcConfig } from './infra/configStore.mjs'
+
+// 引入加载器
 
 const main = async () => {
-  const program = new Command()
-
-  program
-    .name('git-commits')
-    .version(pkg.version, '-v', 'show version')
-    .description('Advanced Git commit log exporter.')
-    .option('--author <name>', '指定 author 名')
-    .option('--email <email>', '指定 email')
-    .option('--since <date>', '起始日期')
-    .option('--until <date>', '结束日期')
-    .option('--limit <n>', '限制数量', parseInt)
-    .option('--no-merges', '不包含 merge commit')
-    .option('--export', '导出统计数据')
-    .option('--json', '输出 JSON')
-    .option('--format <type>', '输出格式: text | excel | json', 'text')
-    .option('--group-by <type>', '按日期分组: day | month | week')
-    .option('--stats', '输出每日统计数据')
-    .option(
-      '--gerrit <prefix>',
-      '显示 Gerrit 地址，支持在 prefix 中使用 {{hash}} 占位符'
-    )
-    .option(
-      '--gerrit-api <url>',
-      '可选：Gerrit REST API 基础地址，用于解析 changeNumber，例如 `https://gerrit.example.com`'
-    )
-    .option(
-      '--gerrit-auth <tokenOrUserPass>',
-      '可选：Gerrit API 授权，格式为 `user:pass` 或 `TOKEN`（表示 Bearer token）'
-    )
-    .option('--overtime', '分析公司加班文化（输出下班时间与非工作日提交占比）')
-    .option('--country <code>', '节假日国家：CN 或 US，默认为 CN', 'CN')
-    .option(
-      '--work-start <hour>',
-      '上班开始小时，默认 9',
-      (v) => parseInt(v, 10),
-      9
-    )
-    .option(
-      '--work-end <hour>',
-      '下班小时，默认 18',
-      (v) => parseInt(v, 10),
-      18
-    )
-    .option(
-      '--lunch-start <hour>',
-      '午休开始小时，默认 12',
-      (v) => parseInt(v, 10),
-      12
-    )
-    .option(
-      '--lunch-end <hour>',
-      '午休结束小时，默认 14',
-      (v) => parseInt(v, 10),
-      14
-    )
-    .option(
-      '--overnight-cutoff <hour>',
-      '次日凌晨归并窗口（小时），默认 6',
-      (v) => parseInt(v, 10),
-      6
-    )
-    .option('--out <file>', '输出文件名（不含路径）')
-    .option(
-      '--out-dir <dir>',
-      '自定义输出目录，支持相对路径或绝对路径，例如 `--out-dir ../output-wukong`'
-    )
-    .option(
-      '--out-parent',
-      '将输出目录放到当前工程的父目录的 `output-wukong/`（等同于 `--out-dir ../output-wukong`）'
-    )
-    .option(
-      '--per-period-formats <formats>',
-      '每个周期单独输出的格式，逗号分隔：text,csv,tab,xlsx。默认为空（不输出 CSV/Tab/XLSX）',
-      ''
-    )
-    .option(
-      '--per-period-excel-mode <mode>',
-      'per-period Excel 模式：sheets|files（默认：sheets）',
-      'sheets'
-    )
-    .option(
-      '--per-period-only',
-      '仅输出 per-period（month/week）文件，不输出合并的 monthly/weekly 汇总文件'
-    )
-    .option(
-      '--serve',
-      '启动本地 web 服务，查看提交统计（将在 output-wukong/data 下生成数据文件）'
-    )
-    .option(
-      '--port <n>',
-      '本地 web 服务端口（默认 3000）',
-      (v) => parseInt(v, 10),
-      3000
-    )
-    .option('--debug', 'enable debug logs')
-    .option(
-      '--serve-only',
-      '仅启动 web 服务，不导出或分析数据（使用 output-wukong/data 中已有的数据）'
-    )
-    .option('--version', 'show version information')
-    .option('--profile', '输出性能分析 JSON')
-    .option('--verbose', '显示详细性能日志')
-    .option('--flame', '显示 flame-like 日志')
-    .option('--trace <file>', '生成 Chrome Trace')
-    .option('--hot-threshold <n>', 'HOT 比例阈值', parseFloat, 0.8)
-    .option('--fail-on-hot', 'HOT 时 CI 失败')
-    .option('--diff-base <file>', '基线 profile.json')
-    .option('--diff-threshold <n>', '回归阈值', parseFloat, 0.2)
-    .parse()
-
-  const opts = program.opts()
-
-  const config = parseOptions(opts)
-
-  profiler = createProfiler({
-    enabled: opts.profile,
-    verbose: opts.verbose,
-    flame: opts.flame,
-    traceFile: opts.trace,
-    hotThreshold: opts.hotThreshold,
-    failOnHot: opts.failOnHot,
-    diffBaseFile: opts.diffBase,
-    diffThreshold: opts.diffThreshold
-  })
-
-  // ❗只创建一次缓存实例
-  const getOvertimeStats = createOvertimeStats(config)
-
-  setConfig('debug', opts.debug === true)
-
-  // compute output directory root early (so serve-only can use it)
-  const outDir = opts.outParent
-    ? path.resolve(process.cwd(), '..', 'output-wukong')
-    : opts.outDir || undefined
-
-  if (opts.version) {
-    await version()
-    return
+  // --- 第一步：参数预检 (Pre-flight) ---
+  const args = process.argv.slice(2)
+
+  // 1. 快速提取 --lang 参数（不依赖 Commander，避免混乱）
+  const langArgIndex = args.findIndex((a) => a === '--lang' || a === '-l')
+  const userLang = langArgIndex !== -1 ? args[langArgIndex + 1] : null
+
+  // 初始化字典
+  // 2. 初始化 i18n（如果有 --lang 用 --lang，没有则内部调 osLocale）
+  // 这一步必须在定义子命令描述之前完成！
+  const finalLang = await initI18n(userLang)
+
+  // ---------------------------------------------------------
+  // 2. 环境准备
+  // ---------------------------------------------------------
+  const gitPreflightResult = await runGitPreflight()
+  if (args.includes('--info') || args.includes('-i')) {
+    console.log(`✔ Language: ${finalLang}`)
+    await showGitInfo(gitPreflightResult)
   }
-  // if serve-only is requested, start server and exit
-  if (opts.serveOnly) {
-    try {
-      await startServer(opts.port || 3000, outDir)
-    } catch (err) {
-      console.warn(
-        'Start server failed:',
-        err && err.message ? err.message : err
-      )
-      process.exit(1)
-    }
-    return
+  // 【关键优化】在一切开始前，先异步加载 RC 配置
+  // 这样后续 parseOptions 内部的 cachedConfig 就有值了
+  await loadRcConfig()
+
+  // 拦截 --version 自定义逻辑
+  if (args.includes('--version')) {
+    await versionAction()
+    process.exit(0) // 彻底拦截，不走后面的子命令逻辑
   }
 
-  const spinner = ora('Loading...').start()
+  // ---------------------------------------------------------
+  // 3. 定义 CLI 结构
+  // ---------------------------------------------------------
+  const program = new Command()
 
-  const gitCommits = await getGitLogsFast(opts)
-  let { commits: records } = gitCommits
-  const { authorMap } = gitCommits
-  // compute output directory root if user provided one or wants parent
+  // A. 挂载基础信息 (name, version, --lang, --debug)
+  setupBaseProgram(program)
 
-  // --- Gerrit 地址处理（若提供） ---
-  if (opts.gerrit) {
-    const prefix = opts.gerrit
-    // support optional changeNumber resolution via Gerrit REST API
-    const { gerritApi, gerritAuth } = opts
-    // create new array to avoid mutating function parameters (eslint: no-param-reassign)
-    if (prefix.includes('{{changeNumber}}') && gerritApi) {
-      // async mapping to resolve changeNumber using Gerrit API
-      const cache = new Map()
-      const headers = {}
-      if (gerritAuth) {
-        if (gerritAuth.includes(':')) {
-          headers.Authorization = `Basic ${Buffer.from(gerritAuth).toString('base64')}`
-        } else {
-          headers.Authorization = `Bearer ${gerritAuth}`
-        }
-      }
-      const fetchGerritJson = async (url) => {
-        try {
-          const res = await fetch(url, { headers })
-          const txt = await res.text()
-          // Gerrit prepends )]}' to JSON responses — strip it
-          const jsonText = txt.replace(/^\)\]\}'\n/, '')
-          return JSON.parse(jsonText)
-        } catch (err) {
-          return null
-        }
-      }
-      const resolveChangeNumber = async (r) => {
-        // try changeId first
-        if (r.changeId) {
-          if (cache.has(r.changeId)) return cache.get(r.changeId)
-          // try `changes/{changeId}/detail`
-          const url = `${gerritApi.replace(/\/$/, '')}/changes/${encodeURIComponent(r.changeId)}/detail`
-          let j = await fetchGerritJson(url)
-          if (j && j._number) {
-            cache.set(r.changeId, j._number)
-            return j._number
-          }
-          // fallback: query search
-          const url2 = `${gerritApi.replace(/\/$/, '')}/changes/?q=change:${encodeURIComponent(r.changeId)}`
-          j = await fetchGerritJson(url2)
-          if (Array.isArray(j) && j.length > 0 && j[0]._number) {
-            cache.set(r.changeId, j[0]._number)
-            return j[0]._number
-          }
-        }
-        // try commit hash
-        if (r.hash) {
-          if (cache.has(r.hash)) return cache.get(r.hash)
-          const url3 = `${gerritApi.replace(/\/$/, '')}/changes/?q=commit:${encodeURIComponent(r.hash)}`
-          const j = await fetchGerritJson(url3)
-          if (Array.isArray(j) && j.length > 0 && j[0]._number) {
-            cache.set(r.hash, j[0]._number)
-            return j[0]._number
-          }
-        }
-        return null
-      }
-      records = await Promise.all(
-        records.map(async (r) => {
-          const changeNumber = await resolveChangeNumber(r)
-          const changeNumberOrFallback = changeNumber || r.changeId || r.hash
-          const gerritUrl = prefix.replace(
-            '{{changeNumber}}',
-            changeNumberOrFallback
-          )
-          return { ...r, gerrit: gerritUrl }
-        })
-      )
-    } else if (prefix.includes('{{changeNumber}}') && !gerritApi) {
-      console.warn(
-        'prefix contains {{changeNumber}} but no --gerrit-api provided — falling back to changeId/hash'
-      )
-      records = records.map((r) => ({
-        ...r,
-        gerrit: prefix.replace('{{changeNumber}}', r.changeId || r.hash)
-      }))
-    } else {
-      records = records.map((r) => {
-        let gerritUrl
-        if (prefix.includes('{{changeId}}')) {
-          const changeId = r.changeId || r.hash
-          gerritUrl = prefix.replace('{{changeId}}', changeId)
-        } else if (prefix.includes('{{hash}}')) {
-          gerritUrl = prefix.replace('{{hash}}', r.hash)
-        } else {
-          gerritUrl = prefix.endsWith('/')
-            ? `${prefix}${r.hash}`
-            : `${prefix}/${r.hash}`
-        }
-        return { ...r, gerrit: gerritUrl }
-      })
-    }
-  }
+  // B. 注册子命令：按需组合参数模块
 
-  // --- 分组 ---
-  const groups = opts.groupBy ? groupRecords(records, opts.groupBy) : null
-  profiler.step('load config')
+  // === 命令: Init ===
 
-  // If serve mode is enabled, write data modules and launch the web server
-  if (opts.serve) {
-    handleServe({ opts, outDir, records, getOvertimeStats })
-  }
-
-  // --- Overtime analysis ---
-  if (opts.overtime) {
-    await profiler.stepAsync('getOvertimeStats', async () => {
-      await getOvertimeStats(records)
+  program
+    .command('init')
+    .description(t('cmds.init'))
+    .option('-f, --force', t('options.force'))
+    .action(async (options) => {
+      // 如果你不想抽离到 app 层，也可以直接写这里
+      // 但推荐抽离以保持架构一致性
+      await initAction(options)
     })
-    const stats = getOvertimeStats(records)
-
-    profiler.step('load getOvertimeStats')
-    // Output to console
-    console.log('\n--- Overtime analysis ---\n')
-    console.log(renderOvertimeText(stats))
-
-    const authorMapText = renderAuthorMapText(authorMap)
-    console.log('\n Developers:\n', authorMapText, '\n')
-    writeTextFile(outputFilePath('authors.text', outDir), authorMapText)
-
-    // if user requested json format, write stats to file
-    if (opts.json || opts.format === 'json') {
-      const file = opts.out || 'overtime.json'
-      const filepath = outputFilePath(file, outDir)
-      writeJSON(filepath, stats)
-      logDev(`overtime JSON 已导出: ${filepath}`)
-    }
-    // Always write human readable overtime text to file (default: overtime.txt)
-    const outBase = opts.out
-      ? path.basename(opts.out, path.extname(opts.out))
-      : 'commits'
-    const overtimeFileName = `overtime_${outBase}.txt`
-    const overtimeFile = outputFilePath(overtimeFileName, outDir)
-    writeTextFile(overtimeFile, renderOvertimeText(stats))
-    // write tab-separated text file for better alignment in editors that use proportional fonts
-    const overtimeTabFileName = `overtime_${outBase}.tab.txt`
-    const overtimeTabFile = outputFilePath(overtimeTabFileName, outDir)
-    writeTextFile(overtimeTabFile, renderOvertimeTab(stats))
-    // write CSV for structured data consumption
-    const overtimeCsvFileName = `overtime_${outBase}.csv`
-    const overtimeCsvFile = outputFilePath(overtimeCsvFileName, outDir)
-    writeTextFile(overtimeCsvFile, renderOvertimeCsv(stats))
-    logDev(`Overtime text 已导出: ${overtimeFile}`)
-    logDev(`Overtime table (tabs) 已导出: ${overtimeTabFile}`)
-    logDev(`Overtime CSV 已导出: ${overtimeCsvFile}`)
-
-    // 按月输出 ... 保持原逻辑
-    const perPeriodFormats = String(opts.perPeriodFormats || '')
-      .split(',')
-      .map((s) =>
-        String(s || '')
-          .trim()
-          .toLowerCase()
-      )
-      .filter(Boolean)
-    try {
-      const monthGroups = groupRecords(records, 'month')
-      const monthlyFileName = `overtime_${outBase}_monthly.txt`
-      const monthlyFile = outputFilePath(monthlyFileName, outDir)
-      let monthlyContent = ''
-      const monthKeys = Object.keys(monthGroups).sort()
-      monthKeys.forEach((k) => {
-        const groupRecs = monthGroups[k]
-        const s = getOvertimeStats(groupRecs)
-        monthlyContent += `===== ${k} =====\n`
-        monthlyContent += `${renderOvertimeText(s)}\n\n`
-        // Also write a single file per month under 'month/' folder
-        try {
-          const perMonthFileName = `month/overtime_${outBase}_${k}.txt`
-          const perMonthFile = outputFilePath(perMonthFileName, outDir)
-          writeTextFile(perMonthFile, renderOvertimeText(s))
-          logDev(`Overtime 月度(${k}) 已导出: ${perMonthFile}`)
-          // per-period CSV / Tab format (按需生成)
-          if (perPeriodFormats.includes('csv')) {
-            try {
-              const perMonthCsvName = `month/overtime_${outBase}_${k}.csv`
-              writeTextFile(
-                outputFilePath(perMonthCsvName, outDir),
-                renderOvertimeCsv(s)
-              )
-              logDev(
-                `Overtime 月度(CSV)(${k}) 已导出: ${outputFilePath(perMonthCsvName, outDir)}`
-              )
-            } catch (err) {
-              console.warn(
-                `Write monthly CSV for ${k} failed:`,
-                err && err.message ? err.message : err
-              )
-            }
-          }
-          if (perPeriodFormats.includes('tab')) {
-            try {
-              const perMonthTabName = `month/overtime_${outBase}_${k}.tab.txt`
-              writeTextFile(
-                outputFilePath(perMonthTabName, outDir),
-                renderOvertimeTab(s)
-              )
-              logDev(
-                `Overtime 月度(Tab)(${k}) 已导出: ${outputFilePath(perMonthTabName, outDir)}`
-              )
-            } catch (err) {
-              console.warn(
-                `Write monthly Tab for ${k} failed:`,
-                err && err.message ? err.message : err
-              )
-            }
-          }
-        } catch (err) {
-          console.warn(
-            `Write monthly file for ${k} failed:`,
-            err && err.message ? err.message : err
-          )
-        }
-      })
-      if (!opts.perPeriodOnly) {
-        writeTextFile(monthlyFile, monthlyContent)
-        logDev(`Overtime 月度汇总 已导出: ${monthlyFile}`)
-      }
-      // per-period Excel (sheets or files)
-      if (perPeriodFormats.includes('xlsx')) {
-        const perPeriodExcelMode = String(opts.perPeriodExcelMode || 'sheets')
-        if (perPeriodExcelMode === 'sheets') {
-          try {
-            const monthXlsxName = `month/overtime_${outBase}_monthly.xlsx`
-            const monthXlsxFile = outputFilePath(monthXlsxName, outDir)
-            await exportExcelPerPeriodSheets(monthGroups, monthXlsxFile, {
-              stats: opts.stats,
-              gerrit: opts.gerrit
-            })
-            logDev(`Overtime 月度(XLSX) 已导出: ${monthXlsxFile}`)
-          } catch (err) {
-            console.warn(
-              'Export month XLSX (sheets) failed:',
-              err && err.message ? err.message : err
-            )
-          }
-        } else {
-          try {
-            const monthKeys2 = Object.keys(monthGroups).sort()
-            const tasks = monthKeys2.map((k2) => {
-              const perMonthXlsxName = `month/overtime_${outBase}_${k2}.xlsx`
-              const perMonthXlsxFile = outputFilePath(perMonthXlsxName, outDir)
-              return exportExcel(monthGroups[k2], null, {
-                file: perMonthXlsxFile,
-                stats: opts.stats,
-                gerrit: opts.gerrit
-              }).then(() =>
-                console.log(
-                  chalk.green(
-                    `Overtime 月度(XLSX)(${k2}) 已导出: ${perMonthXlsxFile}`
-                  )
-                )
-              )
-            })
-            await Promise.all(tasks)
-          } catch (err) {
-            console.warn(
-              'Export monthly XLSX files failed:',
-              err && err.message ? err.message : err
-            )
-          }
-        }
-      }
-    } catch (err) {
-      console.warn(
-        'Generate monthly overtime failed:',
-        err && err.message ? err.message : err
-      )
-    }
-
-    // 周度输出保持原逻辑（略）
-    try {
-      const weekGroups = groupRecords(records, 'week')
-      const weeklyFileName = `overtime_${outBase}_weekly.txt`
-      const weeklyFile = outputFilePath(weeklyFileName, outDir)
-      let weeklyContent = ''
-      const weekKeys = Object.keys(weekGroups).sort()
-      weekKeys.forEach((k) => {
-        const groupRecs = weekGroups[k]
-        const s = getOvertimeStats(groupRecs)
-        weeklyContent += `===== ${k} =====\n`
-        weeklyContent += `${renderOvertimeText(s)}\n\n`
-        try {
-          const perWeekFileName = `week/overtime_${outBase}_${k}.txt`
-          const perWeekFile = outputFilePath(perWeekFileName, outDir)
-          writeTextFile(perWeekFile, renderOvertimeText(s))
-          // console.log(chalk.green(`Overtime 周度(${k}) 已导出: ${perWeekFile}`))
-          logDev(`Overtime 周度(${k}) 已导出: ${perWeekFile}`)
-
-          // eslint-disable-next-line no-shadow
-          const perPeriodFormats = String(opts.perPeriodFormats || '')
-            .split(',')
-            // eslint-disable-next-line no-shadow
-            .map((s) =>
-              String(s || '')
-                .trim()
-                .toLowerCase()
-            )
-            .filter(Boolean)
-          if (perPeriodFormats.includes('csv')) {
-            try {
-              const perWeekCsvName = `week/overtime_${outBase}_${k}.csv`
-              writeTextFile(
-                outputFilePath(perWeekCsvName, outDir),
-                renderOvertimeCsv(s)
-              )
-              logDev(
-                `Overtime 周度(CSV)(${k}) 已导出: ${outputFilePath(perWeekCsvName, outDir)}`
-              )
-            } catch (err) {
-              console.warn(
-                `Write weekly CSV for ${k} failed:`,
-                err && err.message ? err.message : err
-              )
-            }
-          }
-          if (perPeriodFormats.includes('tab')) {
-            try {
-              const perWeekTabName = `week/overtime_${outBase}_${k}.tab.txt`
-              writeTextFile(
-                outputFilePath(perWeekTabName, outDir),
-                renderOvertimeTab(s)
-              )
-              logDev(
-                `Overtime 周度(Tab)(${k}) 已导出: ${outputFilePath(perWeekTabName, outDir)}`
-              )
-            } catch (err) {
-              console.warn(
-                `Write weekly Tab for ${k} failed:`,
-                err && err.message ? err.message : err
-              )
-            }
-          }
-        } catch (err) {
-          console.warn(
-            `Write weekly file for ${k} failed:`,
-            err && err.message ? err.message : err
-          )
-        }
-      })
-      writeTextFile(weeklyFile, weeklyContent)
-      logDev(`Overtime 周度汇总 已导出: ${weeklyFile}`)
-    } catch (err) {
-      console.warn(
-        'Generate weekly overtime failed:',
-        err && err.message ? err.message : err
-      )
-    }
-  }
 
-  // --- JSON/TEXT/EXCEL（保持原逻辑） ---
-  if (opts.json || opts.format === 'json') {
-    const file = opts.out || 'commits.json'
-    const filepath = outputFilePath(file, outDir)
-    writeJSON(filepath, groups || records)
-    const jsonText = renderAuthorChangesJson(records)
-    writeJSON(outputFilePath('author-changes.json', outDir), jsonText)
-    logDev(`JSON 已导出: ${filepath}`)
-    handleSuccess({ spinner })
-    return
-  }
-
-  if (opts.format === 'text') {
-    const file = opts.out || 'commits.txt'
-    const filepath = outputFilePath(file, outDir)
-    const text = renderText(records, groups, { showGerrit: !!opts.gerrit })
-    writeTextFile(filepath, text)
-    writeTextFile(
-      outputFilePath('author-changes.txt', outDir),
-      renderChangedLinesText(records)
-    )
+  // # 命令: Analyze 核心分析（默认） 分析 git 提交记录 (最全参数)
+  const analyzeCmd = program
+    .command('analyze')
+    .description(t('cmds.analyze'))
+    .action((cmdOpts) => {
+      const globalOpts = program.opts()
+      const finalOpts = { ...globalOpts, ...cmdOpts }
+      analyzeAction(finalOpts)
+    })
 
-    // console.log('\n Commits List:\n', text, '\n')
+  // 挂载 analyze 需要的参数组
+  addGitSourceOptions(analyzeCmd)
+  addAnalysisOptions(analyzeCmd)
+  addOutputOptions(analyzeCmd)
+  addPerformanceOptions(analyzeCmd)
+
+  // # 命令: Overtime 加班文化分析
+  const overtimeCmd = program
+    .command('overtime')
+    .description(t('cmds.overtime'))
+    .action((cmdOpts) => {
+      const globalOpts = program.opts()
+      const finalOpts = { ...globalOpts, ...cmdOpts }
+      overtimeAction(finalOpts)
+    })
+  addGitSourceOptions(overtimeCmd)
+  addAnalysisOptions(overtimeCmd) // 加班分析肯定需要上班时间配置
+
+  // # 命令: Export (专注导出) 导出（excel / csv / json）
+  const exportCmd = program
+    .command('export')
+    .description(t('cmds.export'))
+    // .option('-f, --format <type>', '导出格式') // 局部参数
+    .action((cmdOpts, command) => {
+      // globalOpts 拿到 author, since 等
+      const globalOpts = command.parent.opts()
+      // 合并全局和局部参数
+      const finalOpts = { ...globalOpts, ...cmdOpts }
+      exportAction(finalOpts)
+    })
+  addGitSourceOptions(exportCmd)
+  addOutputOptions(exportCmd)
+
+  // === 命令: Journal (日报) ===
+  const journalCmd = program
+    .command('journal')
+    .description(t('cmds.journal'))
+    .action((cmdOpts) => {
+      const globalOpts = program.opts()
+      const finalOpts = { ...globalOpts, ...cmdOpts }
+      journalAction(finalOpts)
+    })
 
-    logDev(`文本已导出: ${filepath}`)
+  addGitSourceOptions(journalCmd)
 
-    handleSuccess({ spinner })
+  addPerformanceOptions(journalCmd)
 
-    return
-  }
-
-  if (opts.format === 'excel') {
-    const excelFile = opts.out || 'commits.xlsx'
-    const excelPath = outputFilePath(excelFile, outDir)
-    const txtFile = excelFile.replace(/\.xlsx$/, '.txt')
-    const txtPath = outputFilePath(txtFile, outDir)
-    await exportExcel(records, groups, {
-      file: excelPath,
-      stats: opts.stats,
-      gerrit: opts.gerrit
+  // === 命令: Serve (Web服务) ===
+  const serveCmd = program
+    .command('serve')
+    .description('Start web server')
+    .action((cmdOpts) => {
+      const globalOpts = program.opts()
+      const finalOpts = { ...globalOpts, ...cmdOpts }
+      serveAction(finalOpts)
     })
-    await exportExcelAuthorChangeStats(
-      records,
-      outputFilePath('author_stats.xlsx', outDir)
-    )
-    const text = renderText(records, groups)
-    writeTextFile(txtPath, text)
-    logDev(`Excel 已导出: ${excelPath}`)
-    logDev(`文本已自动导出: ${txtPath}`)
-
-    handleSuccess({ spinner })
-  }
+  // Serve 命令只需要端口，不需要 Git 作者之类的参数
+  addServeOptions(serveCmd)
+  program.parse(process.argv)
 
-  await autoCheckUpdate()
-
-  handleSuccess({ spinner })
+  // const opts = program.opts()
+  // console.log('✅ Cli Opts:', opts)
 }
 
 try {
@@ -661,18 +157,5 @@ try {
   console.error(err)
   process.exitCode = 1
 } finally {
-  if (profiler) {
-    const result = profiler.end('git-commits')
-
-    // --profile 时输出 JSON
-    if (process.argv.includes('--profile')) {
-      const json = {
-        command: 'git-commits',
-        version: VERSION,
-        timestamp: Date.now(),
-        profile: result
-      }
-      console.log(JSON.stringify(json, null, 2))
-    }
-  }
+  /* empty */
 }