wukong-gitlog-cli 1.0.39 → 1.0.41

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wukong-gitlog-cli",
-  "version": "1.0.39",
+  "version": "1.0.41",
   "description": "Advanced Git commit log exporter with Excel/JSON/TXT output, grouping, stats and CLI.",
   "keywords": [
     "git",
@@ -40,29 +40,28 @@
   "scripts": {
     "build": "node scripts/esbuild.config.mjs",
     "check:npm:login": "node scripts/check-npm-login.mjs",
-    "cli:excel-demo": "node ./src/cli.mjs --overtime --format excel --stats --limit 5 --out commits.xlsx",
-    "cli:excel-demo-parent": "node ./src/cli.mjs --out-parent --format excel --stats --limit 5 --out commits-parent.xlsx",
-    "cli:gerrit-changeid-demo": "node ./src/cli.mjs --format text --gerrit \"https://gerrit.example.com/c/project/+/{{changeId}}\" --limit 5 --out commits-gerrit-changeid.txt",
-    "cli:gerrit-demo": "node ./src/cli.mjs --format text --gerrit \"https://gerrit.example.com/c/project/+/{{hash}}\" --limit 5 --out commits-gerrit.txt",
-    "cli:help": "node ./src/cli.mjs --help",
-    "cli:json-demo": "node ./src/cli.mjs --json --limit 5 --out commits.json",
-    "cli:overtime-demo": "node ./src/cli.mjs --overtime --format text --limit 200",
-    "cli:overtime-excel": "node ./src/cli.mjs --overtime --limit 50 --format excel --out commits.xlsx",
-    "cli:overtime-excel-cn": "node ./src/cli.mjs --overtime --limit 50 --format excel --out commits.xlsx --country CN",
-    "cli:overtime-excel-cn-outdir": "node ./src/cli.mjs --out-dir ../output --overtime --limit 50 --format excel --out commits.xlsx --country CN",
-    "cli:overtime-excel-cn-parent": "node ./src/cli.mjs --out-parent --overtime --limit 50 --format excel --out commits.xlsx --country CN",
-    "cli:overtime-per-period-csv-tab": "node ./src/cli.mjs --overtime --limit 200 --format text --out commits.txt --per-period-formats csv,tab",
-    "cli:overtime-per-period-only": "node ./src/cli.mjs --overtime --limit 200 --format text --out commits.txt --per-period-formats csv,tab,xlsx --per-period-only",
-    "cli:overtime-per-period-xlsx-files": "node ./src/cli.mjs --overtime --limit 200 --format text --out commits.txt --per-period-formats xlsx --per-period-excel-mode files",
-    "cli:overtime-per-period-xlsx-sheets": "node ./src/cli.mjs --overtime --limit 200 --format text --out commits.txt --per-period-formats csv,tab,xlsx --per-period-excel-mode sheets",
-    "cli:overtime-text": "node ./src/cli.mjs --overtime --limit 100 --format text --out commits.txt",
-    "cli:overtime-text-us": "node ./src/cli.mjs --overtime --limit 50 --format text --out commits.txt --country US --work-start 10 --work-end 19 --lunch-start 12 --lunch-end 13",
-    "cli:overtime-text-us-outdir": "node ./src/cli.mjs --out-dir ../output --overtime --limit 50 --format text --out commits.txt --country US --work-start 10 --work-end 19 --lunch-start 12 --lunch-end 13",
-    "cli:overtime-text-us-parent": "node ./src/cli.mjs --out-parent --overtime --limit 50 --format text --out commits.txt --country US --work-start 10 --work-end 19 --lunch-start 12 --lunch-end 13",
-    "cli:serve": "node ./src/cli.mjs --serve --overtime --format text --out commits.txt",
-    "cli:serve-only": "node ./src/cli.mjs --serve-only",
-    "cli:text-demo": "node ./src/cli.mjs --format text --limit 5 --out commits.txt",
-    "cli:text-demo-parent": "node ./src/cli.mjs --out-parent --format text --limit 5 --out commits-parent.txt",
+    "cli:excel-demo": "node ./src/index.mjs --overtime --format excel --stats --limit 5",
+    "cli:excel-demo-parent": "node ./src/index.mjs --out-parent --format excel --stats --limit 5 --out commits-parent.xlsx",
+    "cli:gerrit-changeid-demo": "node ./src/index.mjs --format text --gerrit \"https://gerrit.example.com/c/project/+/{{changeId}}\" --limit 5 --out commits-gerrit-changeid.txt",
+    "cli:gerrit-demo": "node ./src/index.mjs --format text --gerrit \"https://gerrit.example.com/c/project/+/{{hash}}\" --limit 5 --out commits-gerrit.txt",
+    "cli:help": "node ./src/index.mjs --help",
+    "cli:json-demo": "node ./src/index.mjs --json --limit 5 --out commits.json",
+    "cli:overtime-demo": "node ./src/index.mjs --overtime --format text --limit 200",
+    "cli:overtime-excel": "node ./src/index.mjs --overtime --limit 50 --format excel",
+    "cli:overtime-excel-cn": "node ./src/index.mjs --overtime --limit 50 --format excel --country CN",
+    "cli:overtime-excel-cn-outdir": "node ./src/index.mjs --out-dir ../output --overtime --limit 50 --format excel  --country CN",
+    "cli:overtime-excel-cn-parent": "node ./src/index.mjs --out-parent --overtime --limit 50 --format excel  --country CN",
+    "cli:overtime-per-period-csv-tab": "node ./src/index.mjs --overtime --limit 200 --format text --out commits.txt --per-period-formats csv,tab",
+    "cli:overtime-per-period-only": "node ./src/index.mjs --overtime --limit 200 --format text --out commits.txt --per-period-formats csv,tab,xlsx --per-period-only",
+    "cli:overtime-per-period-xlsx-files": "node ./src/index.mjs --overtime --limit 200 --format text --out commits.txt --per-period-formats xlsx --per-period-excel-mode files",
+    "cli:overtime-per-period-xlsx-sheets": "node ./src/index.mjs --overtime --limit 200 --format text --out commits.txt --per-period-formats csv,tab,xlsx --per-period-excel-mode sheets",
+    "cli:overtime-text": "node ./src/index.mjs --overtime --limit 100 --format text --out commits.txt",
+    "cli:overtime-text-us": "node ./src/index.mjs --overtime --limit 50 --format text --out commits.txt --country US --work-start 10 --work-end 19 --lunch-start 12 --lunch-end 13",
+    "cli:overtime-text-us-outdir": "node ./src/index.mjs --out-dir ../output --overtime --limit 50 --format text --out commits.txt --country US --work-start 10 --work-end 19 --lunch-start 12 --lunch-end 13",
+    "cli:overtime-text-us-parent": "node ./src/index.mjs --out-parent --overtime --limit 50 --format text --out commits.txt --country US --work-start 10 --work-end 19 --lunch-start 12 --lunch-end 13",
+    "cli:serve": "node ./src/index.mjs serve",
+    "cli:text-demo": "node ./src/index.mjs export --format text --limit 5 ",
+    "cli:text-demo-parent": "node ./src/index.mjs export --out-parent --format text --limit 5 ",
     "format": "prettier --write \"src/**/*.{js,mjs}\"",
     "lint": "eslint src --ext .js,.mjs src",
     "lint:fix": "eslint src --ext .js,.mjs --fix",
@@ -93,8 +92,12 @@
       "eslint --fix"
     ]
   },
+  "imports": {
+    "#src/*": "./src/*",
+    "#utils/*": "./src/utils/*"
+  },
   "dependencies": {
-    "boxen": "8.0.1",
+    "@inquirer/prompts": "^8.1.0",
     "chalk": "5.6.2",
     "commander": "12.1.0",
     "date-fns": "4.1.0",
@@ -102,12 +105,12 @@
     "dayjs": "1.11.19",
     "dotenv": "17.2.2",
     "exceljs": "4.4.0",
-    "is-online": "12.0.2",
+    "fs-extra": "11.3.3",
     "ora": "9.0.0",
-    "semver": "6.3.1",
+    "os-locale": "^8.0.0",
     "string-width": "5.1.2",
-    "wukong-profiler": "^1.0.6",
-    "zx": "7.2.4"
+    "wukong-profiler": "^1.0.11",
+    "wukong-progress": "^0.1.2"
   },
   "devDependencies": {
     "@trivago/prettier-plugin-sort-imports": "5.2.2",

package/rc/.wukonggitlogrc

@@ -0,0 +1,53 @@
+# ------------------------------
+# .wukonggitlogrc
+# Wukong GitLog 配置示例
+# ------------------------------
+
+author:
+  include: []    # 只统计这些作者，留空表示全部
+  exclude: []    # 排除这些作者
+
+git:
+  merges: true     # 是否排除 merge commit
+  limit: 5000        # 最大拉取提交数
+
+period:
+  groupBy: month     # 统计周期: day | week | month
+  since: 2024-01-01  # 起始日期
+  until: 2024-12-31  # 截止日期
+
+gerrit:
+  prefix: https://gerrit.xxx.com/c/{{changeNumber}} # change 链接模板
+  api: https://gerrit.xxx.com                       # Gerrit API 地址
+  auth: token-or-user:pass                          # token 或 user:pass
+
+worktime:
+  country: CN       # 国家（影响节假日和周末计算）
+  start: 9          # 工作日开始时间（小时）
+  end: 18           # 工作日结束时间（小时）
+  lunch:
+    start: 12       # 午休开始时间
+    end: 14         # 午休结束时间
+  overnightCutoff: 6 # 凌晨时间计算截止点（0~6点归前一天）
+
+output:
+  dir: output-wukong      # 输出目录
+  formats:
+    - text
+    - json
+    - excel
+  perPeriod:
+    enabled: true          # 是否按周期生成单独文件
+    formats: [csv, tab, xlsx] # 分周期输出格式
+    excelMode: sheets      # sheets: 每周期一 sheet
+    only: false            # true: 仅输出 perPeriod，不生成总统计
+
+serve:
+  enabled: false   # 是否启动 Web 实时服务
+  port: 3000       # 服务端口
+
+profile:
+  enabled: false       # 是否启用代码 profile 分析
+  hotThreshold: 0.8    # 热点提交阈值
+  diffThreshold: 0.2   # 差异阈值
+

package/scripts/compareHourlyCounts.mjs

@@ -0,0 +1,42 @@
+import commits from '../output-wukong/data/commits.mjs';
+import overtimeFromFile from '../output-wukong/data/overtime.mjs';
+import { analyzeOvertime } from '../src/domain/overtime/overtime.mjs';
+
+const stats = analyzeOvertime(commits, {
+  startHour: overtimeFromFile.startHour ?? 9,
+  endHour: overtimeFromFile.endHour ?? 18,
+  lunchStart: overtimeFromFile.lunchStart ?? 12,
+  lunchEnd: overtimeFromFile.lunchEnd ?? 14,
+  country: overtimeFromFile.country ?? 'CN'
+});
+
+console.log('Computed stats:');
+console.log(' total:', stats.total);
+console.log(' outsideWorkCount:', stats.outsideWorkCount);
+console.log(' nightOutsideCount:', stats.nightOutsideCount);
+console.log(' hourlyOvertimeCommits sum:', stats.hourlyOvertimeCommits.reduce((a,b)=>a+b,0));
+console.log(' hourlyOvertimeCommits:', stats.hourlyOvertimeCommits);
+
+const fileStats = (overtimeFromFile && overtimeFromFile.default) ? overtimeFromFile.default : overtimeFromFile;
+console.log('\nFile stats:');
+console.log(' total:', fileStats.total);
+console.log(' outsideWorkCount:', fileStats.outsideWorkCount);
+console.log(' nightOutsideCount:', fileStats.nightOutsideCount);
+console.log(' hourlyOvertimeCommits sum (if present):', (fileStats.hourlyOvertimeCommits || []).reduce((a,b)=>a+b,0));
+console.log(' hourlyOvertimeCommits:', fileStats.hourlyOvertimeCommits || 'N/A');
+
+// Compare
+console.log('\nComparisons:');
+console.log(' outsideWorkCount equal?', stats.outsideWorkCount === fileStats.outsideWorkCount);
+console.log(' nightOutsideCount equal?', stats.nightOutsideCount === fileStats.nightOutsideCount);
+const hourlyEqual = JSON.stringify(stats.hourlyOvertimeCommits) === JSON.stringify(fileStats.hourlyOvertimeCommits || []);
+console.log(' hourlyOvertimeCommits equal?', hourlyEqual);
+
+if (!hourlyEqual) {
+  console.log(' Differences by hour:');
+  const a = stats.hourlyOvertimeCommits;
+  const b = fileStats.hourlyOvertimeCommits || Array(24).fill(0);
+  for (let i=0;i<24;i++) {
+    if ((a[i]||0) !== (b[i]||0)) console.log(`  hour ${i}: computed=${a[i]||0} file=${b[i]||0}`);
+  }
+}

package/scripts/compareLatest.mjs

@@ -0,0 +1,106 @@
+import { fileURLToPath } from 'url'
+import path from 'path'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+const commitsMod = await import(path.join(__dirname, '../output-wukong/data/commits.mjs'))
+const overtimeMod = await import(path.join(__dirname, '../output-wukong/data/overtime.latest.commit.day.mjs'))
+const commits = commitsMod.default || commitsMod
+const overtimeLatest = overtimeMod.default || overtimeMod
+
+function formatDateYMD(d) {
+  const yyyy = d.getFullYear()
+  const mm = String(d.getMonth() + 1).padStart(2, '0')
+  const dd = String(d.getDate()).padStart(2, '0')
+  return `${yyyy}-${mm}-${dd}`
+}
+
+function computeLatestByDayLocal(commits, startHour = 9, endHour = 18, cutoff = 6) {
+  const cutoffHour = cutoff || 6
+  const dayGroups = {}
+  commits.forEach((c) => {
+    const d = new Date(c.date)
+    if (isNaN(d.getTime())) return
+    const dateStr = formatDateYMD(d)
+    if (!dayGroups[dateStr]) dayGroups[dateStr] = []
+    dayGroups[dateStr].push(c)
+  })
+
+  const dayKeys = Object.keys(dayGroups).sort()
+  const virtualPrevDays = new Set()
+  commits.forEach((c) => {
+    const d = new Date(c.date)
+    if (isNaN(d.getTime())) return
+    const h = d.getHours()
+    if (h < 0 || h >= cutoffHour || h >= startHour) return
+    const prevDate = new Date(d)
+    prevDate.setDate(prevDate.getDate() - 1)
+    const prevDay = formatDateYMD(prevDate)
+    if (!dayGroups[prevDay]) virtualPrevDays.add(prevDay)
+  })
+
+  const allDayKeys = Array.from(new Set([...dayKeys, ...virtualPrevDays])).sort()
+
+  const latestByDay = allDayKeys.map((k) => {
+    const list = dayGroups[k] || []
+    const sameDayHours = list
+      .map((c) => new Date(c.date))
+      .filter((d) => !isNaN(d.getTime()))
+      .map((d) => d.getHours())
+      .filter((h) => h >= endHour && h < 24)
+
+    const nextDate = new Date(`${k}T00:00:00`)
+    nextDate.setDate(nextDate.getDate() + 1)
+    const nextKey = formatDateYMD(nextDate)
+    const early = dayGroups[nextKey] || []
+    const earlyHours = early
+      .map((c) => new Date(c.date))
+      .filter((d) => !isNaN(d.getTime()))
+      .map((d) => d.getHours())
+      .filter((h) => h >= 0 && h < cutoffHour && h < startHour)
+
+    const overtimeValues = [...sameDayHours, ...earlyHours.map((h) => 24 + h)]
+    if (overtimeValues.length === 0) return { date: k, latestHour: null, latestHourNormalized: null }
+    const latestHourNormalized = Math.max(...overtimeValues)
+    const sameDayMax = sameDayHours.length > 0 ? Math.max(...sameDayHours) : null
+    return { date: k, latestHour: sameDayMax, latestHourNormalized }
+  })
+
+  return latestByDay
+}
+
+async function main() {
+  console.log('Computing frontend-style latestByDay from commits...')
+  const computed = computeLatestByDayLocal(commits)
+  const byDate = {}
+  computed.forEach((d) => { byDate[d.date] = d })
+
+  const mismatches = []
+  overtimeLatest.forEach((o) => {
+    const comp = byDate[o.date]
+    if (!comp) {
+      mismatches.push({ date: o.date, reason: 'missing-in-computed', expected: o, actual: null })
+      return
+    }
+    const expNorm = o.latestHourNormalized
+    const actNorm = comp.latestHourNormalized
+    if (expNorm !== actNorm) {
+      mismatches.push({ date: o.date, expected: o, actual: comp })
+    }
+  })
+
+  if (mismatches.length === 0) {
+    console.log('No mismatches: computed latestByDay matches overtime.latest.commit.day.mjs')
+  } else {
+    console.log(`Found ${mismatches.length} mismatches:`)
+    mismatches.slice(0, 50).forEach((m) => {
+      console.log('---')
+      console.log(m.date)
+      console.log(' expected:', m.expected)
+      console.log(' actual :', m.actual)
+    })
+  }
+}
+
+main().catch((e) => { console.error(e); process.exit(1) })

package/src/app/analyzeAction.mjs

@@ -0,0 +1,120 @@
+import chalk from 'chalk'
+import path from 'path'
+import { createProfiler } from 'wukong-profiler'
+import { createMultiBar } from 'wukong-progress'
+
+import { getProfileDirFile } from '#utils/getProfileDirFile.mjs'
+
+import { parseOptions } from '../cli/parseOptions.mjs'
+import { getAuthorChangeStats } from '../domain/author/analyze.mjs'
+import { getGitLogsFast } from '../domain/git/getGitLogs.mjs'
+import { resolveGerrit } from '../domain/git/resolveGerrit.mjs'
+import { getWorkOvertimeStats } from '../domain/overtime/analyze.mjs'
+import { t } from '../i18n/index.mjs'
+import { outputAll, outputData } from '../output/index.mjs'
+import {
+  getLatestCommitByDay,
+  getOvertimeByMonth,
+  getOvertimeByWeek,
+  getWorkTimeConfig
+} from './helpers.mjs'
+
+// 建议将辅助计算函数抽离，保持主逻辑清晰
+
+export async function analyzeAction(rawOpts = {}) {
+  const opts = await parseOptions(rawOpts)
+
+  const traceFile = getProfileDirFile('trace.json', opts)
+  const profileFile = getProfileDirFile('profile.json', opts)
+
+  const profiler = createProfiler({ ...opts.profile, traceFile ,profileFile}, opts)
+
+  // 未来 可考虑将 MultiBar 抽离到更高层，支持所有 action 共用，wukong-progress 需要支持自定义子任务占位符
+  // 初始化 MultiBar
+  const mb = createMultiBar()
+  const bar = mb.create(100, {
+    prefix: chalk.cyan(t('analyze.prefix')), // 国际化前缀 'Analyze' / '分析'
+    format: ' [:bar] :percent :payload'
+  })
+
+  const result = {}
+
+  try {
+    // 1️⃣ 拉取 Git 记录
+    bar.step(5, t('analyze.step_git_fetch')) // '正在提取 Git 提交记录...'
+    const { commits, authorMap } = await profiler.stepAsync('getGitLogs', () =>
+      getGitLogsFast(opts)
+    )
+    result.commits = commits
+    result.authorMap = authorMap
+    bar.step(8, t('analyze.step_git_done')) // 'Git 记录提取完成'
+
+    const records = result.commits
+
+    // 2️⃣ Gerrit enrich（公共）
+    const enrichedRecords = opts.gerrit
+      ? await resolveGerrit(records, opts)
+      : records
+
+    // 2️⃣ 分析作者变更
+    bar.step(9, t('analyze.step_author_stats')) // '正在分析作者代码贡献...'
+    const authorChanges = await profiler.stepAsync(
+      'analyzeAuthorChanges',
+      () => {
+        return getAuthorChangeStats(enrichedRecords)
+      }
+    )
+    result.authorChanges = authorChanges
+
+    // 3️⃣ 加班分析（根据配置可选）
+    if (opts.overtime) {
+      const worktimeOptions = getWorkTimeConfig(opts)
+
+      bar.step(10, t('analyze.step_overtime_calc')) // '正在计算加班概况...'
+      result.overtime = await profiler.stepAsync('overtime', () => {
+        return getWorkOvertimeStats(enrichedRecords, worktimeOptions)
+      })
+
+      bar.step(20, t('analyze.step_trends')) // '正在生成周/月趋势数据...'
+      result.overtimeByWeek = await getOvertimeByWeek(enrichedRecords)
+      result.overtimeByMonth = await getOvertimeByMonth(enrichedRecords)
+
+      bar.step(20, t('analyze.step_latest_mark')) // '正在标记每日最晚提交点...'
+      result.overtimeLatestCommitByDay = await getLatestCommitByDay({
+        commits: enrichedRecords,
+        opts: worktimeOptions
+      })
+    } else {
+      bar.step(50, t('analyze.step_skip_overtime')) // '跳过加班数据分析'
+    }
+
+    // 4️⃣ 数据输出
+    bar.step(80, t('analyze.step_output')) // '正在持久化分析结果...'
+    await profiler.stepAsync('output', async () => {
+      const worktimeOptions = getWorkTimeConfig(opts)
+
+      await outputData(result, {
+        dir: opts.output.dir || path.resolve('output-wukong'),
+        worktimeOptions,
+        period: opts.period || {},
+        author: opts.author || null,
+        git: opts.git || {}
+      })
+    })
+
+    bar.step(100, t('analyze.step_complete')) // '分析任务全部完成！'
+  } catch (error) {
+    // 异常处理：停止进度条并打印红色错误
+    mb.stop()
+    console.error(
+      `\n${chalk.bgRed(' ERROR ')} ${chalk.red(error.stack || error)}`
+    )
+    process.exit(1)
+  } finally {
+    // 正常结束
+    profiler.end('analyze')
+    mb.stop()
+  }
+
+  return result
+}

package/src/app/exportAction.mjs

@@ -0,0 +1,215 @@
+/**
+ * @file: exportAction.mjs
+ * @description:
+ * @author: King Monkey
+ * @created: 2025-12-31 17:27
+ */
+import chalk from 'chalk'
+import path from 'path'
+import { createProfiler } from 'wukong-profiler'
+import { createMultiBar } from 'wukong-progress'
+
+import { handleExportAuthor } from '#src/domain/export/exportAuthor.mjs'
+import { handleExportAuthorChanges } from '#src/domain/export/exportAuthorChanges.mjs'
+import { handleExportAuthorChangesJson } from '#src/domain/export/exportAuthorChangesJson.mjs'
+import { handleExportByMonth } from '#src/domain/export/exportByMonth.mjs'
+import { handleExportByWeek } from '#src/domain/export/exportByWeek.mjs'
+import { handleExportCommits } from '#src/domain/export/exportCommits.mjs'
+import { handleExportCommitsExcel } from '#src/domain/export/exportCommitsExcel.mjs'
+import { handleExportCommitsJson } from '#src/domain/export/exportCommitsJson.mjs'
+import {
+  handleExportOvertimeCsv,
+  handleExportOvertimeMain,
+  handleExportOvertimeTabTxt,
+  handleExportOvertimeTxt
+} from '#src/domain/export/index.mjs'
+import { getProfileDirFile } from '#utils/getProfileDirFile.mjs'
+import { groupRecords } from '#utils/groupRecords.mjs'
+
+import { parseOptions } from '../cli/parseOptions.mjs'
+import { getGitLogsFast } from '../domain/git/getGitLogs.mjs'
+import { resolveGerrit } from '../domain/git/resolveGerrit.mjs'
+import { getWorkOvertimeStats } from '../domain/overtime/analyze.mjs'
+import {
+  renderOvertimeCsv,
+  renderOvertimeTab,
+  renderOvertimeText
+} from '../domain/overtime/overtime.mjs'
+import { outputAll, outputData } from '../output/index.mjs'
+import {
+  getLatestCommitByDay,
+  getOvertimeByMonth,
+  getOvertimeByWeek,
+  getWorkTimeConfig
+} from './helpers.mjs'
+import { t } from '../i18n/index.mjs'
+
+
+export async function exportAction(rawOpts = {}) {
+  const opts = await parseOptions(rawOpts)
+  const traceFile = getProfileDirFile('trace.json', opts)
+
+
+  const profiler = createProfiler({ ...opts.profile, traceFile }, opts)
+
+  const mb = createMultiBar()
+  const bar = mb.create(100, {
+    prefix: chalk.cyan(t('export.prefix')),
+    format: ' [:bar] :percent :payload'
+  })
+
+  const result = {}
+  try {
+    // 1️⃣ 拉取 Git 记录
+    bar.step(5, t('analyze.step_git_fetch'))
+    const { commits, authorMap } = await profiler.stepAsync('getGitLogs', () =>
+      getGitLogsFast(opts)
+    )
+    result.commits = commits
+
+    bar.step(15, t('analyze.step_git_done'))
+
+    const records = result.commits
+
+    // 2️⃣ Gerrit enrich（公共）
+    const enrichedRecords = opts.gerrit
+      ? await resolveGerrit(records, opts)
+      : records
+
+    // 3️⃣ 加班分析（根据配置可选）
+    const worktimeOptions = getWorkTimeConfig(opts)
+
+    bar.step(10,  t('analyze.step_overtime_calc'))
+    result.overtime = await profiler.stepAsync('overtime', () => {
+      return getWorkOvertimeStats(enrichedRecords, worktimeOptions)
+    })
+
+    if (['all','week'].includes(opts.period.groupBy)) {
+      bar.step(20, t('analyze.step_trends'))
+      result.overtimeByWeek = await getOvertimeByWeek(enrichedRecords)
+    }
+
+    if (['all','month'].includes(opts.period.groupBy)) {
+      result.overtimeByMonth = await getOvertimeByMonth(enrichedRecords)
+    }
+
+    bar.step(20, t('analyze.step_latest_mark'))
+    result.overtimeLatestCommitByDay = await getLatestCommitByDay({
+      commits: enrichedRecords,
+      opts: worktimeOptions
+    })
+
+    // 4️⃣ 数据输出
+    bar.step(10, t('analyze.step_output'))
+    await profiler.stepAsync('output', async () => {
+      await outputData(result, {
+        dir: opts.output.dir || path.resolve('output-wukong'),
+        worktimeOptions,
+        git: opts.git || {},
+      })
+    })
+
+    bar.step(100, t('analyze.step_complete'))
+    handleExportOvertimeMain({
+      fileName: 'overtime.json',
+      opts,
+      result: result.overtime
+    })
+
+    // 导出 overtime_commits.txt
+    const overtimeTxtResult = renderOvertimeText(result.overtime)
+    handleExportOvertimeTxt({
+      fileName: 'overtime_commits.txt',
+      opts,
+      result: overtimeTxtResult
+    })
+
+    // 导出 overtime_commits.tab.txt
+    const overtimeTabTxtResult = renderOvertimeTab(result.overtime)
+    handleExportOvertimeTabTxt({
+      fileName: 'overtime_commits.tab.txt',
+      opts,
+      result: overtimeTabTxtResult
+    })
+
+    // 导出 overtime_commits.csv
+    const overtimeCsvResult = renderOvertimeCsv(result.overtime)
+    handleExportOvertimeCsv({
+      fileName: 'overtime_commits.csv',
+      opts,
+      result: overtimeCsvResult
+    })
+
+    if (['all','month'].includes(opts.period.groupBy)) {
+      // 导出 每月数据
+      handleExportByMonth({
+        opts,
+        records: commits,
+        worktimeOptions
+      })
+    }
+
+    if (['all','week'].includes(opts.period.groupBy)) {
+      // 导出 每周数据
+      handleExportByWeek({
+        opts,
+        records: commits,
+        worktimeOptions
+      })
+    }
+
+    // 导出 commit logs
+    handleExportCommits({
+      opts,
+      records: commits,
+      fileName: 'commits.txt'
+    })
+
+    // 导出 commit logs
+    handleExportAuthorChanges({
+      opts,
+      records: commits,
+      fileName: 'author-changes.txt'
+    })
+
+    // --- 分组 ---
+    const groups = opts.period.groupBy
+      ? groupRecords(records, opts.period.groupBy)
+      : null
+
+
+    handleExportCommitsExcel({
+      opts,
+      records: commits,
+      fileName: 'commits.xlsx',
+      groups
+    })
+
+    handleExportCommitsJson({
+      opts,
+      records: commits,
+      fileName: 'commits.json',
+      groups
+    })
+
+    handleExportAuthorChangesJson({
+      opts,
+      records: commits,
+      fileName: 'author-changes.json'
+    })
+    handleExportAuthor({ opts, records: authorMap, fileName: 'author.txt' })
+  } catch (error) {
+    // 异常处理：停止进度条并打印红色错误
+    mb.stop()
+    console.error(
+      `\n${chalk.bgRed(' ERROR ')} ${chalk.red(error.stack || error)}`
+    )
+    process.exit(1)
+  } finally {
+    // 正常结束
+    profiler.end('analyze')
+    mb.stop()
+  }
+
+  return result
+}

package/src/app/exportActionProgress.mjs

@@ -0,0 +1,37 @@
+import chalk from 'chalk'
+import { createMultiBar } from 'wukong-progress'
+
+const someAsyncLogTask = () =>
+  new Promise((resolve) => {setTimeout(resolve, 1000)})
+const someDataProcessing = () =>
+  new Promise((resolve) => {setTimeout(resolve, 1500)})
+const writeToFile = () => new Promise((resolve) => {setTimeout(resolve, 1000)})
+
+export async function exportAction(rawOpts = {}) {
+  const mb = createMultiBar()
+  const bar = mb.create(100, {
+    prefix: chalk.cyan('Build'),
+    format: 'Build [:bar] :percent :current/:total'
+  })
+
+  console.log('\n🚀', chalk.cyan('Wukong GitLog'), '报告导出中...\n')
+
+  // --- 模拟业务步骤 ---
+
+  // 1. 获取日志 (30%)
+  await someAsyncLogTask()
+  bar.tick(30)
+
+  // 2. 处理数据 (再加 40%)
+  await someDataProcessing()
+  bar.tick(40)
+
+  // 3. 写入文件 (最后 30%)
+  await writeToFile()
+  bar.tick(30)
+
+  // --- 业务结束 ---
+
+  mb.stop()
+  console.log(chalk.green('\nDone!\n'))
+}