wukong-gitlog-cli 1.0.37 → 1.0.39

package/.eslintrc

@@ -24,6 +24,7 @@
     "consistent-return": "off",
     "no-await-in-loop": "warn",
     "no-unused-vars": "warn",
+    "no-nested-ternary": "warn",
     "no-console": "off",
     "no-plusplus": "off",
     "no-unresolved": "off",

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 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.39](https://github.com/tomatobybike/wukong-gitlog-cli/compare/v1.0.38...v1.0.39) (2025-12-29)
+
+
+### Features
+
+* 🎸 web report add date filter ([d5968d8](https://github.com/tomatobybike/wukong-gitlog-cli/commit/d5968d8222aa1129e60894234ac9fca6c91e5a73))
+* 🎸 wukong-gitlog command entry ([48b5698](https://github.com/tomatobybike/wukong-gitlog-cli/commit/48b569842114cd11336ee23580104048342e085b))
+
+### [1.0.38](https://github.com/tomatobybike/wukong-gitlog-cli/compare/v1.0.37...v1.0.38) (2025-12-27)
+
+
+### Features
+
+* 🎸 增加性能分析 ([ec925cc](https://github.com/tomatobybike/wukong-gitlog-cli/commit/ec925cc3d20be2a0eee6e20aaee99b4449eff9be))
+* 🎸 flame 和 显示 flame-like 日志 ([7b1a00c](https://github.com/tomatobybike/wukong-gitlog-cli/commit/7b1a00c26afa1757637e6c4a3a2be92d74e0ad65))
+* 🎸 ignore ([eb3e5bc](https://github.com/tomatobybike/wukong-gitlog-cli/commit/eb3e5bc89183e0722056036f14f74806e3c3b1e3))
+* 🎸 profiler ([48fd0a5](https://github.com/tomatobybike/wukong-gitlog-cli/commit/48fd0a5a8b25b55bbca7bbdbd2df11158049adcd))
+* 🎸 Profiler ([a7f4623](https://github.com/tomatobybike/wukong-gitlog-cli/commit/a7f4623a162947d31f25702052f54a4ff0406fcb))
+
 ### [1.0.37](https://github.com/tomatobybike/wukong-gitlog-cli/compare/v1.0.36...v1.0.37) (2025-12-12)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wukong-gitlog-cli",
-  "version": "1.0.37",
+  "version": "1.0.39",
   "description": "Advanced Git commit log exporter with Excel/JSON/TXT output, grouping, stats and CLI.",
   "keywords": [
     "git",
@@ -34,43 +34,46 @@
   "author": "Tom <tomatobybike@gmail.com>",
   "type": "module",
   "bin": {
+    "wukong-gitlog": "./bin/wukong-gitlog-cli",
     "wukong-gitlog-cli": "./bin/wukong-gitlog-cli"
   },
   "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: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:overtime-demo": "node ./src/cli.mjs --overtime --format text --limit 200",
-    "cli:overtime-text": "node ./src/cli.mjs --overtime --limit 100 --format text --out commits.txt",
     "cli:overtime-excel": "node ./src/cli.mjs --overtime --limit 50 --format excel --out commits.xlsx",
-    "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-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: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-excel-cn": "node ./src/cli.mjs --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-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-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-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-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",
     "format": "prettier --write \"src/**/*.{js,mjs}\"",
     "lint": "eslint src --ext .js,.mjs src",
     "lint:fix": "eslint src --ext .js,.mjs --fix",
     "pack": "npm pack",
-    "build": "node scripts/esbuild.config.mjs",
     "prepare": "husky install",
-    "prettierall": "npx prettier --write 'src/**/*.{js,jsx}'",
     "prepublishOnly": "yarn lint && yarn build",
-    "check:npm:login": "node scripts/check-npm-login.mjs",
-    "release": "yarn check:npm:login && yarn release:patch && yarn push:tags && npm publish",
+    "prettierall": "npx prettier --write 'src/**/*.{js,jsx}'",
     "push:tags": "git push origin main --follow-tags",
+    "prerelease": "yarn lint",
+    "release": "yarn check:npm:login && yarn release:patch && npm publish && yarn push:tags",
+    "release:rollback": "git reset --hard HEAD~1 && git tag -d $(git tag --points-at HEAD~1)",
     "release:major": "yarn lint && standard-version --release-as major",
     "release:minor": "yarn lint && standard-version --release-as minor",
     "release:patch": "yarn lint && standard-version --release-as patch",
@@ -94,15 +97,16 @@
     "boxen": "8.0.1",
     "chalk": "5.6.2",
     "commander": "12.1.0",
+    "date-fns": "4.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",
     "semver": "6.3.1",
     "string-width": "5.1.2",
+    "wukong-profiler": "^1.0.6",
     "zx": "7.2.4"
   },
   "devDependencies": {

package/src/index.mjs

@@ -6,6 +6,7 @@ import fs from 'fs'
 import ora from 'ora'
 import path from 'path'
 import { fileURLToPath } from 'url'
+import { createProfiler } from 'wukong-profiler'
 
 import { parseOptions } from './cli/parseOptions.mjs'
 // eslint-disable-next-line no-unused-vars
@@ -50,6 +51,8 @@ dayjs.extend(isoWeek)
 const PKG_NAME = pkg.name
 const VERSION = pkg.version
 
+let profiler
+
 const autoCheckUpdate = async () => {
   // === CLI 主逻辑完成后提示更新 ===
   await checkUpdateWithPatch({
@@ -83,8 +86,6 @@ export function getWeekRange(periodStr) {
 }
 
 const main = async () => {
-  const startTime = performance.now()
-
   const program = new Command()
 
   program
@@ -185,12 +186,31 @@ const main = async () => {
       '仅启动 web 服务，不导出或分析数据（使用 output-wukong/data 中已有的数据）'
     )
     .option('--version', 'show version information')
+    .option('--profile', '输出性能分析 JSON')
+    .option('--verbose', '显示详细性能日志')
+    .option('--flame', '显示 flame-like 日志')
+    .option('--trace <file>', '生成 Chrome Trace')
+    .option('--hot-threshold <n>', 'HOT 比例阈值', parseFloat, 0.8)
+    .option('--fail-on-hot', 'HOT 时 CI 失败')
+    .option('--diff-base <file>', '基线 profile.json')
+    .option('--diff-threshold <n>', '回归阈值', parseFloat, 0.2)
     .parse()
 
   const opts = program.opts()
 
   const config = parseOptions(opts)
 
+  profiler = createProfiler({
+    enabled: opts.profile,
+    verbose: opts.verbose,
+    flame: opts.flame,
+    traceFile: opts.trace,
+    hotThreshold: opts.hotThreshold,
+    failOnHot: opts.failOnHot,
+    diffBaseFile: opts.diffBase,
+    diffThreshold: opts.diffThreshold
+  })
+
   // ❗只创建一次缓存实例
   const getOvertimeStats = createOvertimeStats(config)
 
@@ -324,6 +344,7 @@ const main = async () => {
 
   // --- 分组 ---
   const groups = opts.groupBy ? groupRecords(records, opts.groupBy) : null
+  profiler.step('load config')
 
   // If serve mode is enabled, write data modules and launch the web server
   if (opts.serve) {
@@ -332,7 +353,12 @@ const main = async () => {
 
   // --- Overtime analysis ---
   if (opts.overtime) {
+    await profiler.stepAsync('getOvertimeStats', async () => {
+      await getOvertimeStats(records)
+    })
     const stats = getOvertimeStats(records)
+
+    profiler.step('load getOvertimeStats')
     // Output to console
     console.log('\n--- Overtime analysis ---\n')
     console.log(renderOvertimeText(stats))
@@ -579,7 +605,7 @@ const main = async () => {
     const jsonText = renderAuthorChangesJson(records)
     writeJSON(outputFilePath('author-changes.json', outDir), jsonText)
     logDev(`JSON 已导出: ${filepath}`)
-    handleSuccess({ startTime, spinner })
+    handleSuccess({ spinner })
     return
   }
 
@@ -593,11 +619,11 @@ const main = async () => {
       renderChangedLinesText(records)
     )
 
-    console.log('\n Commits List:\n', text, '\n')
+    // console.log('\n Commits List:\n', text, '\n')
 
     logDev(`文本已导出: ${filepath}`)
 
-    handleSuccess({ startTime, spinner })
+    handleSuccess({ spinner })
 
     return
   }
@@ -621,10 +647,32 @@ const main = async () => {
     logDev(`Excel 已导出: ${excelPath}`)
     logDev(`文本已自动导出: ${txtPath}`)
 
-    handleSuccess({ startTime, spinner })
+    handleSuccess({ spinner })
   }
 
   await autoCheckUpdate()
+
+  handleSuccess({ spinner })
 }
 
-main()
+try {
+  await main()
+} catch (err) {
+  console.error(err)
+  process.exitCode = 1
+} finally {
+  if (profiler) {
+    const result = profiler.end('git-commits')
+
+    // --profile 时输出 JSON
+    if (process.argv.includes('--profile')) {
+      const json = {
+        command: 'git-commits',
+        version: VERSION,
+        timestamp: Date.now(),
+        profile: result
+      }
+      console.log(JSON.stringify(json, null, 2))
+    }
+  }
+}

package/src/utils/handleSuccess.mjs

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

package/src/utils/profiler/diff.mjs

@@ -0,0 +1,26 @@
+export const diffProfiles = (prev, curr, threshold = 0.2) => {
+  const map = new Map()
+
+  prev.events.forEach(e => {
+    map.set(e.name, e.duration)
+  })
+
+  const regressions = []
+
+  curr.events.forEach(e => {
+    const before = map.get(e.name)
+    if (!before) return
+
+    const diff = (e.duration - before) / before
+    if (diff >= threshold) {
+      regressions.push({
+        name: e.name,
+        before,
+        after: e.duration,
+        diff
+      })
+    }
+  })
+
+  return regressions
+}

package/src/utils/profiler/format.mjs

@@ -0,0 +1,11 @@
+export const formatTime = (ms) => {
+  if (ms < 1) return `${(ms * 1000).toFixed(2)} μs`
+  if (ms < 1000) return `${ms.toFixed(2)} ms`
+  if (ms < 60000) return `${(ms / 1000).toFixed(2)} s`
+  return `${(ms / 60000).toFixed(2)} min`
+}
+
+export const makeBar = (ratio, width = 32) => {
+  const len = Math.max(1, Math.round(ratio * width))
+  return '█'.repeat(len)
+}

package/src/utils/profiler/index.mjs

@@ -0,0 +1,144 @@
+import chalk from 'chalk'
+import fs from 'fs'
+import { formatTime, makeBar } from './format.mjs'
+import { exportChromeTrace } from './trace.mjs'
+import { diffProfiles } from './diff.mjs'
+
+export const createProfiler = ({
+  enabled = false,
+  verbose = false,
+  flame = false,
+  slowThreshold = 500,
+  hotThreshold = 0.8,
+  traceFile,
+  failOnHot = false,
+  diffBaseFile,
+  diffThreshold = 0.2
+} = {}) => {
+  const start = process.hrtime.bigint()
+
+
+  const stack = []
+  const events = []
+
+  const toMs = (a, b) => Number(b - a) / 1e6
+
+  /* ================= step ================= */
+
+  const step = (name, fn) => {
+    const parent = stack[stack.length - 1]
+    const startTime = process.hrtime.bigint()
+
+    const node = {
+      name,
+      start: toMs(start, startTime),
+      duration: 0,
+      depth: stack.length,
+      children: []
+    }
+
+    if (parent) parent.children.push(node)
+    stack.push(node)
+
+    const finish = () => {
+      const endTime = process.hrtime.bigint()
+      node.duration = toMs(startTime, endTime)
+      events.push(node)
+      stack.pop()
+    }
+
+    if (typeof fn === 'function') {
+      try {
+        return fn()
+      } finally {
+        finish()
+      }
+    } else {
+      finish()
+    }
+  }
+
+  /* ================= end ================= */
+
+  const end = (label = 'Total') => {
+    const total = toMs(start, process.hrtime.bigint())
+
+    let hasHot = false
+
+    if (enabled || verbose) {
+      console.log(
+        chalk.cyan('⏱'),
+        chalk.bold(label),
+        chalk.yellow(formatTime(total))
+      )
+
+      if (flame) {
+        for (const e of events) {
+          const ratio = e.duration / total
+          const hot = ratio >= hotThreshold
+          const slow = e.duration >= slowThreshold
+
+          if (hot) hasHot = true
+
+          console.log(
+            chalk.gray(`${'  '.repeat(e.depth)  }├─`),
+            chalk.white(e.name.padEnd(22)),
+            chalk.yellow(formatTime(e.duration)),
+            chalk.gray(makeBar(ratio)),
+            hot
+              ? chalk.red.bold(' 🔥 HOT')
+              : slow
+              ? chalk.yellow(' ⚠ SLOW')
+              : ''
+          )
+        }
+      }
+    }
+
+    const profile = { total, events }
+
+    /* ---------- Chrome Trace ---------- */
+
+    if (traceFile) {
+      exportChromeTrace(events, traceFile)
+    }
+
+    /* ---------- diff ---------- */
+    if (diffBaseFile && fs.existsSync(diffBaseFile)) {
+      const base = JSON.parse(fs.readFileSync(diffBaseFile, 'utf8'))
+      const regressions = diffProfiles(base, profile, diffThreshold)
+
+      if (regressions.length) {
+        console.log(chalk.red('\n⚠ Performance Regression Detected:\n'))
+        regressions.forEach(r => {
+          console.log(
+            chalk.red(
+              `  ${r.name}: ${formatTime(r.before)} → ${formatTime(
+                r.after
+              )} (+${(r.diff * 100).toFixed(1)}%)`
+            )
+          )
+        })
+        process.exitCode = 1
+      }
+    }
+
+    /* ---------- save profile ---------- */
+    if (enabled) {
+      fs.writeFileSync(
+        'profile.json',
+        JSON.stringify(profile, null, 2)
+      )
+    }
+
+    /* ---------- CI HOT fail ---------- */
+    if (failOnHot && hasHot) {
+      console.log(chalk.red('\n🔥 HOT step detected — failing CI'))
+      process.exitCode = 1
+    }
+
+    return profile
+  }
+
+  return { step, end }
+}

package/src/utils/profiler/trace.mjs

@@ -0,0 +1,26 @@
+import fs from 'fs'
+
+export const exportChromeTrace = (events, file) => {
+  const traceEvents = []
+
+  for (const e of events) {
+    traceEvents.push({
+      name: e.name,
+      cat: 'cli',
+      ph: 'X',                 // complete event
+      ts: e.start * 1000,      // μs
+      dur: e.duration * 1000,  // μs
+      pid: 1,
+      tid: e.depth || 0
+    })
+  }
+
+  const trace = {
+    traceEvents,
+    displayTimeUnit: 'ms'
+  }
+
+  fs.writeFileSync(file, JSON.stringify(trace, null, 2))
+  // TODO: remove debug log before production
+  console.log('✅', 'file', file);
+}

package/src/utils/profiler.mjs

@@ -0,0 +1,101 @@
+import chalk from 'chalk'
+
+/* ================= utils ================= */
+
+const formatTime = (ms) => {
+  if (ms < 1) return `${(ms * 1000).toFixed(2)} μs`
+  if (ms < 1000) return `${ms.toFixed(2)} ms`
+  if (ms < 60000) return `${(ms / 1000).toFixed(2)} s`
+  return `${(ms / 60000).toFixed(2)} min`
+}
+
+const makeBar = (ratio, width = 32) => {
+  const len = Math.max(1, Math.round(ratio * width))
+  return '█'.repeat(len)
+}
+
+/* ================= profiler ================= */
+
+export const createProfiler = ({
+  enabled = false,
+  verbose = false,
+  flame = false,
+  slowThreshold = 500,   // ms
+  hotThreshold = 0.8     // ratio (0~1)
+} = {}) => {
+  const start = process.hrtime.bigint()
+  let last = start
+  const events = []
+
+  const toMs = (a, b) => Number(b - a) / 1e6
+
+  /* -------- step -------- */
+  const step = (name, meta = {}) => {
+    const now = process.hrtime.bigint()
+    const duration = toMs(last, now)
+    last = now
+
+    events.push({
+      name,
+      duration,
+      sinceStart: toMs(start, now),
+      meta
+    })
+
+    if (!enabled && !verbose) return
+
+    const isSlow = duration >= slowThreshold
+
+    console.log(
+      chalk.gray('  ├─'),
+      isSlow ? chalk.red.bold(name) : chalk.white(name),
+      chalk.yellow(formatTime(duration))
+    )
+  }
+
+  /* -------- end -------- */
+  const end = (label = 'Total') => {
+    const endTime = process.hrtime.bigint()
+    const total = toMs(start, endTime)
+
+    // 计算 HOT
+    for (const e of events) {
+      e.ratio = total > 0 ? e.duration / total : 0
+      e.hot = e.ratio >= hotThreshold
+    }
+
+    if (enabled || verbose) {
+      console.log(
+        chalk.cyan('⏱'),
+        chalk.bold(label),
+        chalk.yellow(formatTime(total))
+      )
+
+      if (flame) {
+        for (const e of events) {
+          const bar = makeBar(e.ratio)
+          const hotMark = e.hot ? chalk.red.bold(' 🔥 HOT') : ''
+          const slowMark =
+            !e.hot && e.duration >= slowThreshold
+              ? chalk.yellow(' ⚠ SLOW')
+              : ''
+
+          console.log(
+            chalk.gray('  ├─'),
+            chalk.white(e.name.padEnd(24)),
+            chalk.yellow(formatTime(e.duration)),
+            chalk.gray(bar),
+            hotMark || slowMark
+          )
+        }
+      }
+    }
+
+    return {
+      total,
+      events
+    }
+  }
+
+  return { step, end }
+}

package/src/utils/time/scopeTimer.mjs

@@ -0,0 +1,37 @@
+// utils/scopeTimer.js
+import chalk from 'chalk'
+
+const formatTime = (ms) => {
+  if (ms < 1) return `${(ms * 1000).toFixed(2)} μs`
+  if (ms < 1000) return `${ms.toFixed(2)} ms`
+  if (ms < 60000) return `${(ms / 1000).toFixed(2)} s`
+  return `${(ms / 60000).toFixed(2)} min`
+}
+
+export const createScopeTimer = (scope) => {
+  const start = process.hrtime.bigint()
+  let last = start
+
+  const step = (label) => {
+    const now = process.hrtime.bigint()
+    const ms = Number(now - last) / 1e6
+    last = now
+
+    console.log(
+      chalk.gray('  ├─'),
+      chalk.white(label),
+      chalk.yellow(formatTime(ms))
+    )
+  }
+
+  const end = () => {
+    const total = Number(process.hrtime.bigint() - start) / 1e6
+    console.log(
+      chalk.cyan('⏱'),
+      chalk.bold(scope),
+      chalk.yellow(formatTime(total))
+    )
+  }
+
+  return { step, end }
+}

package/src/utils/time/timer.mjs

@@ -0,0 +1,33 @@
+// utils/timer.js
+import chalk from 'chalk'
+
+const ENABLED = process.env.CLI_TIMER !== 'false'
+
+const formatTime = (ms) => {
+  if (ms < 1) return `${(ms * 1000).toFixed(2)} μs`
+  if (ms < 1000) return `${ms.toFixed(2)} ms`
+  if (ms < 60000) return `${(ms / 1000).toFixed(2)} s`
+  return `${(ms / 60000).toFixed(2)} min`
+}
+
+export const createTimer = (label, { silent = false } = {}) => {
+  const start = process.hrtime.bigint()
+
+  const stop = (suffix) => {
+    if (!ENABLED || silent) return
+
+    const end = process.hrtime.bigint()
+    const ms = Number(end - start) / 1e6
+
+    console.log(
+      chalk.cyan('⏱'),
+      chalk.white(label),
+      suffix ? chalk.gray(`(${suffix})`) : '',
+      chalk.bold.yellow(formatTime(ms))
+    )
+
+    return ms
+  }
+
+  return { stop }
+}

package/src/utils/time/withTimer.mjs

@@ -0,0 +1,11 @@
+// utils/withTimer.js
+import { createTimer } from './timer.mjs'
+
+export const withTimer = async (label, fn, opts) => {
+  const timer = createTimer(label, opts)
+  try {
+    return await fn()
+  } finally {
+    timer.stop()
+  }
+}

package/web/app.js

@@ -3,6 +3,22 @@
 /* global echarts */
 const formatDate = (d) => new Date(d).toLocaleString()
 
+function filterByDate(commits) {
+  const start = document.getElementById('startDate')?.value
+  const end = document.getElementById('endDate')?.value
+
+  if (!start && !end) return commits
+
+  const startTime = start ? new Date(`${start}T00:00:00`).getTime() : -Infinity
+
+  const endTime = end ? new Date(`${end}T23:59:59`).getTime() : Infinity
+
+  return commits.filter((c) => {
+    const t = new Date(c.date).getTime()
+    return t >= startTime && t <= endTime
+  })
+}
+
 // ISO 周 key：YYYY-Www
 function getIsoWeekKey(dStr) {
   const d = new Date(dStr)
@@ -100,7 +116,8 @@ function renderCommitsTablePage() {
     tr.innerHTML = `<td>${c.hash.slice(0, 8)}</td><td>${c.author}</td><td>${c.email}</td><td>${formatDate(c.date)}</td><td>${c.message}</td><td>${c.changed}</td>`
     tbody.appendChild(tr)
   })
-  document.getElementById('commitsTotal').textContent = `共${filtered.length}条记录`
+  document.getElementById('commitsTotal').textContent =
+    `共${filtered.length}条记录`
 }
 
 function updatePager() {
@@ -115,16 +132,25 @@ function updatePager() {
 function applySearch() {
   const q = document.getElementById('searchInput').value.trim().toLowerCase()
 
+  // ① 先做日期过滤
+  const base = filterByDate(commitsAll)
+
   if (!q) {
-    filtered = commitsAll.slice()
+    filtered = base.slice()
   } else {
-    filtered = commitsAll.filter((c) => {
+    filtered = base.filter((c) => {
       const h = c.hash.toLowerCase()
       const a = String(c.author || '').toLowerCase()
       const e = String(c.email || '').toLowerCase()
       const m = String(c.message || '').toLowerCase()
       const d = formatDate(c.date).toLowerCase()
-      return h.includes(q) || a.includes(q)|| e.includes(q) || m.includes(q) || d.includes(q)
+      return (
+        h.includes(q) ||
+        a.includes(q) ||
+        e.includes(q) ||
+        m.includes(q) ||
+        d.includes(q)
+      )
     })
   }
   page = 1
@@ -134,6 +160,13 @@ function applySearch() {
 
 function initTableControls() {
   document.getElementById('searchInput').addEventListener('input', applySearch)
+  document.getElementById('startDate')?.addEventListener('change', applySearch)
+  document.getElementById('endDate')?.addEventListener('change', applySearch)
+  document.getElementById('clearDate')?.addEventListener('click', () => {
+    document.getElementById('startDate').value = ''
+    document.getElementById('endDate').value = ''
+    applySearch()
+  })
   document.getElementById('pageSize').addEventListener('change', (e) => {
     pageSize = parseInt(e.target.value, 10) || 10
     page = 1

package/web/index.html

@@ -109,6 +109,10 @@
             type="search"
             placeholder="搜索作者/信息/Hash/Date"
           />
+          <input type="date" id="startDate" />
+          <span>~</span>
+          <input type="date" id="endDate" />
+          <button id="clearDate">清除</button>
           <label for="pageSize">每页显示</label>
           <select id="pageSize">
             <option value="10">10</option>

package/web/static/style.css

@@ -139,6 +139,45 @@ td {
   box-shadow: 0 0 0 3px rgba(25, 118, 210, 0.15);
   outline: none;
 }
+#tableControls input[type='date'] {
+  padding: 9px 12px;
+  border-radius: 8px;
+  border: 1px solid #ccc;
+  background: #fafafa;
+  font-size: 13px;
+  color: #111827;
+  transition:
+    border-color 0.2s,
+    box-shadow 0.2s;
+}
+
+#tableControls input[type='date']:focus {
+  border-color: #1976d2;
+  box-shadow: 0 0 0 3px rgba(25, 118, 210, 0.15);
+  outline: none;
+}
+/* 清除日期按钮 ------------------------------------------ */
+#clearDate {
+  padding: 8px 10px;
+  border-radius: 8px;
+  border: none;
+  background: transparent;
+  color: #64748b; /* slate-500 */
+  font-size: 13px;
+  cursor: pointer;
+  transition:
+    color 0.2s ease,
+    background 0.2s ease;
+}
+
+#clearDate:hover {
+  color: #ef4444; /* red-500 */
+  background: rgba(239, 68, 68, 0.08);
+}
+
+#clearDate:active {
+  background: rgba(239, 68, 68, 0.16);
+}
 
 /* 按钮 — MUI Button 风格 */
 .pager button {