wukong-gitlog-cli 1.0.36 → 1.0.37

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [1.0.37](https://github.com/tomatobybike/wukong-gitlog-cli/compare/v1.0.36...v1.0.37) (2025-12-12)
+
+
+### Features
+
+* 🎸 add logDev ([a85905b](https://github.com/tomatobybike/wukong-gitlog-cli/commit/a85905b038014fb62c7fd21713f63e2405e3cfa7))
+* 🎸 createOvertimeStats ([abb0051](https://github.com/tomatobybike/wukong-gitlog-cli/commit/abb0051efc91cceb9845a1c5c9a00f9d6747baf4))
+* 🎸 logDev ([e122042](https://github.com/tomatobybike/wukong-gitlog-cli/commit/e12204203a077630784caa16b01c566fdd72b84a))
+* 🎸 logger debug ([32a55fe](https://github.com/tomatobybike/wukong-gitlog-cli/commit/32a55fe8d191969ca887cb46789d14b65b446f6d))
+
 ### [1.0.36](https://github.com/tomatobybike/wukong-gitlog-cli/compare/v1.0.35...v1.0.36) (2025-12-12)
 
 

package/bin/wukong-gitlog-cli

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import('../src/cli.mjs')
+import('../src/index.mjs')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wukong-gitlog-cli",
-  "version": "1.0.36",
+  "version": "1.0.37",
   "description": "Advanced Git commit log exporter with Excel/JSON/TXT output, grouping, stats and CLI.",
   "keywords": [
     "git",
@@ -96,6 +96,8 @@
     "commander": "12.1.0",
     "date-holidays": "2.1.1",
     "dayjs": "1.11.19",
+    "date-fns": "4.1.0",
+    "dotenv": "17.2.2",
     "exceljs": "4.4.0",
     "is-online": "12.0.2",
     "ora": "9.0.0",

package/src/cli/parseOptions.mjs

@@ -0,0 +1,9 @@
+export function parseOptions(opts) {
+  return {
+    startHour: opts.workStart ?? 9,
+    endHour: opts.workEnd ?? 18,
+    lunchStart: opts.lunchStart ?? 12,
+    lunchEnd: opts.lunchEnd ?? 14,
+    country: opts.country ?? 'CN'
+  };
+}

package/src/git.mjs

@@ -76,21 +76,20 @@ export async function getGitLogsSlow(opts) {
     }
   }
 
-  return commits
+  return { commits, authorMap: {} }
 }
 
 export async function getGitLogsQuick(opts) {
   const { author, email, since, until, limit, merges } = opts
 
-  const pretty =
-    `${[
-      '%H', // hash
-      '%an', // author name
-      '%ae', // email
-      '%ad', // date
-      '%s', // subject
-      '%B' // body
-    ].join('%x1f')  }%x1e`
+  const pretty = `${[
+    '%H', // hash
+    '%an', // author name
+    '%ae', // email
+    '%ad', // date
+    '%s', // subject
+    '%B' // body
+  ].join('%x1f')}%x1e`
 
   const args = [
     'log',
@@ -177,11 +176,16 @@ export async function getGitLogsFast(opts = {}) {
     '%an', // author name
     '%ae', // email
     '%ad', // date
-    '%s',  // subject
-    '%B'   // body
-  ].join('%x1f')  }%x1e`
+    '%s', // subject
+    '%B' // body
+  ].join('%x1f')}%x1e`
 
-  const args = ['log', `--pretty=format:${pretty}`, '--date=iso-local', '--numstat']
+  const args = [
+    'log',
+    `--pretty=format:${pretty}`,
+    '--date=iso-local',
+    '--numstat'
+  ]
 
   if (author) args.push(`--author=${author}`)
   if (email) args.push(`--author=${email}`)
@@ -196,13 +200,15 @@ export async function getGitLogsFast(opts = {}) {
   const commits = []
 
   // 匹配每个 commit header + numstat
-  // eslint-disable-next-line no-control-regex
-  const commitRegex = /([0-9a-f]+)\x1f([^\x1f]*)\x1f([^\x1f]*)\x1f([^\x1f]*)\x1f([^\x1f]*)\x1f([\s\S]*?)(?=(?:[0-9a-f]{7,40}\x1f)|\x1e$)/g
+  const commitRegex =
+    // eslint-disable-next-line no-control-regex
+    /([0-9a-f]+)\x1f([^\x1f]*)\x1f([^\x1f]*)\x1f([^\x1f]*)\x1f([^\x1f]*)\x1f([\s\S]*?)(?=(?:[0-9a-f]{7,40}\x1f)|\x1e$)/g
   let match
 
   for (const ns of raw.matchAll(commitRegex)) {
     const [_, hash, authorName, emailAddr, date, subject, bodyAndNumstat] = ns
-    const [, changeId] = bodyAndNumstat.match(/Change-Id:\s*(I[0-9a-fA-F]+)/) || []
+    const [, changeId] =
+      bodyAndNumstat.match(/Change-Id:\s*(I[0-9a-fA-F]+)/) || []
 
     const c = {
       hash,

package/src/handlers/handleServe.mjs

@@ -0,0 +1,203 @@
+import dayjs from 'dayjs'
+
+// eslint-disable-next-line no-unused-vars
+import { renderAuthorChangesJson } from '../json.mjs'
+import { startServer } from '../server.mjs'
+import { getWeekRange } from '../utils/getWeekRange.mjs'
+import { groupRecords, outputFilePath, writeTextFile } from '../utils/index.mjs'
+import { logDev } from '../utils/logDev.mjs'
+
+export const handleServe = async ({
+  opts,
+  outDir,
+  records,
+  getOvertimeStats
+}) => {
+  try {
+    const stats = getOvertimeStats(records)
+
+    const dataCommitsFile = outputFilePath('data/commits.mjs', outDir)
+    const commitsModule = `export default ${JSON.stringify(records, null, 2)};\n`
+    writeTextFile(dataCommitsFile, commitsModule)
+
+    const dataCommitsChangedFile = outputFilePath(
+      'data/author-changes.mjs',
+      outDir
+    )
+    const jsonText = renderAuthorChangesJson(records)
+
+    const commitsChangedModule = `export default ${JSON.stringify(jsonText, null, 2)};\n`
+    writeTextFile(dataCommitsChangedFile, commitsChangedModule)
+
+    const dataStatsFile = outputFilePath('data/overtime-stats.mjs', outDir)
+    const statsModule = `export default ${JSON.stringify(stats, null, 2)};\n`
+    writeTextFile(dataStatsFile, statsModule)
+
+    // 新增：每周趋势数据（用于前端图表）
+    const weekGroups = groupRecords(records, 'week')
+    const weekKeys = Object.keys(weekGroups).sort()
+    const weeklySeries = weekKeys.map((k) => {
+      const s = getOvertimeStats(weekGroups[k])
+      return {
+        period: k,
+        range: getWeekRange(k),
+        total: s.total,
+        outsideWorkCount: s.outsideWorkCount,
+        outsideWorkRate: s.outsideWorkRate,
+        nonWorkdayCount: s.nonWorkdayCount,
+        nonWorkdayRate: s.nonWorkdayRate
+      }
+    })
+    const dataWeeklyFile = outputFilePath('data/overtime-weekly.mjs', outDir)
+    const weeklyModule = `export default ${JSON.stringify(weeklySeries, null, 2)};\n`
+    writeTextFile(dataWeeklyFile, weeklyModule)
+    logDev(`Weekly series 已导出: ${dataWeeklyFile}`)
+
+    // 新增：每月趋势数据（用于前端图表）
+    const monthGroups2 = groupRecords(records, 'month')
+    const monthKeys2 = Object.keys(monthGroups2).sort()
+    const monthlySeries = monthKeys2.map((k) => {
+      const s = getOvertimeStats(monthGroups2[k])
+      return {
+        period: k,
+        total: s.total,
+        outsideWorkCount: s.outsideWorkCount,
+        outsideWorkRate: s.outsideWorkRate,
+        nonWorkdayCount: s.nonWorkdayCount,
+        nonWorkdayRate: s.nonWorkdayRate
+      }
+    })
+    const dataMonthlyFile = outputFilePath('data/overtime-monthly.mjs', outDir)
+    const monthlyModule = `export default ${JSON.stringify(monthlySeries, null, 2)};\n`
+    writeTextFile(dataMonthlyFile, monthlyModule)
+    logDev(`Monthly series 已导出: ${dataMonthlyFile}`)
+
+    // 新增：每日最晚提交小时（用于显著展示加班严重程度）
+    const dayGroups2 = groupRecords(records, 'day')
+    const dayKeys2 = Object.keys(dayGroups2).sort()
+
+    // 次日凌晨归并窗口（默认 6 点前仍算前一天的加班）
+    const overnightCutoff = Number.isFinite(opts.overnightCutoff)
+      ? opts.overnightCutoff
+      : 6
+    // 次日上班时间（默认按 workStart，若未指定则 9 点）
+    const workStartHour =
+      opts.workStart || opts.workStart === 0 ? opts.workStart : 9
+    const workEndHour = opts.workEnd || opts.workEnd === 0 ? opts.workEnd : 18
+
+    // 有些日期「本身没有 commit」，但第二天凌晨有提交要归并到这一天，
+    // 需要补出这些“虚拟日期”，否则 latestByDay 会漏掉这天。
+    const virtualPrevDays = new Set()
+    records.forEach((r) => {
+      const d = new Date(r.date)
+      if (Number.isNaN(d.valueOf())) return
+      const h = d.getHours()
+      if (h < 0 || h >= overnightCutoff || h >= workStartHour) return
+      const curDay = dayjs(d).format('YYYY-MM-DD')
+      const prevDay = dayjs(curDay).subtract(1, 'day').format('YYYY-MM-DD')
+      if (!dayGroups2[prevDay]) {
+        virtualPrevDays.add(prevDay)
+      }
+    })
+
+    const allDayKeys = Array.from(
+      new Set([...dayKeys2, ...virtualPrevDays])
+    ).sort()
+
+    const latestByDay = allDayKeys.map((k) => {
+      const list = dayGroups2[k] || []
+
+      // 1) 当天「下班后」的提交：只统计 >= workEndHour 的小时
+      const sameDayHours = list
+        .map((r) => new Date(r.date))
+        .filter((d) => !Number.isNaN(d.valueOf()))
+        .map((d) => d.getHours())
+        .filter((h) => h >= workEndHour && h < 24)
+
+      // 2) 次日凌晨、但仍算前一日加班的提交
+      const nextKey = dayjs(k).add(1, 'day').format('YYYY-MM-DD')
+      const early = dayGroups2[nextKey] || []
+      const earlyHours = early
+        .map((r) => new Date(r.date))
+        .filter((d) => !Number.isNaN(d.valueOf()))
+        .map((d) => d.getHours())
+        // 只看 [0, overnightCutoff) 之间的小时，
+        // 并且默认认为 < workStartHour 属于「次日上班前」
+        .filter(
+          (h) =>
+            h >= 0 &&
+            h < overnightCutoff &&
+            // 保护性判断：若有人把 overnightCutoff 设得大于上班时间，
+            // 我们仍然只统计到上班时间为止
+            h < workStartHour
+        )
+
+      // 3) 计算「逻辑上的最晚加班时间」
+      //    - 当天晚上的用原始小时（如 22 点）
+      //    - 次日凌晨的用 24 + 小时（如 1 点 → 25）
+      const overtimeValues = [
+        ...sameDayHours.map((h) => h),
+        ...earlyHours.map((h) => 24 + h)
+      ]
+
+      if (overtimeValues.length === 0) {
+        // 这一天没有任何「下班后到次日上班前」的提交
+        return {
+          date: k,
+          latestHour: null,
+          latestHourNormalized: null
+        }
+      }
+
+      const latestHourNormalized = Math.max(...overtimeValues)
+
+      // latestHour 保留「当天自然日内」的最晚提交通常小时数，供前端需要时参考
+      const sameDayMax =
+        sameDayHours.length > 0 ? Math.max(...sameDayHours) : null
+
+      return {
+        date: k,
+        latestHour: sameDayMax,
+        latestHourNormalized
+      }
+    })
+    const dataLatestByDayFile = outputFilePath(
+      'data/overtime-latest-by-day.mjs',
+      outDir
+    )
+    const latestByDayModule = `export default ${JSON.stringify(latestByDay, null, 2)};\n`
+    writeTextFile(dataLatestByDayFile, latestByDayModule)
+    logDev(`Latest-by-day series 已导出: ${dataLatestByDayFile}`)
+
+    // 导出配置（供前端显示）
+    try {
+      const configFile = outputFilePath('data/config.mjs', outDir)
+      const cfg = {
+        startHour: opts.workStart || 9,
+        endHour: opts.workEnd || 18,
+        lunchStart: opts.lunchStart || 12,
+        lunchEnd: opts.lunchEnd || 14,
+        overnightCutoff
+      }
+      writeTextFile(
+        configFile,
+        `export default ${JSON.stringify(cfg, null, 2)};\n`
+      )
+      logDev(`Config 已导出: ${configFile}`)
+    } catch (e) {
+      console.warn('Export config failed:', e && e.message ? e.message : e)
+    }
+
+    startServer(opts.port || 3000, outDir).catch((err) => {
+      console.warn(
+        'Start server failed.',
+        err && err.message ? err.message : err
+      )
+    })
+  } catch (err) {
+    console.warn(
+      'Export data modules failed:',
+      err && err.message ? err.message : err
+    )
+  }
+}

package/src/{cli.mjs → index.mjs}

@@ -7,6 +7,7 @@ import ora from 'ora'
 import path from 'path'
 import { fileURLToPath } from 'url'
 
+import { parseOptions } from './cli/parseOptions.mjs'
 // eslint-disable-next-line no-unused-vars
 import { CLI_NAME } from './constants/index.mjs'
 import {
@@ -15,23 +16,27 @@ import {
   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 {
-  analyzeOvertime,
   renderOvertimeCsv,
   renderOvertimeTab,
   renderOvertimeText
-} from './overtime.mjs'
+} 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))
@@ -78,6 +83,8 @@ export function getWeekRange(periodStr) {
 }
 
 const main = async () => {
+  const startTime = performance.now()
+
   const program = new Command()
 
   program
@@ -90,6 +97,7 @@ const main = async () => {
     .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')
@@ -171,6 +179,7 @@ const main = async () => {
       (v) => parseInt(v, 10),
       3000
     )
+    .option('--debug', 'enable debug logs')
     .option(
       '--serve-only',
       '仅启动 web 服务，不导出或分析数据（使用 output-wukong/data 中已有的数据）'
@@ -179,6 +188,14 @@ const main = async () => {
     .parse()
 
   const opts = program.opts()
+
+  const config = parseOptions(opts)
+
+  // ❗只创建一次缓存实例
+  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')
@@ -308,16 +325,14 @@ const main = async () => {
   // --- 分组 ---
   const groups = opts.groupBy ? groupRecords(records, opts.groupBy) : null
 
+  // 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) {
-    const stats = analyzeOvertime(records, {
-      startHour: opts.workStart || opts.workStart === 0 ? opts.workStart : 9,
-      endHour: opts.workEnd || opts.workEnd === 0 ? opts.workEnd : 18,
-      lunchStart:
-        opts.lunchStart || opts.lunchStart === 0 ? opts.lunchStart : 12,
-      lunchEnd: opts.lunchEnd || opts.lunchEnd === 0 ? opts.lunchEnd : 14,
-      country: opts.country || 'CN'
-    })
+    const stats = getOvertimeStats(records)
     // Output to console
     console.log('\n--- Overtime analysis ---\n')
     console.log(renderOvertimeText(stats))
@@ -325,13 +340,13 @@ const main = async () => {
     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)
-      console.log(chalk.green(`overtime JSON 已导出: ${filepath}`))
+      logDev(`overtime JSON 已导出: ${filepath}`)
     }
     // Always write human readable overtime text to file (default: overtime.txt)
     const outBase = opts.out
@@ -348,218 +363,9 @@ const main = async () => {
     const overtimeCsvFileName = `overtime_${outBase}.csv`
     const overtimeCsvFile = outputFilePath(overtimeCsvFileName, outDir)
     writeTextFile(overtimeCsvFile, renderOvertimeCsv(stats))
-    console.log(chalk.green(`Overtime text 已导出: ${overtimeFile}`))
-    console.log(chalk.green(`Overtime table (tabs) 已导出: ${overtimeTabFile}`))
-    console.log(chalk.green(`Overtime CSV 已导出: ${overtimeCsvFile}`))
-
-    // If serve mode is enabled, write data modules and launch the web server
-    if (opts.serve) {
-      try {
-        const dataCommitsFile = outputFilePath('data/commits.mjs', outDir)
-        const commitsModule = `export default ${JSON.stringify(records, null, 2)};\n`
-        writeTextFile(dataCommitsFile, commitsModule)
-
-        const dataCommitsChangedFile = outputFilePath(
-          'data/author-changes.mjs',
-          outDir
-        )
-        const jsonText = renderAuthorChangesJson(records)
-
-        const commitsChangedModule = `export default ${JSON.stringify(jsonText, null, 2)};\n`
-        writeTextFile(dataCommitsChangedFile, commitsChangedModule)
-
-        const dataStatsFile = outputFilePath('data/overtime-stats.mjs', outDir)
-        const statsModule = `export default ${JSON.stringify(stats, null, 2)};\n`
-        writeTextFile(dataStatsFile, statsModule)
-
-        // 新增：每周趋势数据（用于前端图表）
-        const weekGroups = groupRecords(records, 'week')
-        const weekKeys = Object.keys(weekGroups).sort()
-        const weeklySeries = weekKeys.map((k) => {
-          const s = analyzeOvertime(weekGroups[k], {
-            startHour:
-              opts.workStart || opts.workStart === 0 ? opts.workStart : 9,
-            endHour: opts.workEnd || opts.workEnd === 0 ? opts.workEnd : 18,
-            lunchStart:
-              opts.lunchStart || opts.lunchStart === 0 ? opts.lunchStart : 12,
-            lunchEnd: opts.lunchEnd || opts.lunchEnd === 0 ? opts.lunchEnd : 14,
-            country: opts.country || 'CN'
-          })
-          return {
-            period: k,
-            range: getWeekRange(k),
-            total: s.total,
-            outsideWorkCount: s.outsideWorkCount,
-            outsideWorkRate: s.outsideWorkRate,
-            nonWorkdayCount: s.nonWorkdayCount,
-            nonWorkdayRate: s.nonWorkdayRate
-          }
-        })
-        const dataWeeklyFile = outputFilePath(
-          'data/overtime-weekly.mjs',
-          outDir
-        )
-        const weeklyModule = `export default ${JSON.stringify(weeklySeries, null, 2)};\n`
-        writeTextFile(dataWeeklyFile, weeklyModule)
-        console.log(chalk.green(`Weekly series 已导出: ${dataWeeklyFile}`))
-
-        // 新增：每月趋势数据（用于前端图表）
-        const monthGroups2 = groupRecords(records, 'month')
-        const monthKeys2 = Object.keys(monthGroups2).sort()
-        const monthlySeries = monthKeys2.map((k) => {
-          const s = analyzeOvertime(monthGroups2[k], {
-            startHour:
-              opts.workStart || opts.workStart === 0 ? opts.workStart : 9,
-            endHour: opts.workEnd || opts.workEnd === 0 ? opts.workEnd : 18,
-            lunchStart:
-              opts.lunchStart || opts.lunchStart === 0 ? opts.lunchStart : 12,
-            lunchEnd: opts.lunchEnd || opts.lunchEnd === 0 ? opts.lunchEnd : 14,
-            country: opts.country || 'CN'
-          })
-          return {
-            period: k,
-            total: s.total,
-            outsideWorkCount: s.outsideWorkCount,
-            outsideWorkRate: s.outsideWorkRate,
-            nonWorkdayCount: s.nonWorkdayCount,
-            nonWorkdayRate: s.nonWorkdayRate
-          }
-        })
-        const dataMonthlyFile = outputFilePath(
-          'data/overtime-monthly.mjs',
-          outDir
-        )
-        const monthlyModule = `export default ${JSON.stringify(monthlySeries, null, 2)};\n`
-        writeTextFile(dataMonthlyFile, monthlyModule)
-        console.log(chalk.green(`Monthly series 已导出: ${dataMonthlyFile}`))
-
-        // 新增：每日最晚提交小时（用于显著展示加班严重程度）
-        const dayGroups2 = groupRecords(records, 'day')
-        const dayKeys2 = Object.keys(dayGroups2).sort()
-
-        // 次日凌晨归并窗口（默认 6 点前仍算前一天的加班）
-        const overnightCutoff = Number.isFinite(opts.overnightCutoff)
-          ? opts.overnightCutoff
-          : 6
-        // 次日上班时间（默认按 workStart，若未指定则 9 点）
-        const workStartHour =
-          opts.workStart || opts.workStart === 0 ? opts.workStart : 9
-        const workEndHour =
-          opts.workEnd || opts.workEnd === 0 ? opts.workEnd : 18
-
-        // 有些日期「本身没有 commit」，但第二天凌晨有提交要归并到这一天，
-        // 需要补出这些“虚拟日期”，否则 latestByDay 会漏掉这天。
-        const virtualPrevDays = new Set()
-        records.forEach((r) => {
-          const d = new Date(r.date)
-          if (Number.isNaN(d.valueOf())) return
-          const h = d.getHours()
-          if (h < 0 || h >= overnightCutoff || h >= workStartHour) return
-          const curDay = dayjs(d).format('YYYY-MM-DD')
-          const prevDay = dayjs(curDay).subtract(1, 'day').format('YYYY-MM-DD')
-          if (!dayGroups2[prevDay]) {
-            virtualPrevDays.add(prevDay)
-          }
-        })
-
-        const allDayKeys = Array.from(
-          new Set([...dayKeys2, ...virtualPrevDays])
-        ).sort()
-
-        const latestByDay = allDayKeys.map((k) => {
-          const list = dayGroups2[k] || []
-
-          // 1) 当天「下班后」的提交：只统计 >= workEndHour 的小时
-          const sameDayHours = list
-            .map((r) => new Date(r.date))
-            .filter((d) => !Number.isNaN(d.valueOf()))
-            .map((d) => d.getHours())
-            .filter((h) => h >= workEndHour && h < 24)
-
-          // 2) 次日凌晨、但仍算前一日加班的提交
-          const nextKey = dayjs(k).add(1, 'day').format('YYYY-MM-DD')
-          const early = dayGroups2[nextKey] || []
-          const earlyHours = early
-            .map((r) => new Date(r.date))
-            .filter((d) => !Number.isNaN(d.valueOf()))
-            .map((d) => d.getHours())
-            // 只看 [0, overnightCutoff) 之间的小时，
-            // 并且默认认为 < workStartHour 属于「次日上班前」
-            .filter(
-              (h) =>
-                h >= 0 &&
-                h < overnightCutoff &&
-                // 保护性判断：若有人把 overnightCutoff 设得大于上班时间，
-                // 我们仍然只统计到上班时间为止
-                h < workStartHour
-            )
-
-          // 3) 计算「逻辑上的最晚加班时间」
-          //    - 当天晚上的用原始小时（如 22 点）
-          //    - 次日凌晨的用 24 + 小时（如 1 点 → 25）
-          const overtimeValues = [
-            ...sameDayHours.map((h) => h),
-            ...earlyHours.map((h) => 24 + h)
-          ]
-
-          if (overtimeValues.length === 0) {
-            // 这一天没有任何「下班后到次日上班前」的提交
-            return {
-              date: k,
-              latestHour: null,
-              latestHourNormalized: null
-            }
-          }
-
-          const latestHourNormalized = Math.max(...overtimeValues)
-
-          // latestHour 保留「当天自然日内」的最晚提交通常小时数，供前端需要时参考
-          const sameDayMax =
-            sameDayHours.length > 0 ? Math.max(...sameDayHours) : null
-
-          return {
-            date: k,
-            latestHour: sameDayMax,
-            latestHourNormalized
-          }
-        })
-        const dataLatestByDayFile = outputFilePath(
-          'data/overtime-latest-by-day.mjs',
-          outDir
-        )
-        const latestByDayModule = `export default ${JSON.stringify(latestByDay, null, 2)};\n`
-        writeTextFile(dataLatestByDayFile, latestByDayModule)
-        console.log(
-          chalk.green(`Latest-by-day series 已导出: ${dataLatestByDayFile}`)
-        )
-
-        // 导出配置（供前端显示）
-        try {
-          const configFile = outputFilePath('data/config.mjs', outDir)
-          const cfg = {
-            startHour: opts.workStart || 9,
-            endHour: opts.workEnd || 18,
-            lunchStart: opts.lunchStart || 12,
-            lunchEnd: opts.lunchEnd || 14,
-            overnightCutoff
-          }
-          writeTextFile(
-            configFile,
-            `export default ${JSON.stringify(cfg, null, 2)};\n`
-          )
-          console.log(chalk.green(`Config 已导出: ${configFile}`))
-        } catch (e) {
-          console.warn('Export config failed:', e && e.message ? e.message : e)
-        }
-
-        startServer(opts.port || 3000, outDir).catch(() => {})
-      } catch (err) {
-        console.warn(
-          'Export data modules failed:',
-          err && err.message ? err.message : err
-        )
-      }
-    }
+    logDev(`Overtime text 已导出: ${overtimeFile}`)
+    logDev(`Overtime table (tabs) 已导出: ${overtimeTabFile}`)
+    logDev(`Overtime CSV 已导出: ${overtimeCsvFile}`)
 
     // 按月输出 ... 保持原逻辑
     const perPeriodFormats = String(opts.perPeriodFormats || '')
@@ -578,15 +384,7 @@ const main = async () => {
       const monthKeys = Object.keys(monthGroups).sort()
       monthKeys.forEach((k) => {
         const groupRecs = monthGroups[k]
-        const s = analyzeOvertime(groupRecs, {
-          startHour:
-            opts.workStart || opts.workStart === 0 ? opts.workStart : 9,
-          endHour: opts.workEnd || opts.workEnd === 0 ? opts.workEnd : 18,
-          lunchStart:
-            opts.lunchStart || opts.lunchStart === 0 ? opts.lunchStart : 12,
-          lunchEnd: opts.lunchEnd || opts.lunchEnd === 0 ? opts.lunchEnd : 14,
-          country: opts.country || 'CN'
-        })
+        const s = getOvertimeStats(groupRecs)
         monthlyContent += `===== ${k} =====\n`
         monthlyContent += `${renderOvertimeText(s)}\n\n`
         // Also write a single file per month under 'month/' folder
@@ -594,9 +392,7 @@ const main = async () => {
           const perMonthFileName = `month/overtime_${outBase}_${k}.txt`
           const perMonthFile = outputFilePath(perMonthFileName, outDir)
           writeTextFile(perMonthFile, renderOvertimeText(s))
-          console.log(
-            chalk.green(`Overtime 月度(${k}) 已导出: ${perMonthFile}`)
-          )
+          logDev(`Overtime 月度(${k}) 已导出: ${perMonthFile}`)
           // per-period CSV / Tab format (按需生成)
           if (perPeriodFormats.includes('csv')) {
             try {
@@ -605,10 +401,8 @@ const main = async () => {
                 outputFilePath(perMonthCsvName, outDir),
                 renderOvertimeCsv(s)
               )
-              console.log(
-                chalk.green(
-                  `Overtime 月度(CSV)(${k}) 已导出: ${outputFilePath(perMonthCsvName, outDir)}`
-                )
+              logDev(
+                `Overtime 月度(CSV)(${k}) 已导出: ${outputFilePath(perMonthCsvName, outDir)}`
               )
             } catch (err) {
               console.warn(
@@ -624,10 +418,8 @@ const main = async () => {
                 outputFilePath(perMonthTabName, outDir),
                 renderOvertimeTab(s)
               )
-              console.log(
-                chalk.green(
-                  `Overtime 月度(Tab)(${k}) 已导出: ${outputFilePath(perMonthTabName, outDir)}`
-                )
+              logDev(
+                `Overtime 月度(Tab)(${k}) 已导出: ${outputFilePath(perMonthTabName, outDir)}`
               )
             } catch (err) {
               console.warn(
@@ -645,7 +437,7 @@ const main = async () => {
       })
       if (!opts.perPeriodOnly) {
         writeTextFile(monthlyFile, monthlyContent)
-        console.log(chalk.green(`Overtime 月度汇总 已导出: ${monthlyFile}`))
+        logDev(`Overtime 月度汇总 已导出: ${monthlyFile}`)
       }
       // per-period Excel (sheets or files)
       if (perPeriodFormats.includes('xlsx')) {
@@ -658,9 +450,7 @@ const main = async () => {
               stats: opts.stats,
               gerrit: opts.gerrit
             })
-            console.log(
-              chalk.green(`Overtime 月度(XLSX) 已导出: ${monthXlsxFile}`)
-            )
+            logDev(`Overtime 月度(XLSX) 已导出: ${monthXlsxFile}`)
           } catch (err) {
             console.warn(
               'Export month XLSX (sheets) failed:',
@@ -710,22 +500,16 @@ const main = async () => {
       const weekKeys = Object.keys(weekGroups).sort()
       weekKeys.forEach((k) => {
         const groupRecs = weekGroups[k]
-        const s = analyzeOvertime(groupRecs, {
-          startHour:
-            opts.workStart || opts.workStart === 0 ? opts.workStart : 9,
-          endHour: opts.workEnd || opts.workEnd === 0 ? opts.workEnd : 18,
-          lunchStart:
-            opts.lunchStart || opts.lunchStart === 0 ? opts.lunchStart : 12,
-          lunchEnd: opts.lunchEnd || opts.lunchEnd === 0 ? opts.lunchEnd : 14,
-          country: opts.country || 'CN'
-        })
+        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}`))
+          // console.log(chalk.green(`Overtime 周度(${k}) 已导出: ${perWeekFile}`))
+          logDev(`Overtime 周度(${k}) 已导出: ${perWeekFile}`)
+
           // eslint-disable-next-line no-shadow
           const perPeriodFormats = String(opts.perPeriodFormats || '')
             .split(',')
@@ -743,10 +527,8 @@ const main = async () => {
                 outputFilePath(perWeekCsvName, outDir),
                 renderOvertimeCsv(s)
               )
-              console.log(
-                chalk.green(
-                  `Overtime 周度(CSV)(${k}) 已导出: ${outputFilePath(perWeekCsvName, outDir)}`
-                )
+              logDev(
+                `Overtime 周度(CSV)(${k}) 已导出: ${outputFilePath(perWeekCsvName, outDir)}`
               )
             } catch (err) {
               console.warn(
@@ -762,10 +544,8 @@ const main = async () => {
                 outputFilePath(perWeekTabName, outDir),
                 renderOvertimeTab(s)
               )
-              console.log(
-                chalk.green(
-                  `Overtime 周度(Tab)(${k}) 已导出: ${outputFilePath(perWeekTabName, outDir)}`
-                )
+              logDev(
+                `Overtime 周度(Tab)(${k}) 已导出: ${outputFilePath(perWeekTabName, outDir)}`
               )
             } catch (err) {
               console.warn(
@@ -782,7 +562,7 @@ const main = async () => {
         }
       })
       writeTextFile(weeklyFile, weeklyContent)
-      console.log(chalk.green(`Overtime 周度汇总 已导出: ${weeklyFile}`))
+      logDev(`Overtime 周度汇总 已导出: ${weeklyFile}`)
     } catch (err) {
       console.warn(
         'Generate weekly overtime failed:',
@@ -798,8 +578,8 @@ const main = async () => {
     writeJSON(filepath, groups || records)
     const jsonText = renderAuthorChangesJson(records)
     writeJSON(outputFilePath('author-changes.json', outDir), jsonText)
-    console.log(chalk.green(`JSON 已导出: ${filepath}`))
-    spinner.succeed('Done')
+    logDev(`JSON 已导出: ${filepath}`)
+    handleSuccess({ startTime, spinner })
     return
   }
 
@@ -809,13 +589,16 @@ const main = async () => {
     const text = renderText(records, groups, { showGerrit: !!opts.gerrit })
     writeTextFile(filepath, text)
     writeTextFile(
-      outputFilePath('author-changes.text', outDir),
+      outputFilePath('author-changes.txt', outDir),
       renderChangedLinesText(records)
     )
 
-    console.log(text)
-    console.log(chalk.green(`文本已导出: ${filepath}`))
-    spinner.succeed('Done')
+    console.log('\n Commits List:\n', text, '\n')
+
+    logDev(`文本已导出: ${filepath}`)
+
+    handleSuccess({ startTime, spinner })
+
     return
   }
 
@@ -835,9 +618,10 @@ const main = async () => {
     )
     const text = renderText(records, groups)
     writeTextFile(txtPath, text)
-    console.log(chalk.green(`Excel 已导出: ${excelPath}`))
-    console.log(chalk.green(`文本已自动导出: ${txtPath}`))
-    spinner.succeed('Done')
+    logDev(`Excel 已导出: ${excelPath}`)
+    logDev(`文本已自动导出: ${txtPath}`)
+
+    handleSuccess({ startTime, spinner })
   }
 
   await autoCheckUpdate()

package/src/lib/configStore.mjs

@@ -0,0 +1,11 @@
+const store = {
+  debug: false,
+}
+
+export function setConfig(key, value) {
+  store[key] = value
+}
+
+export function getConfig(key) {
+  return store[key]
+}

package/src/lib/memoize.mjs

@@ -0,0 +1,14 @@
+// memoize.mjs
+export function memoize(fn) {
+  const cache = new Map()
+
+  return function (...args) {
+    const key = JSON.stringify(args)
+    if (cache.has(key)) {
+      return cache.get(key)
+    }
+    const result = fn(...args)
+    cache.set(key, result)
+    return result
+  }
+}

package/src/overtime/createOvertimeStats.mjs

@@ -0,0 +1,11 @@
+import { analyzeOvertime } from './overtime.mjs';
+
+export function createOvertimeStats(defaultConfig = {}) {
+  return function getOvertimeStats(records, overrides) {
+    const config = overrides
+      ? { ...defaultConfig, ...overrides }
+      : defaultConfig;
+
+    return analyzeOvertime(records, config);
+  };
+}

package/src/utils/analyzeOvertimeCached.mjs

@@ -0,0 +1,7 @@
+// analyzeOvertimeCached.mjs
+import { memoize } from '../lib/memoize.mjs'
+import {
+  analyzeOvertime
+} from './overtime.mjs'
+
+export const analyzeOvertimeCached = memoize(analyzeOvertime)

package/src/utils/emoji.mjs

@@ -0,0 +1,83 @@
+/**
+ * @file: emoji.mjs
+ * @description:
+ * ✅ 智能判断终端是否支持 Emoji，并提供统一包装函数和开关变量。
+ *
+ * 📌 支持判断逻辑说明：
+ * 判断点	是否禁用 Emoji
+ * WUKONG_NO_EMOJI=1	        ✅ 是（强制关闭）
+ * WUKONG_NO_EMOJI=0	        ❌ 否（强制启用）
+ * TERM=dumb（能力极差）	        ✅ 是
+ * Windows + 非现代终端（无 WT_SESSION/TERM_PROGRAM） ✅ 是
+ * Git Bash / Windows Terminal / VSCode Terminal / macOS / Linux	❌ 不禁用
+ *
+ * @author:
+ * @created: 2025-08-05
+ */
+import dotenv from 'dotenv'
+import process from 'node:process'
+
+dotenv.config({ quiet: true })
+
+// ========== 用户设置 ==========
+
+// 用户通过环境变量控制 Emoji
+const userForceSetting = process.env.WUKONG_NO_EMOJI
+
+// ========== 终端和平台判断 ==========
+
+// 判断终端是否为 dumb（极简终端）
+const isDumb = () => process.env.TERM === 'dumb'
+
+// 检测是否 Git Bash（支持 Emoji）
+const isTrueGitBash = () =>
+  process.platform === 'win32' &&
+  process.env.SHELL?.toLowerCase().includes('bash')
+
+// 判断是否为现代 Windows 终端（如 Windows Terminal 或 VSCode Terminal）
+const isModernWindowsTerminal = () =>
+  process.platform === 'win32' &&
+  (process.env.WT_SESSION ||
+    process.env.TERM_PROGRAM?.toLowerCase().includes('vscode'))
+
+// ========== Emoji 渲染能力检测 ==========
+
+// 尝试写入一个 emoji 判断 stdout 是否支持
+const canRenderEmoji = () => {
+  try {
+    return process.stdout.isTTY && Buffer.from('✅', 'utf8').length > 1
+  } catch {
+    return false
+  }
+}
+
+// ========== Emoji 启用判断 ==========
+
+export const emojiEnabled =
+  // eslint-disable-next-line no-nested-ternary
+  userForceSetting === '0'
+    ? true // 强制启用
+    : userForceSetting === '1'
+      ? false // 强制禁用
+      : !isDumb() &&
+        canRenderEmoji() &&
+        (process.platform !== 'win32' ||
+          isModernWindowsTerminal() ||
+          isTrueGitBash())
+
+/**
+ * 包装 Emoji（根据环境决定是否返回 emoji 或备用字符）
+ * @param {string} emoji - emoji 表情字符
+ * @param {string} fallback - 替代字符（默认空字符串）
+ * @returns {string}
+ */
+export function e(emoji, fallback = '') {
+  return emojiEnabled ? emoji : fallback
+}
+
+// ========== 可选调试输出 ==========
+/*
+if (!emojiEnabled) {
+  console.log('⚠️ 当前终端未启用 Emoji，已自动禁用（如需强制启用请设置 WUKONG_NO_EMOJI=0）')
+}
+*/

package/src/utils/exitWithTime.mjs

@@ -0,0 +1,17 @@
+import { Chalk } from 'chalk'
+import { performance } from 'perf_hooks'
+
+// 强制开启 truecolor chalk v5
+import { costTimer } from './timer.mjs'
+
+const chalk = new Chalk({ level: 3 }) // 强制开启 truecolor chalk v5
+
+// 退出前打印耗时并退出
+export const exitWithTime = (start, exitCode = 0, exitNow = false) => {
+  const end = performance.now()
+  const timeMsg = costTimer(start, end)
+  console.log(chalk.green(`\n${timeMsg}\n`))
+  if (exitNow) {
+    process.exit(exitCode)
+  }
+}

package/src/utils/getWeekRange.mjs

@@ -0,0 +1,16 @@
+import dayjs from 'dayjs'
+
+/** 将 "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)
+
+  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')
+  }
+}

package/src/utils/handleSuccess.mjs

@@ -0,0 +1,12 @@
+import { Chalk } from 'chalk'
+import { performance } from 'perf_hooks'
+
+import { exitWithTime } from './exitWithTime.mjs'
+import { costTimer } from './timer.mjs'
+
+export const handleSuccess = ({ message = 'Done', startTime, spinner }) => {
+  spinner.succeed(message)
+
+  // 如果需要退出，可以调用 exitWithTime
+  exitWithTime(startTime, 0)
+}

package/src/utils/logDev.mjs

@@ -0,0 +1,19 @@
+/**
+ * @file: devLog.mjs
+ * @description:
+ * @author: King Monkey
+ * @created: 2025-08-04 16:25
+ */
+import { getConfig } from '../lib/configStore.mjs'
+import { logger } from './logger.mjs'
+
+/**
+ * 开发环境下输出调试信息
+ * 推荐用于局部调试
+ */
+export function logDev(...args) {
+  if (getConfig('debug')) {
+    const msg = args.join(' ')
+    logger.debug(msg)
+  }
+}

package/src/utils/logger.mjs

@@ -0,0 +1,145 @@
+/**
+ * @file: logger.mjs
+ * @description:
+ *  避免了 Windows 上查看日志文件中文乱码
+ *  使用 stripAnsi(msg) 过滤终端颜色代码
+ *  prefix 使用 emoji，也兼容终端彩色输出
+ *
+ *  在日志文件首次创建时：
+    写入了 UTF-8 的 BOM（Byte Order Mark）
+    让 Windows 系统（尤其是旧版记事本）自动识别为 UTF-8 编码
+ * @author: King Monkey
+ * @created: 2025-08-02 11:59
+ */
+// scripts/logger.mjs
+import { Chalk } from 'chalk'
+import { format } from 'date-fns'
+import fs from 'fs-extra'
+import path from 'node:path'
+import process from 'node:process'
+import stripAnsi from 'strip-ansi'
+
+import { e } from './emoji.mjs'
+
+const chalk = new Chalk({ level: 3 }) // 强制开启 truecolor chalk v5
+
+// 💡 自动启用颜色，即使 isTTY 无效（Git Bash、CI 等） chalk v4
+/*
+if (!process.stdout.isTTY || chalk.level === 0) {
+  chalk.level = 3
+}
+ */
+
+// 缓存起来文件的日志路径
+let cachedDay = ''
+let cachedPath = ''
+
+// // 彩色前缀
+// const prefix = {
+//   info: chalk.cyan('ℹ'),
+//   success: chalk.green('✔'),
+//   error: chalk.red('✖'),
+//   warn: chalk.yellow('⚠'),
+//   debug: chalk.gray('➤')
+// }
+
+// 🔧 1. 修改 prefix：只保留 emoji，不带颜色
+const prefix = {
+  info: e('➤', '[i]'),
+  success: e('✔', '[✓]'),
+  error: e('✖', '[x]'),
+  warn: e('⚠', '[!]'),
+  debug: e('➤', '->')
+}
+
+// 时间戳 [HH:mm:ss]
+// 短时间戳用于终端输出
+const shortTimestamp = () =>
+  chalk.dim(`[${new Date().toTimeString().slice(0, 8)}]`)
+
+// 日志文件中用本地完整时间
+const fullTimestamp = () => format(new Date(), 'yyyy-MM-dd HH:mm:ss')
+
+// 默认日志路径：项目根目录 logs/yyyy-mm-dd.log
+const getLogFilePath = () => {
+  const day = format(new Date(), 'yyyy-MM-dd')
+  // 缓存起来文件的日志路径
+  const shouldRecreate =
+    cachedDay !== day || !cachedPath || !fs.existsSync(cachedPath)
+  if (shouldRecreate) {
+    cachedDay = day
+    const logDir = path.resolve(process.cwd(), 'logs', day)
+    const logPath = path.join(logDir, 'wukong.log')
+    fs.ensureDirSync(logDir)
+    /*
+    在日志文件首次创建时：
+
+    写入了 UTF-8 的 BOM（Byte Order Mark）
+
+    让 Windows 系统（尤其是旧版记事本）自动识别为 UTF-8 编码
+    */
+    if (!fs.existsSync(logPath)) {
+      fs.ensureFileSync(logPath)
+      fs.writeFileSync(logPath, '\uFEFF', { encoding: 'utf-8' }) // 添加 BOM
+    }
+
+    cachedPath = logPath
+    return logPath
+  }
+  return cachedPath
+}
+
+// 写入日志（同步 + 追加）
+const writeToFile = (level, msg, newline) => {
+  const logPath = getLogFilePath()
+  if (!logPath) {
+    console.error('❌ 日志路径未生成，终止写入')
+    return
+  }
+  const newLineString = newline ? '\n' : ''
+  const line = `${newLineString}[${fullTimestamp()}] [${level.toUpperCase()}] ${stripAnsi(msg)}\n`
+  fs.appendFileSync(logPath, line, 'utf-8')
+}
+
+// 主函数工厂，支持 { write: true } 控制是否写文件
+function createLogger(level, colorFn, outFn = console.log) {
+  return (...args) => {
+    let options = {}
+    if (
+      args.length &&
+      typeof args[args.length - 1] === 'object' &&
+      args[args.length - 1] !== null &&
+      ('write' in args[args.length - 1] || 'newline' in args[args.length - 1])
+    ) {
+      options = args.pop()
+    }
+
+    const msg = args
+      .map((arg) =>
+        typeof arg === 'object' ? JSON.stringify(arg, null, 2) : String(arg)
+      )
+      .join(' ')
+
+    // 🔧 2. 修改拼接方式，colorFn 统一处理 prefix + msg
+    const line = `${shortTimestamp()} ${colorFn(`${prefix[level]} ${msg}`)}`
+
+    if (options.newline) {
+      outFn('')
+    }
+    outFn(line)
+
+    if (options.write) {
+      writeToFile(level, msg, options.newline)
+    }
+  }
+}
+
+export const logger = {
+  info: createLogger('info', chalk.cyan),
+  success: createLogger('success', chalk.green),
+  error: createLogger('error', chalk.red, console.error),
+  warn: createLogger('warn', chalk.yellow, console.warn),
+  debug: createLogger('debug', chalk.white)
+}
+
+export default logger

package/src/utils/timer.mjs

@@ -0,0 +1,35 @@
+import chalk from 'chalk'
+
+export const costTimer = (startTime, endTime) => {
+  if (typeof startTime !== 'number' || typeof endTime !== 'number') {
+    console.error(
+      chalk.red.bold('Error: startTime and endTime must be numbers.')
+    )
+    return
+  }
+
+  const durationMs = endTime - startTime // 时间差（以毫秒为单位）
+  if (durationMs < 0) {
+    console.error(
+      chalk.red.bold('Error: endTime must be greater than startTime.')
+    )
+    return
+  }
+
+  const costSeconds = durationMs / 1000 // 转换为秒
+  const costMin = costSeconds / 60 // 转换为分钟
+  const costHour = costMin / 60 // 转换为小时
+
+  let displayTime = ''
+  if (costSeconds < 60) {
+    displayTime = `${costSeconds.toFixed(2)} seconds`
+  } else if (costMin < 60) {
+    displayTime = `${costMin.toFixed(3)} minutes`
+  } else {
+    displayTime = `${costHour.toFixed(3)} hours`
+  }
+
+
+
+  return `⏱ Execution time: ${displayTime}`
+}