wukong-gitlog-cli 1.0.39 → 1.0.41

package/.eslintrc

@@ -21,6 +21,7 @@
   "plugins": ["prettier"],
   "rules": {
     "array-callback-return": "off",
+    "no-continue": "off",
     "consistent-return": "off",
     "no-await-in-loop": "warn",
     "no-unused-vars": "warn",

package/.prettierrc

@@ -1,8 +1,9 @@
 {
   "bracketSpacing": true,
   "importOrder": [
+
     "^./conf(.*)(?<!.css)$",
-    "^(#|#company|#command|#ui|components|#utils|#constants||#lib|utils|config|vendored-lib)(/(.*)(?<!.css)$)",
+    "^(#|#company|#command|#ui|#src|components|#utils|#constants||#lib|utils|config|vendored-lib)(/(.*)(?<!.css)$)",
     "^(src|@)/(.*)(?<!.css)$",
     "^[./]",
     "^api/(.*)(?<!.css)$",

package/CHANGELOG.md

@@ -2,6 +2,103 @@
 
 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.41](https://github.com/tomatobybike/wukong-gitlog-cli/compare/v1.0.40...v1.0.41) (2026-02-12)
+
+### [1.0.40](https://github.com/tomatobybike/wukong-gitlog-cli/compare/v1.0.39...v1.0.40) (2026-02-12)
+
+
+### Features
+
+* 🎸 --info options ([724a5c4](https://github.com/tomatobybike/wukong-gitlog-cli/commit/724a5c4b582b045682da388a83819c556d88cc7f))
+* 🎸 --version ([0b4a4df](https://github.com/tomatobybike/wukong-gitlog-cli/commit/0b4a4df2c97113e99f2e5ce2cf008c8afe9530e7))
+* 🎸 按照日期生成每天日报 ([67ecf56](https://github.com/tomatobybike/wukong-gitlog-cli/commit/67ecf56a4a0f53269a89d0f9e43409ae86ddd6d2))
+* 🎸 本周加班时长排名 ([964be32](https://github.com/tomatobybike/wukong-gitlog-cli/commit/964be32a657312af8ddb889d4af7c387909f314d))
+* 🎸 采样区间 ([5e4aa4f](https://github.com/tomatobybike/wukong-gitlog-cli/commit/5e4aa4f94edd43fb23f3158587ee5d98342bc66f))
+* 🎸 采样时间 ([fa298f5](https://github.com/tomatobybike/wukong-gitlog-cli/commit/fa298f58f55bcbd15eaa080dcfe9649bf9d8eba8))
+* 🎸 拆分代码结构 ([0497a5a](https://github.com/tomatobybike/wukong-gitlog-cli/commit/0497a5afdf93f94b87cc35efc4cbafb6a61e503f))
+* 🎸 导出 overtime_commits.csv ([d1f3022](https://github.com/tomatobybike/wukong-gitlog-cli/commit/d1f3022b7e6354ee345d3b872bd43ce85d653145))
+* 🎸 导出 overtime_commits.txt 导出 overtime_commits.tab.txt ([290e629](https://github.com/tomatobybike/wukong-gitlog-cli/commit/290e629b0678a4c3ba6ec60a0521d2e71eed2101))
+* 🎸 导出每月数据 ([bec386e](https://github.com/tomatobybike/wukong-gitlog-cli/commit/bec386e17cba0e6c02fe821cdc5dc9e24fe6d0a3))
+* 🎸 进度条 ([368892a](https://github.com/tomatobybike/wukong-gitlog-cli/commit/368892ad112fa7357c629ed12b80d765e10570d0))
+* 🎸 进度条优化 ([ff7c105](https://github.com/tomatobybike/wukong-gitlog-cli/commit/ff7c10559c16fc6cdee3a635df8489a011602b21))
+* 🎸 开发者 累计加班时长 ([2124e5c](https://github.com/tomatobybike/wukong-gitlog-cli/commit/2124e5cf721cc0c483d5bc3c59a64be1558d9fb5))
+* 🎸 开发者 午休最晚提交 ([cfcb62c](https://github.com/tomatobybike/wukong-gitlog-cli/commit/cfcb62c796d4444a3471a71a0ddb8268efed0b99))
+* 🎸 默认参数 ([a8b8c37](https://github.com/tomatobybike/wukong-gitlog-cli/commit/a8b8c373825b51b8c8d79b3060b76608b05a39c9))
+* 🎸 去掉zx，修复windows安装docker导致wsl引起的错误 ([c689aa9](https://github.com/tomatobybike/wukong-gitlog-cli/commit/c689aa9af25ccde7d94d4b24f2aceddfc3b589f5))
+* 🎸 删除冗余的dom ([0acdf10](https://github.com/tomatobybike/wukong-gitlog-cli/commit/0acdf107bbcd68eed934d7f6810d6c9744a9df18))
+* 🎸 完善总数 ([34957c9](https://github.com/tomatobybike/wukong-gitlog-cli/commit/34957c9780d9d43038d0eaeaf9c466c63f271e14))
+* 🎸 午休工作总时长 ([5e61010](https://github.com/tomatobybike/wukong-gitlog-cli/commit/5e61010b18b6e14b753e7605584e334f0f1709f2))
+* 🎸 午休时长 ([6a0d401](https://github.com/tomatobybike/wukong-gitlog-cli/commit/6a0d401e48eccfac00fb53059779886a6d60ad4a))
+* 🎸 新版本新的目录结构 ([c93b52a](https://github.com/tomatobybike/wukong-gitlog-cli/commit/c93b52a771f1f3f8b38fd9e08f845f6c06413d16))
+* 🎸 优化进度条 ([37df680](https://github.com/tomatobybike/wukong-gitlog-cli/commit/37df680bcb2474d0251c64f294ba38496c62d0df))
+* 🎸 优化serve改为前端计算overtime ([dda27de](https://github.com/tomatobybike/wukong-gitlog-cli/commit/dda27de2d99ddd928776b9c3da5b1ffe3394abd9))
+* 🎸 优化web 根据对象内容隐藏对应图表卡片 ([f212abe](https://github.com/tomatobybike/wukong-gitlog-cli/commit/f212abe14b7f9c45221f78ff886a9dbd2a419205))
+* 🎸 重构代码 ([5cc810c](https://github.com/tomatobybike/wukong-gitlog-cli/commit/5cc810c6ac1cb0bdae49cb9258e3de7ff88875fc))
+* 🎸 昼魔侠排行榜 ([6239271](https://github.com/tomatobybike/wukong-gitlog-cli/commit/6239271a4aa624b017781a24123b0420ab6cd936))
+* 🎸 自动更换端口 ([ff2188e](https://github.com/tomatobybike/wukong-gitlog-cli/commit/ff2188efe697275b307c9ff92dc8f796f2460d6d))
+* 🎸 最晚一次提交时间 ([1b21d4a](https://github.com/tomatobybike/wukong-gitlog-cli/commit/1b21d4a5b5384f0ddc48c90db0373785ef7bf382))
+* 🎸 all author ([4a65af2](https://github.com/tomatobybike/wukong-gitlog-cli/commit/4a65af2ccf12ae0169e4dc2052db31b7352e8af4))
+* 🎸 analyzeAction ([26eec68](https://github.com/tomatobybike/wukong-gitlog-cli/commit/26eec68e66994dd194fc25938c06e9d31a132c8c))
+* 🎸 author ([10140c3](https://github.com/tomatobybike/wukong-gitlog-cli/commit/10140c37a39977cb9cd951a7f9c90db81744c751))
+* 🎸 author.changes.mjs create ([06a094a](https://github.com/tomatobybike/wukong-gitlog-cli/commit/06a094a9420701891fbc6683fc30b5366349c7fa))
+* 🎸 authorAliases ([aecf170](https://github.com/tomatobybike/wukong-gitlog-cli/commit/aecf17005d1e3d5a4e66e1b9929709c1b120f749))
+* 🎸 auto init rc.yaml ([212353d](https://github.com/tomatobybike/wukong-gitlog-cli/commit/212353d31edf59e2c6e5e34c14993e1443954f74))
+* 🎸 autofit mobile ([3605a9a](https://github.com/tomatobybike/wukong-gitlog-cli/commit/3605a9a1aece6511ed5b996a0f05af165852c536))
+* 🎸 beta 版本新目录结构 ([c4ddd5c](https://github.com/tomatobybike/wukong-gitlog-cli/commit/c4ddd5c19cc60b2d33226ead0040d4fb42a6b719))
+* 🎸 chart order ([711ccfe](https://github.com/tomatobybike/wukong-gitlog-cli/commit/711ccfef636607954f595188dac51dcac10c253b))
+* 🎸 command journal cmd ([1ba9fad](https://github.com/tomatobybike/wukong-gitlog-cli/commit/1ba9fadd3a4b2e332661a7658d02db3666361959))
+* 🎸 create author.txt ([da33af7](https://github.com/tomatobybike/wukong-gitlog-cli/commit/da33af7f5e6605416a33545c9fc658870a5f528b))
+* 🎸 dayreport 去重 ([902b1f4](https://github.com/tomatobybike/wukong-gitlog-cli/commit/902b1f46c0473a251c8ab9a8ba8147fe31ef2f4d))
+* 🎸 del log ([a2f19fa](https://github.com/tomatobybike/wukong-gitlog-cli/commit/a2f19fad2b3fa6f149a36fd4daa7159233a27b28))
+* 🎸 export day report excel and txt ([edb51f0](https://github.com/tomatobybike/wukong-gitlog-cli/commit/edb51f08bc7b04d7b32e8bd96f3f956f06b1bbba))
+* 🎸 export each week ([b774969](https://github.com/tomatobybike/wukong-gitlog-cli/commit/b774969ac67ea53906464cd6aa14f839857235f3))
+* 🎸 export overtime ([cae5c44](https://github.com/tomatobybike/wukong-gitlog-cli/commit/cae5c44789a418c1105eee239a4d4bd6b6f17297))
+* 🎸 export overtime ([758ba8a](https://github.com/tomatobybike/wukong-gitlog-cli/commit/758ba8ac09710c9144216352e77c7c985e425061))
+* 🎸 findPkgRoot,辅助函数：向上寻找包含 package.json 的根目录 并启动serve ([5e06a3a](https://github.com/tomatobybike/wukong-gitlog-cli/commit/5e06a3a4b2ab25f415607a8fb1940be6f9fe7934))
+* 🎸 git auto ignore ([0d3c834](https://github.com/tomatobybike/wukong-gitlog-cli/commit/0d3c8340c12e3d380fe47ce4795458a1624be31b))
+* 🎸 handleExportByMonth导出每月数据 ([be57f28](https://github.com/tomatobybike/wukong-gitlog-cli/commit/be57f28330f30136866ab6a180aa5f8e1d7dcef0))
+* 🎸 handleExportCommits ([6e18f3c](https://github.com/tomatobybike/wukong-gitlog-cli/commit/6e18f3cb9f5a12a1d7d60ff19676f504ec3beac9))
+* 🎸 handleExportCommitsJson ,handleExportAuthorChangesJson ([db63749](https://github.com/tomatobybike/wukong-gitlog-cli/commit/db63749675058c322426057cacac03ac825fd819))
+* 🎸 i18n en and cn ([9c98b86](https://github.com/tomatobybike/wukong-gitlog-cli/commit/9c98b866454dddccd6f6954aba9794f69cc4eed8))
+* 🎸 init 支持 .wukonggitlogrc,.wukonggitlogrc.js,.wukonggitlo ([ae30c54](https://github.com/tomatobybike/wukong-gitlog-cli/commit/ae30c5433bf44aaec2b9a5fc630c4eabf78e5504))
+* 🎸 init ems ([dd34dba](https://github.com/tomatobybike/wukong-gitlog-cli/commit/dd34dba16cf5fae9346fb7eef004cf4de9bfc283))
+* 🎸 initActionWithTemp ([34348e6](https://github.com/tomatobybike/wukong-gitlog-cli/commit/34348e6c489176a3ec714a811976224b34b01bfa))
+* 🎸 journal 数据去重掉cherry pick的 ([977a4d9](https://github.com/tomatobybike/wukong-gitlog-cli/commit/977a4d966c89c44194f4d7d4ccf2b3d7262a0214))
+* 🎸 journal cmd ([efb39a8](https://github.com/tomatobybike/wukong-gitlog-cli/commit/efb39a826fb4dcae9555811613708f355364732b))
+* 🎸 log git ([b0f4c45](https://github.com/tomatobybike/wukong-gitlog-cli/commit/b0f4c4512633f88d5b9843f8ad4c9f1c4abcba9b))
+* 🎸 lunch work time ([7ada3eb](https://github.com/tomatobybike/wukong-gitlog-cli/commit/7ada3eb4f02b56527660060154a845e8d1eb56d4))
+* 🎸 osLocale ([a6dad80](https://github.com/tomatobybike/wukong-gitlog-cli/commit/a6dad80accb6b67200178833d6d83448747935d7))
+* 🎸 out-parent web serve ([6fbc857](https://github.com/tomatobybike/wukong-gitlog-cli/commit/6fbc857aff1d3434b8a767f2b341cd353b68523e))
+* 🎸 overtime ([a4ae89e](https://github.com/tomatobybike/wukong-gitlog-cli/commit/a4ae89e6be9bdef109ff8ba8bdbd67f435c5eb7a))
+* 🎸 overtime.mjs data ([d63c4d4](https://github.com/tomatobybike/wukong-gitlog-cli/commit/d63c4d4e725c917f69cab7e8f2c64c1785fb897a))
+* 🎸 pie chart ([141f65b](https://github.com/tomatobybike/wukong-gitlog-cli/commit/141f65b3a1af9986d088ba35f630128682617b44))
+* 🎸 profile ([97bf236](https://github.com/tomatobybike/wukong-gitlog-cli/commit/97bf236faf310bd621d5850b3f96feb74b0566b7))
+* 🎸 render authorTotalOvertimeRank ([04dd3d8](https://github.com/tomatobybike/wukong-gitlog-cli/commit/04dd3d8d0c241e5de248905ca6f2ca4014507096))
+* 🎸 slider add index ([84a1f9b](https://github.com/tomatobybike/wukong-gitlog-cli/commit/84a1f9b964187c6cd4818117200199c4495f22a6))
+* 🎸 tabsTotalCommits charts ([6e435b5](https://github.com/tomatobybike/wukong-gitlog-cli/commit/6e435b52a992818ecb1429738b74de4e336bbdb7))
+* 🎸 tooltips 排序 ([1a4269f](https://github.com/tomatobybike/wukong-gitlog-cli/commit/1a4269f8c7248aff34102dae9c4b317eb32e2c17))
+* 🎸 update profile add dir ([3171dc6](https://github.com/tomatobybike/wukong-gitlog-cli/commit/3171dc6b5e236985e266b5cbc4b1838abf65a422))
+* 🎸 update wukong-profile ([9b9fbc6](https://github.com/tomatobybike/wukong-gitlog-cli/commit/9b9fbc68c9b8985c6b59b399bc801788c6c88d5a))
+* 🎸 wukong-progress ([4b41ae4](https://github.com/tomatobybike/wukong-gitlog-cli/commit/4b41ae4ebaad5d8c537898be975167ec4c772f26))
+
+
+### Bug Fixes
+
+* 🐛 eslint warning ([5a145aa](https://github.com/tomatobybike/wukong-gitlog-cli/commit/5a145aa9836e1126e85281da1039d2777a1efbe3))
+* 🐛 exit ([12e5839](https://github.com/tomatobybike/wukong-gitlog-cli/commit/12e5839104125cc0144115b89af93d5b076e49fb))
+* 🐛 export i18n ([c2880ea](https://github.com/tomatobybike/wukong-gitlog-cli/commit/c2880ea26130eb4a17a163e614d237dd60f53b89))
+* 🐛 fix bug ([3158f55](https://github.com/tomatobybike/wukong-gitlog-cli/commit/3158f55a1cfddcc8eb2e5162c62c101804fc553b))
+* 🐛 fix front bug ([aec940f](https://github.com/tomatobybike/wukong-gitlog-cli/commit/aec940f8b38a6d698f6adab42cd235b16e93cb8e))
+* 🐛 fix lost data ([4126979](https://github.com/tomatobybike/wukong-gitlog-cli/commit/4126979a7ceb48073dd346ae851ce464be63c3a4))
+* 🐛 fix some bug ([cc7144b](https://github.com/tomatobybike/wukong-gitlog-cli/commit/cc7144b173ea41a860949fec309bbb699ad19e40))
+* 🐛 init i18n ([ce30157](https://github.com/tomatobybike/wukong-gitlog-cli/commit/ce301570d96ad2d233882f0a041d8428f5a4d798))
+* 🐛 journal ([2ac89f1](https://github.com/tomatobybike/wukong-gitlog-cli/commit/2ac89f1e19d833bd9a1fc94451a69b88cc24d33f))
+* 🐛 lost data ([baf74ec](https://github.com/tomatobybike/wukong-gitlog-cli/commit/baf74ec0694cd48800f39e81768ef03d848d344b))
+* 🐛 missing dependencies ([7d9a403](https://github.com/tomatobybike/wukong-gitlog-cli/commit/7d9a403e478c56ebeb9c63a13b0efde1229d123b))
+* 🐛 missing dependencies ([368aaeb](https://github.com/tomatobybike/wukong-gitlog-cli/commit/368aaeb61d6449f49036b8a29b06e2c096460a2a))
+* 🐛 overtime i18n ([bc855f7](https://github.com/tomatobybike/wukong-gitlog-cli/commit/bc855f764d1a02d4b5eeca7d4a6d0c3294e38c30))
+* 🐛 server i18n ([3a408e6](https://github.com/tomatobybike/wukong-gitlog-cli/commit/3a408e63273e2e9ca09b434d8106a6babf5d8792))
+
 ### [1.0.39](https://github.com/tomatobybike/wukong-gitlog-cli/compare/v1.0.38...v1.0.39) (2025-12-29)
 
 

package/README.md

@@ -1,246 +1,171 @@
-## 📦 `wukong-gitlog-cli`
+# 📦 `wukong-gitlog-cli`
 
-<p align="center">
-  <img src="https://raw.githubusercontent.com/tomatobybike/wukong-gitlog-cli/main/images/logo.svg" width="200" alt="wukong-dev Logo" />
-</p>
-
-<p align="center">
-  <a href="https://www.npmjs.com/package/wukong-gitlog-cli"><img src="https://img.shields.io/npm/v/wukong-gitlog-cli.svg" alt="npm version"></a>
-  <a href="https://www.npmjs.com/package/wukong-gitlog-cli"><img src="https://img.shields.io/npm/dm/wukong-gitlog-cli.svg" alt="downloads"></a>
-  <a href="https://github.com/tomatobybike/wukong-gitlog-cli/blob/master/LICENSE"><img src="https://img.shields.io/github/license/tomatobybike/wukong-gitlog-cli.svg" alt="license"></a>
-  <a href="https://github.com/tomatobybike/wukong-gitlog-cli"><img src="https://img.shields.io/github/stars/tomatobybike/wukong-gitlog-cli.svg?style=social" alt="GitHub stars"></a>
-  <a href="https://github.com/tomatobybike/wukong-gitlog-cli/issues"><img src="https://img.shields.io/github/issues/tomatobybike/wukong-gitlog-cli.svg" alt="issues"></a>
-</p>
-
-Advanced Git commit log exporter with Excel/JSON/TXT output, grouping, stats and CLI.
-
-## English | [简体中文](./README.zh-CN.md)
+<p align="center"> <img src="https://raw.githubusercontent.com/tomatobybike/wukong-gitlog-cli/main/images/logo.svg" width="200" alt="wukong-dev Logo" /> </p> <p align="center"> <a href="https://www.npmjs.com/package/wukong-gitlog-cli"><img src="https://img.shields.io/npm/v/wukong-gitlog-cli.svg" alt="npm version"></a> <a href="https://www.npmjs.com/package/wukong-gitlog-cli"><img src="https://img.shields.io/npm/dm/wukong-gitlog-cli.svg" alt="downloads"></a> <a href="https://github.com/tomatobybike/wukong-gitlog-cli/blob/master/LICENSE"><img src="https://img.shields.io/github/license/tomatobybike/wukong-gitlog-cli.svg" alt="license"></a> <a href="https://github.com/tomatobybike/wukong-gitlog-cli"><img src="https://img.shields.io/github/stars/tomatobybike/wukong-gitlog-cli.svg?style=social" alt="GitHub stars"></a> <a href="https://github.com/tomatobybike/wukong-gitlog-cli/issues"><img src="https://img.shields.io/github/issues/tomatobybike/wukong-gitlog-cli.svg" alt="issues"></a> </p>
 
-## Features
+An enhanced Git commit log analysis and export tool. Supports **Excel / JSON / TXT** output, grouped statistics, overtime culture analysis, Gerrit link integration, and a visual Web Dashboard.
 
-- Export commit logs to JSON / text or Excel (XLSX)
-- Group commits by date (day / month)
-- Include a daily stats sheet in Excel
-- Optional Gerrit links per commit (custom template or prefix)
-- Small, dependency-friendly CLI using ZX and ExcelJS
+## [中文](./README.zh-CN.md) | English
 
 ---
 
-## What's new
+## ✨ Features
 
-- `--gerrit` option to show Gerrit links in text/excel/json output
-- `--out-dir` / `--out-parent` to control where output files are written (useful to avoid committing generated files)
-- `npm` demo scripts for quickly running examples (`cli:text-demo`, `cli:excel-demo`, `cli:json-demo`, `cli:gerrit-demo` and parent variants)
-- `src/utils` restructured with `src/utils/index.mjs` barrel to simplify imports
+- **Multi-format Export**: Export Git logs to JSON, Text, or Excel (XLSX).
+- **Flexible Grouping**: Support grouping by day or month.
+- **Overtime Analysis**: Analyze daily work hours, holidays, weekends, and cumulative risks.
+- **Gerrit Integration**: Customizable Gerrit URL templates (`{{hash}}`, `{{changeId}}`, `{{changeNumber}}`).
+- **Web Dashboard**: Interactive local dashboard with charts and risk summaries.
+- **Deduplication**: Automatically deduplicate commits by `Change-Id`.
+- **Author Mapping**: Support `authorAliases` to merge different emails/names into one person.
 
 ---
 
-## Installation
+## 📥 Installation
 
-Install globally to run with a short command (recommended for CLI consumers):
+Install globally (recommended):
 
 ```bash
-# Or install via npm when published:
 npm i -g wukong-gitlog-cli
-
+# or
 yarn global add wukong-gitlog-cli
 
-# Then you can run the CLI globally:
+# Run
 wukong-gitlog-cli --help
 ```
 
 ---
 
-## Usage
+## 🚀 Quick Start
 
 ```bash
-wukong-gitlog-cli --overtime  --serve --port 5555
-```
+# Initialize configuration
+wukong-gitlog-cli init
 
-```bash
-wukong-gitlog-cli [options]
+# Analyze and start web dashboard
+wukong-gitlog-cli serve --overtime
 ```
 
-Command-line options:
-
-- `--author <name>` Filter commits by author name
-- `--email <email>` Filter commits by author email
-- `--since <date>` Start date (e.g., 2025-01-01)
-- `--until <date>` End date
-- `--limit <n>` Limit number of commits
-- `--no-merges` Exclude merge commits
-- `--json` Output JSON
-- `--format <type>` Output format: `text` | `excel` | `json` (default: `text`)
-- `--group-by <type>` Group commits by date: `day` | `month`
-- `--overtime` Analyze overtime culture: output counts/percentages for commits outside work hours and on non-workdays (per-person breakdown)
-  - `--country <code>` Country/region for holidays (CN|US). Default: `CN`.
-  - `--work-start <hour>` Workday start hour. Default: `9`.
-  - `--work-end <hour>` Workday end hour. Default: `18`.
-  - `--lunch-start <hour>` Lunch break start hour. Default: `12`.
-  - `--lunch-end <hour>` Lunch break end hour. Default: `14`.
-- `--stats` Include a `Stats` sheet in the Excel export
-- `--gerrit-api <url>` Optional: Gerrit REST API base URL for resolving `{{changeNumber}}` (e.g. `https://gerrit.example.com/gerrit`)
-- `--gerrit-auth <token>` Optional: Authorization for Gerrit REST API (either `user:pass` for Basic or token string for Bearer)
-- `--gerrit <prefix>` Show Gerrit URL for each commit (supports templates `{{hash}}`, `{{changeId}}` and `{{changeNumber}}`; `{{changeId}}` falls back to `hash` when absent; `{{changeNumber}}` requires `--gerrit-api` and falls back to `changeId` or `hash`)
-- `--out <file>` Output file name (without path). Defaults: `commits.json` / `commits.txt` / `commits.xlsx`
-- `--out-dir <dir>` Output directory path — supports relative or absolute path, e.g., `--out-dir ../output`
-- `--serve` Start the local web service and view the submission statistics (data files will be generated under output/data)
-- `--port <n>` Local web service port (default: 3000)
-- `--serve-only` Only start the web service without exporting or analyzing data (using existing data in output/data)
-- `--version` show version information
-
-> Output files are written to an `output/` directory in the current working directory.
->
-> Tip: Use `--out-parent` or `--out-dir ../output` to write outputs into the parent folder's `output/` to avoid accidentally committing generated files to your repository.
-
-### Per-period outputs
-
-You can generate per-month and per-week outputs under `output/month/` and `output/week/` using the `--per-period-formats` option. Example:
+---
 
-```bash
-wukong-gitlog-cli --overtime --limit 200 --format text --out commits.txt --per-period-formats csv,tab
-```
+## 🛠 Commands
 
-Want per-period Excel outputs? Use `xlsx` along with `--per-period-excel-mode` for `sheets` or `files`:
+The tool is organized into several subcommands:
 
+### 1. `init`
+Initialize configuration file (`.wukonggitlogrc` in YAML, JS, or JSON format).
 ```bash
-wukong-gitlog-cli --overtime --limit 200 --format text --out commits.txt --per-period-formats csv,tab,xlsx --per-period-excel-mode sheets
-wukong-gitlog-cli --overtime --limit 200 --format text --out commits.txt --per-period-formats xlsx --per-period-excel-mode files
+wukong-gitlog-cli init [-f, --force]
 ```
 
-If you'd like only per-period outputs and not the combined monthly/weekly summary files, add `--per-period-only`:
-
+### 2. `analyze`
+Core analysis command. Fetches logs and performs comprehensive analysis.
 ```bash
-wukong-gitlog-cli --overtime --limit 200 --format text --out commits.txt --per-period-formats csv,tab,xlsx --per-period-only
+wukong-gitlog-cli analyze [options]
 ```
 
-### Serve a local dashboard
-
-You can start a small static web dashboard to visualize commit statistics and charts. It will export raw commits and analyzed stats into `output/data/` as `commits.mjs` and `overtime-stats.mjs`, and start a local web server serving `web/` and `output/data/`:
-
+### 3. `overtime`
+Focused on overtime culture analysis.
 ```bash
-# Start the server on the default port (3000)
-wukong-gitlog-cli --serve --overtime --limit 200 --out commits.txt
-
-# Start server only (use existing output/data)
-wukong-gitlog-cli --serve-only
-
-# Custom port
-wukong-gitlog-cli --serve --port 8080 --overtime --limit 200 --out commits.txt
+wukong-gitlog-cli overtime [options]
 ```
 
-Open `http://localhost:3000` to view the dashboard.
-
-<p align="center">
-  <img src="https://raw.githubusercontent.com/tomatobybike/wukong-gitlog-cli/main/images/web/overtime.jpg" width="400" alt="wukong-dev Logo" />
-</p>
-
----
-
-## Gerrit support
-
-Use the `--gerrit` option to include a Gerrit link for each commit. You can provide a template containing `{{hash}}` to place the full commit hash into the URL, for example:
-
+### 4. `export`
+Focuses on exporting data to different formats.
 ```bash
-wukong-gitlog-cli --gerrit "https://gerrit.example.com/c/project/+/{{hash}}" --limit 5 --format text
+wukong-gitlog-cli export [options]
 ```
 
-If `{{hash}}` is not present, the CLI will append the commit hash to the prefix with a `/` separator.
-
-You can also use `{{changeId}}` in the template to reference Gerrit change id. The tool will try to extract a `Change-Id: I...` value from the commit body and replace `{{changeId}}` with it. If it can't find a `Change-Id`, the CLI will fall back to using the commit `hash`.
-
-The Gerrit link will show up in:
-
-- The text output if `--format text` (as a new `Gerrit` column)
-- The Excel export as a `Gerrit` column if `--format excel`
-- JSON output will include a `gerrit` field for each record when `--gerrit` is used
-- JSON output will include a `gerrit` field for each record when `--gerrit` is used
-- When `--gerrit` uses `{{changeId}}`, the CLI will try to extract `Change-Id:` from the commit body and include `changeId` and `body` in the JSON record. If no `Change-Id` is present, the CLI falls back to `hash` when forming the Gerrit URL.
-
-Note: `--out <file>` is the filename only and the directory used to store that file depends on:
-
-- The default directory `./output/` in the current working directory
-- `--out-dir <dir>` to override the target folder (relative or absolute)
-- `--out-parent` to write to the parent repository folder `../output/` (same as `--out-dir ../output`)
-
-For example:
+### 5. `journal`
+Generate daily journals/logs.
+```bash
+wukong-gitlog-cli journal [options]
+```
 
+### 6. `serve`
+Start local Web Dashboard. It automatically runs analysis before starting.
 ```bash
-# using globally installed CLI
-wukong-gitlog-cli --out parent.json --out-parent
-wukong-gitlog-cli --out demo.txt --out-dir ../temp
+wukong-gitlog-cli serve [--port <n>]
 ```
 
 ---
 
-## Examples
+## ⚙️ Options
+
+### Global Options
+- `-l, --lang <code>`: Set language (en, zh-CN).
+- `--debug`: Enable debug mode.
+- `--info`: Show environment info (Git version, OS, etc.).
+
+### Git Options (for `analyze`, `overtime`, `export`, `journal`)
+- `--author <name>`: Filter by author name.
+- `--email <email>`: Filter by author email.
+- `--since <date>`: Start date (e.g., 2025-01-01).
+- `--until <date>`: End date.
+- `--limit <n>`: Limit number of commits.
+- `--no-merges`: Exclude merge commits.
+- `--path <path>`: Git repository path.
+
+### Analysis Options
+- `--work-start <hour>`: Standard work start hour (default: 9).
+- `--work-end <hour>`: Standard work end hour (default: 18).
+- `--overnight-cutoff <hour>`: Hour to cutoff for overnight work (default: 6).
+- `--country <code>`: Holiday calendar (CN, US, etc.).
+
+### Output Options
+- `-f, --format <type>`: Output format (text, excel, json).
+- `--out <file>`: Output filename.
+- `--out-dir <dir>`: Output directory.
+- `--stats`: Include statistics in Excel.
 
-Export as text, grouped by month, with Gerrit links:
-
-```bash
-wukong-gitlog-cli --format text --group-by month --gerrit "https://gerrit.example.com/c/project/+/{{hash}}"
-```
+---
 
-// Resolve numeric change ID using Gerrit API (if available)
-wukong-gitlog-cli --format text --group-by month --gerrit "https://gerrit.example.com/c/project/+/{{changeNumber}}" --gerrit-api <GERRIT_API_BASE_URL>
+## 📊 Web Dashboard
 
-If your Gerrit requires authentication (HTTP Basic or token), use `--gerrit-auth`:
+Start the server to view interactive charts:
 
 ```bash
-# HTTP Basic: username:password
-wukong-gitlog-cli --format text --gerrit "https://gerrit.example.com/c/project/+/{{changeNumber}}" --gerrit-api <GERRIT_API_BASE_URL> --gerrit-auth "username:password"
-
-# Token (Bearer)
-wukong-gitlog-cli --format text --gerrit "https://gerrit.example.com/c/project/+/{{changeNumber}}" --gerrit-api <GERRIT_API_BASE_URL> --gerrit-auth "MYTOKEN"
+wukong-gitlog-cli serve
 ```
 
-Export to Excel with stats and Gerrit URLs:
+<p align="center">
+  <img src="https://raw.githubusercontent.com/tomatobybike/wukong-gitlog-cli/main/images/web/overtime.jpg" width="400" alt="wukong-dev Logo" />
+</p>
 
-```bash
-wukong-gitlog-cli --format excel --stats --gerrit "https://gerrit.example.com/c/project/+/{{hash}}"
-```
 
-Export raw JSON:
+Visit `http://localhost:3000` to see:
+- Commit distribution by day/month.
+- Overtime trends and peak hours.
+- **Recent 30-day Overtime Risk**: Automatically calculates cumulative overtime for the last 30 days and flags risks (Mild, Moderate, Severe).
 
-```bash
-wukong-gitlog-cli --json --out commits.json
-```
+---
 
-Export text to a custom directory (parent output folder):
+## 🔗 Gerrit Support
 
+Use templates in Gerrit URLs:
 ```bash
-wukong-gitlog-cli --out-dir ../output --format text --limit 5 --out custom1.txt
+wukong-gitlog-cli analyze --gerrit "https://gerrit.example.com/c/project/+/{{hash}}"
 ```
 
----
-
+To use numeric `changeNumber`, provide the Gerrit API:
 ```bash
-wukong-gitlog-cli --overtime --limit 500
+wukong-gitlog-cli analyze --gerrit "https://gerrit.example.com/c/project/+/{{changeNumber}}" --gerrit-api https://gerrit.example.com/gerrit
 ```
 
-## Notes & Developer Info
+---
 
-- The CLI prints helpful messages after exporting files and writes outputs to the `output/` folder in the repo root.
-- Internally `src/utils/index.mjs` acts as a barrel that re-exports helper functions located in `src/utils/`.
-- If you plan to reuse the helpers in other modules, import from `./src/utils/index.mjs` explicitly.
-- The Excel export uses `exceljs` and adds an `autoFilter` to the sheet header.
+## 🧾 Author Mapping (`authorAliases`)
 
-Suggested `.gitignore` snippet (to avoid accidentally committing generated files):
+Merge multiple identities in configuration:
 
-```gitignore
-# ignore commit exports
-output/
-custom-output/
+```yaml
+authorAliases:
+  "tomatoboy@abc.com": "tomatoboy"
+  "tomato@xxx.com": "tomatoboy"
+  "Tom Jacky": "tomatoboy"
 ```
 
 ---
 
-## Contributing
-
-PRs are welcome — add tests and keep changes modular. If you add new CLI flags or new fields in commit records, please update this README accordingly.
-
----
-
-## License
+## 📄 License
 
 MIT