wukong-gitlog-cli 0.0.15 → 1.0.2

package/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 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.2](https://github.com/tomatobybike/wukong-gitlog-cli/compare/v1.0.1...v1.0.2) (2025-11-28)
+
+
+### Features
+
+* 🎸 await zx ([79343d6](https://github.com/tomatobybike/wukong-gitlog-cli/commit/79343d6722c19b8c6381211b1a9b35923443abb5))
+
+### [1.0.1](https://github.com/tomatobybike/wukong-gitlog-cli/compare/v0.0.15...v1.0.1) (2025-11-28)
+
+
+### Features
+
+* 🎸 show version ([4a81b72](https://github.com/tomatobybike/wukong-gitlog-cli/commit/4a81b7222100521dcacda4d1d8ff96db2d669a3c))
+* 🎸 version ([8fa81d6](https://github.com/tomatobybike/wukong-gitlog-cli/commit/8fa81d64e1a6c44e4b4327fbb6a27559ed2b5372))
+
+
+### Bug Fixes
+
+* 🐛 eslint ([17701b2](https://github.com/tomatobybike/wukong-gitlog-cli/commit/17701b248802532a63d5b5896cf331de29e07c07))
+
 ### [0.0.15](https://github.com/tomatobybike/wukong-gitlog-cli/compare/v0.0.14...v0.0.15) (2025-11-28)
 
 

package/bin/wukong-gitlog-cli

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wukong-gitlog-cli",
-  "version": "0.0.15",
+  "version": "1.0.2",
   "description": "Advanced Git commit log exporter with Excel/JSON/TXT output, grouping, stats and CLI.",
   "keywords": [
     "git",
@@ -90,13 +90,15 @@
     ]
   },
   "dependencies": {
-    "chalk": "5.6.0",
     "commander": "12.1.0",
     "dayjs": "1.11.19",
     "date-holidays": "2.1.1",
     "string-width": "5.1.2",
     "exceljs": "4.4.0",
-    "zx": "7.2.4"
+    "zx": "7.2.4",
+    "is-online": "12.0.2",
+    "boxen": "8.0.1",
+    "chalk": "5.6.2"
   },
   "devDependencies": {
     "@trivago/prettier-plugin-sort-imports": "5.2.2",

package/src/cli.mjs

@@ -1,405 +1,629 @@
-import { Command } from 'commander';
-import chalk from 'chalk';
-import path from 'path';
-import { getGitLogs } from './git.mjs';
-import { renderText } from './text.mjs';
-import { analyzeOvertime, renderOvertimeText, renderOvertimeTab, renderOvertimeCsv } from './overtime.mjs';
-import { startServer } from './server.mjs';
-import { exportExcel, exportExcelPerPeriodSheets } from './excel.mjs';
-import { groupRecords, writeJSON, writeTextFile, outputFilePath } from './utils/index.mjs';
+import chalk from 'chalk'
+import { Command } from 'commander'
+import fs from 'fs'
+import path from 'path'
+import { fileURLToPath } from 'url'
 
-const program = new Command();
+import { CLI_NAME } from './constants/index.mjs'
+import { exportExcel, exportExcelPerPeriodSheets } from './excel.mjs'
+import { getGitLogs } from './git.mjs'
+import {
+  analyzeOvertime,
+  renderOvertimeCsv,
+  renderOvertimeTab,
+  renderOvertimeText
+} from './overtime.mjs'
+import { startServer } from './server.mjs'
+import { renderText } from './text.mjs'
+import { checkUpdateWithPatch } from './utils/checkUpdate.mjs'
+import {
+  groupRecords,
+  outputFilePath,
+  writeJSON,
+  writeTextFile
+} from './utils/index.mjs'
+import { showVersionInfo } from './utils/showVersionInfo.mjs'
 
-program
-  .name('git-commits')
-  .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('--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('--out <file>', '输出文件名（不含路径）')
-  .option('--out-dir <dir>', '自定义输出目录，支持相对路径或绝对路径，例如 `--out-dir ../output`')
-  .option('--out-parent', '将输出目录放到当前工程的父目录的 `output/`（等同于 `--out-dir ../output`）')
-  .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/data 下生成数据文件）')
-  .option('--port <n>', '本地 web 服务端口（默认 3000）', (v) => parseInt(v, 10), 3000)
-  .option('--serve-only', '仅启动 web 服务，不导出或分析数据（使用 output/data 中已有的数据）')
-  .parse();
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
 
-const opts = program.opts();
-// compute output directory root early (so serve-only can use it)
-const outDir = opts.outParent
-  ? path.resolve(process.cwd(), '..', 'output')
-  : opts.outDir || undefined;
+const pkg = JSON.parse(
+  fs.readFileSync(path.resolve(__dirname, '../package.json'), 'utf8')
+)
 
-(async () => {
+const PKG_NAME = pkg.name
+const VERSION = pkg.version
+
+const autoCheckUpdate = async () => {
+  // === CLI 主逻辑完成后提示更新 ===
+  await checkUpdateWithPatch({
+    pkg: {
+      name: PKG_NAME,
+      version: VERSION
+    },
+    force: true
+  })
+}
+
+const version = async () => {
+  showVersionInfo(VERSION)
+  await autoCheckUpdate()
+  process.exit(0)
+}
+
+const main = async () => {
+  const program = new Command()
+
+  program
+    .name('git-commits')
+    .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('--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('--out <file>', '输出文件名（不含路径）')
+    .option(
+      '--out-dir <dir>',
+      '自定义输出目录，支持相对路径或绝对路径，例如 `--out-dir ../output`'
+    )
+    .option(
+      '--out-parent',
+      '将输出目录放到当前工程的父目录的 `output/`（等同于 `--out-dir ../output`）'
+    )
+    .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/data 下生成数据文件）'
+    )
+    .option(
+      '--port <n>',
+      '本地 web 服务端口（默认 3000）',
+      (v) => parseInt(v, 10),
+      3000
+    )
+    .option(
+      '--serve-only',
+      '仅启动 web 服务，不导出或分析数据（使用 output/data 中已有的数据）'
+    )
+    .option('--version', 'show version information')
+    .parse()
+
+  const opts = program.opts()
+  // compute output directory root early (so serve-only can use it)
+  const outDir = opts.outParent
+    ? path.resolve(process.cwd(), '..', 'output')
+    : opts.outDir || undefined
+
+  if (opts.version) {
+    await version()
+    return
+  }
   // if serve-only is requested, start server and exit
   if (opts.serveOnly) {
     try {
-      await startServer(opts.port || 3000, outDir);
+      await startServer(opts.port || 3000, outDir)
     } catch (err) {
-      console.warn('Start server failed:', err && err.message ? err.message : err);
-      process.exit(1);
+      console.warn(
+        'Start server failed:',
+        err && err.message ? err.message : err
+      )
+      process.exit(1)
     }
-    return;
+    return
   }
 
-  let records = await getGitLogs(opts);
+  let records = await getGitLogs(opts)
 
   // compute output directory root if user provided one or wants parent
 
   // --- Gerrit 地址处理（若提供） ---
   if (opts.gerrit) {
-    const prefix = opts.gerrit;
+    const prefix = opts.gerrit
     // support optional changeNumber resolution via Gerrit REST API
-    const { gerritApi, gerritAuth } = opts;
+    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 = {};
+      const cache = new Map()
+      const headers = {}
       if (gerritAuth) {
         if (gerritAuth.includes(':')) {
-          headers.Authorization = `Basic ${Buffer.from(gerritAuth).toString('base64')}`;
+          headers.Authorization = `Basic ${Buffer.from(gerritAuth).toString('base64')}`
         } else {
-          headers.Authorization = `Bearer ${gerritAuth}`;
+          headers.Authorization = `Bearer ${gerritAuth}`
         }
       }
       const fetchGerritJson = async (url) => {
         try {
-          const res = await fetch(url, { headers });
-          const txt = await res.text();
+          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);
+          const jsonText = txt.replace(/^\)\]\}'\n/, '')
+          return JSON.parse(jsonText)
         } catch (err) {
-          return null;
+          return null
         }
-      };
+      }
       const resolveChangeNumber = async (r) => {
         // try changeId first
         if (r.changeId) {
-          if (cache.has(r.changeId)) return cache.get(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);
+          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;
+            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);
+          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;
+            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 (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;
+            cache.set(r.hash, j[0]._number)
+            return j[0]._number
           }
         }
-        return null;
-      };
+        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 };
+          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) }));
+      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;
+        let gerritUrl
         if (prefix.includes('{{changeId}}')) {
-          const changeId = r.changeId || r.hash;
-          gerritUrl = prefix.replace('{{changeId}}', changeId);
+          const changeId = r.changeId || r.hash
+          gerritUrl = prefix.replace('{{changeId}}', changeId)
         } else if (prefix.includes('{{hash}}')) {
-          gerritUrl = prefix.replace('{{hash}}', r.hash);
+          gerritUrl = prefix.replace('{{hash}}', r.hash)
         } else {
-          gerritUrl = prefix.endsWith('/') ? `${prefix}${r.hash}` : `${prefix}/${r.hash}`;
+          gerritUrl = prefix.endsWith('/')
+            ? `${prefix}${r.hash}`
+            : `${prefix}/${r.hash}`
         }
-        return { ...r, gerrit: gerritUrl };
-      });
+        return { ...r, gerrit: gerritUrl }
+      })
     }
   }
 
   // --- 分组 ---
-  const groups = opts.groupBy ? groupRecords(records, opts.groupBy) : null;
+  const groups = opts.groupBy ? groupRecords(records, opts.groupBy) : null
 
   // --- 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,
+      lunchStart:
+        opts.lunchStart || opts.lunchStart === 0 ? opts.lunchStart : 12,
       lunchEnd: opts.lunchEnd || opts.lunchEnd === 0 ? opts.lunchEnd : 14,
-      country: opts.country || 'CN',
-    });
+      country: opts.country || 'CN'
+    })
     // Output to console
-    console.log('\n--- Overtime analysis ---\n');
-    console.log(renderOvertimeText(stats));
+    console.log('\n--- Overtime analysis ---\n')
+    console.log(renderOvertimeText(stats))
     // 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}`));
+      const file = opts.out || 'overtime.json'
+      const filepath = outputFilePath(file, outDir)
+      writeJSON(filepath, stats)
+      console.log(chalk.green(`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));
+    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));
+    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));
-    console.log(chalk.green(`Overtime text 已导出: ${overtimeFile}`));
-    console.log(chalk.green(`Overtime table (tabs) 已导出: ${overtimeTabFile}`));
-    console.log(chalk.green(`Overtime CSV 已导出: ${overtimeCsvFile}`));
+    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 dataStatsFile = outputFilePath('data/overtime-stats.mjs', outDir);
-        const statsModule = `export default ${JSON.stringify(stats, null, 2)};\n`;
-        writeTextFile(dataStatsFile, statsModule);
+        const dataCommitsFile = outputFilePath('data/commits.mjs', outDir)
+        const commitsModule = `export default ${JSON.stringify(records, null, 2)};\n`
+        writeTextFile(dataCommitsFile, commitsModule)
+        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 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,
+            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,
+            lunchStart:
+              opts.lunchStart || opts.lunchStart === 0 ? opts.lunchStart : 12,
             lunchEnd: opts.lunchEnd || opts.lunchEnd === 0 ? opts.lunchEnd : 14,
-            country: opts.country || 'CN',
-          });
+            country: opts.country || 'CN'
+          })
           return {
             period: 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}`));
+            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}`))
 
-        startServer(opts.port || 3000, outDir).catch(() => {});
+        startServer(opts.port || 3000, outDir).catch(() => {})
       } catch (err) {
-        console.warn('Export data modules failed:', err && err.message ? err.message : err);
+        console.warn(
+          'Export data modules failed:',
+          err && err.message ? err.message : err
+        )
       }
     }
 
     // 按月输出 ... 保持原逻辑
-    const perPeriodFormats = String(opts.perPeriodFormats || '').split(',').map(s => String(s || '').trim().toLowerCase()).filter(Boolean);
+    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();
+      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 groupRecs = monthGroups[k]
         const s = analyzeOvertime(groupRecs, {
-          startHour: opts.workStart || opts.workStart === 0 ? opts.workStart : 9,
+          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,
+          lunchStart:
+            opts.lunchStart || opts.lunchStart === 0 ? opts.lunchStart : 12,
           lunchEnd: opts.lunchEnd || opts.lunchEnd === 0 ? opts.lunchEnd : 14,
-          country: opts.country || 'CN',
-        });
-        monthlyContent += `===== ${k} =====\n`;
-        monthlyContent += `${renderOvertimeText(s)}\n\n`;
+          country: opts.country || 'CN'
+        })
+        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));
-          console.log(chalk.green(`Overtime 月度(${k}) 已导出: ${perMonthFile}`));
+          const perMonthFileName = `month/overtime_${outBase}_${k}.txt`
+          const perMonthFile = outputFilePath(perMonthFileName, outDir)
+          writeTextFile(perMonthFile, renderOvertimeText(s))
+          console.log(
+            chalk.green(`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));
-              console.log(chalk.green(`Overtime 月度(CSV)(${k}) 已导出: ${outputFilePath(perMonthCsvName, outDir)}`));
+              const perMonthCsvName = `month/overtime_${outBase}_${k}.csv`
+              writeTextFile(
+                outputFilePath(perMonthCsvName, outDir),
+                renderOvertimeCsv(s)
+              )
+              console.log(
+                chalk.green(
+                  `Overtime 月度(CSV)(${k}) 已导出: ${outputFilePath(perMonthCsvName, outDir)}`
+                )
+              )
             } catch (err) {
-              console.warn(`Write monthly CSV for ${k} failed:`, err && err.message ? err.message : 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));
-              console.log(chalk.green(`Overtime 月度(Tab)(${k}) 已导出: ${outputFilePath(perMonthTabName, outDir)}`));
+              const perMonthTabName = `month/overtime_${outBase}_${k}.tab.txt`
+              writeTextFile(
+                outputFilePath(perMonthTabName, outDir),
+                renderOvertimeTab(s)
+              )
+              console.log(
+                chalk.green(
+                  `Overtime 月度(Tab)(${k}) 已导出: ${outputFilePath(perMonthTabName, outDir)}`
+                )
+              )
             } catch (err) {
-              console.warn(`Write monthly Tab for ${k} failed:`, err && err.message ? err.message : 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);
+          console.warn(
+            `Write monthly file for ${k} failed:`,
+            err && err.message ? err.message : err
+          )
         }
-      });
+      })
       if (!opts.perPeriodOnly) {
-        writeTextFile(monthlyFile, monthlyContent);
-        console.log(chalk.green(`Overtime 月度汇总 已导出: ${monthlyFile}`));
+        writeTextFile(monthlyFile, monthlyContent)
+        console.log(chalk.green(`Overtime 月度汇总 已导出: ${monthlyFile}`))
       }
       // per-period Excel (sheets or files)
       if (perPeriodFormats.includes('xlsx')) {
-        const perPeriodExcelMode = String(opts.perPeriodExcelMode || 'sheets');
+        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 });
-            console.log(chalk.green(`Overtime 月度(XLSX) 已导出: ${monthXlsxFile}`));
+            const monthXlsxName = `month/overtime_${outBase}_monthly.xlsx`
+            const monthXlsxFile = outputFilePath(monthXlsxName, outDir)
+            await exportExcelPerPeriodSheets(monthGroups, monthXlsxFile, {
+              stats: opts.stats,
+              gerrit: opts.gerrit
+            })
+            console.log(
+              chalk.green(`Overtime 月度(XLSX) 已导出: ${monthXlsxFile}`)
+            )
           } catch (err) {
-            console.warn('Export month XLSX (sheets) failed:', err && err.message ? err.message : 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);
+            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);
+            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);
+      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();
+      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 groupRecs = weekGroups[k]
         const s = analyzeOvertime(groupRecs, {
-          startHour: opts.workStart || opts.workStart === 0 ? opts.workStart : 9,
+          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,
+          lunchStart:
+            opts.lunchStart || opts.lunchStart === 0 ? opts.lunchStart : 12,
           lunchEnd: opts.lunchEnd || opts.lunchEnd === 0 ? opts.lunchEnd : 14,
-          country: opts.country || 'CN',
-        });
-        weeklyContent += `===== ${k} =====\n`;
-        weeklyContent += `${renderOvertimeText(s)}\n\n`;
+          country: opts.country || 'CN'
+        })
+        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}`));
+          const perWeekFileName = `week/overtime_${outBase}_${k}.txt`
+          const perWeekFile = outputFilePath(perWeekFileName, outDir)
+          writeTextFile(perWeekFile, renderOvertimeText(s))
+          console.log(chalk.green(`Overtime 周度(${k}) 已导出: ${perWeekFile}`))
           // eslint-disable-next-line no-shadow
-          const perPeriodFormats = String(opts.perPeriodFormats || '').split(',').map(s => String(s || '').trim().toLowerCase()).filter(Boolean);
+          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));
-              console.log(chalk.green(`Overtime 周度(CSV)(${k}) 已导出: ${outputFilePath(perWeekCsvName, outDir)}`));
+              const perWeekCsvName = `week/overtime_${outBase}_${k}.csv`
+              writeTextFile(
+                outputFilePath(perWeekCsvName, outDir),
+                renderOvertimeCsv(s)
+              )
+              console.log(
+                chalk.green(
+                  `Overtime 周度(CSV)(${k}) 已导出: ${outputFilePath(perWeekCsvName, outDir)}`
+                )
+              )
             } catch (err) {
-              console.warn(`Write weekly CSV for ${k} failed:`, err && err.message ? err.message : 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));
-              console.log(chalk.green(`Overtime 周度(Tab)(${k}) 已导出: ${outputFilePath(perWeekTabName, outDir)}`));
+              const perWeekTabName = `week/overtime_${outBase}_${k}.tab.txt`
+              writeTextFile(
+                outputFilePath(perWeekTabName, outDir),
+                renderOvertimeTab(s)
+              )
+              console.log(
+                chalk.green(
+                  `Overtime 周度(Tab)(${k}) 已导出: ${outputFilePath(perWeekTabName, outDir)}`
+                )
+              )
             } catch (err) {
-              console.warn(`Write weekly Tab for ${k} failed:`, err && err.message ? err.message : 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);
+          console.warn(
+            `Write weekly file for ${k} failed:`,
+            err && err.message ? err.message : err
+          )
         }
-      });
-      writeTextFile(weeklyFile, weeklyContent);
-      console.log(chalk.green(`Overtime 周度汇总 已导出: ${weeklyFile}`));
+      })
+      writeTextFile(weeklyFile, weeklyContent)
+      console.log(chalk.green(`Overtime 周度汇总 已导出: ${weeklyFile}`))
     } catch (err) {
-      console.warn('Generate weekly overtime failed:', err && err.message ? err.message : 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);
-    console.log(chalk.green(`JSON 已导出: ${filepath}`));
-    return;
+    const file = opts.out || 'commits.json'
+    const filepath = outputFilePath(file, outDir)
+    writeJSON(filepath, groups || records)
+    console.log(chalk.green(`JSON 已导出: ${filepath}`))
+    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);
-    console.log(text);
-    console.log(chalk.green(`文本已导出: ${filepath}`));
-    return;
+    const file = opts.out || 'commits.txt'
+    const filepath = outputFilePath(file, outDir)
+    const text = renderText(records, groups, { showGerrit: !!opts.gerrit })
+    writeTextFile(filepath, text)
+    console.log(text)
+    console.log(chalk.green(`文本已导出: ${filepath}`))
+    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);
+    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
-    });
-    const text = renderText(records, groups);
-    writeTextFile(txtPath, text);
-    console.log(chalk.green(`Excel 已导出: ${excelPath}`));
-    console.log(chalk.green(`文本已自动导出: ${txtPath}`));
+    })
+    const text = renderText(records, groups)
+    writeTextFile(txtPath, text)
+    console.log(chalk.green(`Excel 已导出: ${excelPath}`))
+    console.log(chalk.green(`文本已自动导出: ${txtPath}`))
   }
-})();
+  await autoCheckUpdate()
+}
+
+main()

package/src/constants/index.mjs

@@ -0,0 +1,3 @@
+export const CLI_NAME = 'wukong-gitlog-cli'
+
+export const GIT_HUB ='https://www.npmjs.com/package/wukong-gitlog-cli'

package/src/git.mjs

@@ -1,5 +1,5 @@
-#!/usr/bin/env zx
-import 'zx/globals'
+import { $ } from 'zx'
+
 
 export async function getGitLogs(opts) {
   const { author, email, since, until, limit, merges } = opts

package/src/utils/checkUpdate.mjs

@@ -0,0 +1,130 @@
+import boxen from 'boxen'
+import fs from 'fs'
+import isOnline from 'is-online'
+import os from 'os'
+import path from 'path'
+import semver from 'semver'
+
+import { colors } from './colors.mjs'
+
+const CONFIG_DIR = path.join(os.homedir(), '.config', 'configstore')
+
+const getCacheFile = (pkg) =>
+  path.join(CONFIG_DIR, `update-notifier-${pkg.name}.json`)
+
+async function fetchLatestVersion(pkgName, timeout = 1500) {
+  const url = `https://registry.npmjs.org/${pkgName}/latest`
+  const controller = new AbortController()
+  const timer = setTimeout(() => controller.abort(), timeout)
+
+  try {
+    const res = await fetch(url, { signal: controller.signal })
+    clearTimeout(timer)
+    if (!res.ok) throw new Error('fetch fail')
+    const data = await res.json()
+    return data.version
+  } catch (e) {
+    clearTimeout(timer)
+    // 超时或其他错误都返回 null，防止程序卡死
+    return null
+  }
+}
+
+/**
+ * 格式化升级提示信息
+ */
+export function formatUpdateMessage(current, latest, name) {
+  const arrow = colors.dim('→')
+  const currentVer = colors.dim(current)
+  const latestVer = colors.green(latest)
+
+  const message =
+    `${colors.dim('Update available')}` +
+    `  ${currentVer} ${arrow} ${latestVer}\n` +
+    `${colors.dim('Run')} ${colors.cyanish(`npm i -g ${name}`)} ${colors.dim(' to update')}`
+
+  return boxen(message, {
+    padding: 1,
+    margin: 1,
+    borderStyle: 'round',
+    borderColor: 'yellow'
+  })
+}
+
+/**
+ * 检查更新（带缓存 + 支持 patch 更新）
+ */
+export async function checkUpdateWithPatch({
+  pkg,
+  interval = 24 * 60 * 60 * 1000,
+  // interval = 6 * 1000,
+  force = false
+} = {}) {
+  const online = await isOnline()
+  // console.log('online', online)
+  if (!online) return null
+  const now = Date.now()
+  const CACHE_FILE = getCacheFile(pkg)
+
+  let cache = {}
+  if (fs.existsSync(CACHE_FILE)) {
+    try {
+      cache = JSON.parse(fs.readFileSync(CACHE_FILE, 'utf8')) || {}
+      // eslint-disable-next-line no-empty
+    } catch {}
+  }
+
+  // console.log('now - cache.lastCheck', now - cache.lastCheck, interval)
+  if (!force && cache.lastCheck && now - cache.lastCheck < interval) {
+    return cache.updateInfo || null
+  }
+
+  const latest = await fetchLatestVersion(pkg.name)
+  if (!latest) {
+    // console.log('无法获取最新版本')
+    return null
+  }
+
+  if (semver.lt(pkg.version, latest)) {
+    // 构造 update 对象，兼容 update-notifier
+    const updateInfo = {
+      current: pkg.version,
+      latest,
+      type: semver.diff(pkg.version, latest) || 'patch',
+      name: pkg.name,
+      // 这里官方还会有 message 字段
+      // 用官方的默认消息格式生成，方便notify打印
+      message: `\nUpdate available ${pkg.version} → ${latest}\nRun npm i -g ${pkg.name} to update\n`
+    }
+
+    // 缓存
+    try {
+      fs.mkdirSync(CONFIG_DIR, { recursive: true })
+      fs.writeFileSync(
+        CACHE_FILE,
+        JSON.stringify(
+          {
+            lastCheck: now,
+            updateInfo
+          },
+          null,
+          2
+        )
+      )
+    } catch (e) {
+      console.error('缓存写入失败:', e)
+    }
+
+    const { current } = updateInfo
+    console.log(formatUpdateMessage(current, latest, pkg.name))
+    return updateInfo
+  }
+  // 无更新，刷新缓存时间
+  try {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true })
+    fs.writeFileSync(CACHE_FILE, JSON.stringify({ lastCheck: now }, null, 2))
+  } catch (e) {
+    console.error('缓存写入失败:', e)
+  }
+  return null
+}

package/src/utils/colors.mjs

@@ -0,0 +1,56 @@
+import { Chalk } from 'chalk'
+
+const chalk = new Chalk({ level: 3 }) // 强制开启 truecolor chalk v5
+// 自定义灰色，适合透明和深色背景，避免看不清
+const betterGray = chalk.hex('#BBBBBB')
+
+// 统一颜色模块
+export const colors = {
+  // 标题、版本号
+  title: chalk.bold.cyan,
+
+  // 命令名
+  command: chalk.green,
+
+  // 选项标记
+  option: chalk.magenta,
+
+  // 描述文字，替代默认灰色
+  desc: betterGray,
+
+  // Usage、Commands、Options、示例等小标题
+  header: chalk.yellow,
+
+  // 示例文字，普通白色
+  example: chalk.white,
+
+  // 警告红色
+  error: chalk.bold.red,
+
+  // 成功绿色
+  success: chalk.bold.green,
+
+  // 信息蓝色
+  info: chalk.blue,
+
+  // 可用更柔和的调暗白色，替代 dim gray
+  dim: chalk.white.dim,
+  bold: chalk.bold,
+  boldBlue: chalk.bold.blue,
+  gray: chalk.bold.gray,
+  green: chalk.green,
+  cyanish: chalk.hex('#57a097'),
+  white: chalk.white,
+}
+
+export const c = {
+  title: chalk.bold.cyan,
+  label: chalk.yellow,
+  value: chalk.white,
+  dim: chalk.hex('#BBBBBB'),
+  success: chalk.green,
+  green: chalk.green,
+  error: chalk.red,
+  red: chalk.red,
+  link: chalk.blue.underline
+}

package/src/utils/showVersionInfo.mjs

@@ -0,0 +1,10 @@
+import os from 'os'
+import process from 'process'
+import { colors } from './colors.mjs'
+
+
+export function showVersionInfo(VERSION) {
+  console.log(colors.title(`\nwukong-deploy v${VERSION}\n`))
+  console.log(`${colors.bold('Node.js')}: ${process.version}`)
+  console.log(`${colors.bold('Platform')}: ${os.platform()} ${os.arch()}`)
+}