git-fish-log 1.0.7 → 1.0.9

package/README-/345/225/260/345/227/246/347/211/210.md

@@ -48,12 +48,17 @@ npm link
   * `host`: 可选。私有部署的 GitLab 域名（如 `https://gitlab.mycompany.com`），缺省默认使用 `https://gitlab.com`。
   * `name`: 可选。给该数据源指定的别名（如 `my-company`），缺省时自动使用 host 域名作为别名。若别名已存在则会覆盖更新。
 
-## 🆕 v1.0.7 更新内容
+## 🆕 v1.0.9 更新内容
+
+- **月报新增节假日与调休标记**：每日摸鱼指数概览中，法定节假日日期后追加绿色圆点 `•`，法定调休上班日（周末补班）追加红色叹号 `!`，一眼分辨哪天是假日、哪天在还债。内置 2025-2026 年中国法定节假日数据，周末自动识别。
+
+## 🆕 v1.0.8 更新内容
+
+- **摸鱼指数算法 v2 重设计**：引入「有效 Commit」概念（单次增删 ≥ 20 行），天然过滤格式化/小修复；代码行数改用 log₁₀ 压缩并降权至 10%，工作时长+时间分布合计占 50% 权重，摸鱼/爆肝判断更贴合直觉。详情见下方「算法说明」章节。
+- **新增代码量指数（🧱 Code Volume Index）**：独立于摸鱼指数，纯基于修改行数 L 采用对数公式 `51.3·log₁₀(L+50)-79.5` 映射到 0~100 分，六档等级从「✏️ 改两行就下班」到「☢️ 这提交能过 CR？」。
+- **锐评系统全面升级**：新增 11 类标签锐评池（摸鱼宗师/爆肝战神/深夜修仙者/勤恳搬砖人/一把梭哈/PPT 架构师/格式化大师/Git 聊天达人/深夜刺客/生产队的驴/摸鱼仙人），根据每日人格标签触发对应幽默吐槽。
+- **周报新增代码行数 & 修仙指数展示**：每日报告同时展示 🧱 代码量、🌙 修仙指数，多维度可视化你的开发日常。
 
-- **摸鱼指数算法校准**：降低 `commitScore`、`lineScore`、`densityScore` 和 `spanScore` 的基础斜率，让轻量提交、小改动、正常工作跨度不再直接把摸鱼指数打到很低。
-- **月报日历优化**：`每日摸鱼指数概览` 增加周几表头，并按周一到周日真实日历网格排列。
-- **GitLab 全分支统计**：远程 Commit 查询增加 `all=true`，周报、月报、项目排行、时间分布和幽灵提交检测都会统计所有分支。
-- **Node 兼容增强**：优先使用 Node 18+ 原生 `fetch`，低版本 Node 自动走内置 `http/https` fallback，避免 `fetch is not defined`。
 
 ---
 
@@ -71,7 +76,7 @@ fish
 
 📅 本周提交详情：
   周一：0 次 | 🐟 摸鱼指数: 90% (终极摸鱼 🎣)  🏷 🐟 今日暂无代码活动
-  周二：2 次 | 🐟 摸鱼指数: 51% (正常营业 💻) | 1个项目 (项目名称)
+  周二：2 次 | 🐟 摸鱼指数: 51% (正常营业 💻) | 🧱 代码量: 150行 (大型改动 🧱) | 1个项目 (项目名称)
   周三：0 次 | 🐟 摸鱼指数: 90% (终极摸鱼 🎣)  🏷 🐟 今日暂无代码活动
   周四：未到
   周五：未到
@@ -79,7 +84,7 @@ fish
 --------------------------------------------------
 ☕ 最快乐的日子：周一、周三、周四、周五 | 🐟 摸鱼指数：90%
 --------------------------------------------------
-📊 本周均值：🐟 摸鱼 77%
+📊 本周均值：🐟 摸鱼指数 77%
 --------------------------------------------------
 🤖 锐评：
 看来本周的项目进入了‘养精蓄锐’阶段——手机太好玩，或者床太暖和。摸鱼技巧已达炉火纯青之境。
@@ -105,22 +110,17 @@ fish -m
 
 📅 每日摸鱼指数概览：
   周一    周二    周三    周四    周五    周六    周日
-                                  5月1日  5月2日  5月3日
-                                  90%     90%     90%
+  6月1日  6月2日  6月3日  6月4日  6月5日  6月6日  6月7日
+  67%     50%     48%     76%     95%     95%     95%
 
-  5月4日  5月5日  5月6日  5月7日  5月8日  5月9日  5月10日
-  90%     90%     28%     90%     23%     19%     90%
+  6月8日  6月9日  6月10日 6月11日 6月12日 6月13日 6月14日
+  78%     78%     38%     47%     38%     95%     95%
 
-  5月11日 5月12日 5月13日 5月14日 5月15日 5月16日 5月17日
-  61%     39%     23%     90%     90%     90%     90%
+  6月15日 6月16日 6月17日 6月18日 6月19日•6月20日•6月21日•
+  57%     77%     42%     64%     95%     95%     95%
 
-  5月18日 5月19日 5月20日 5月21日 5月22日 5月23日 5月24日
-  39%     43%     38%     28%     25%     90%     90%
-
-  5月25日 5月26日 5月27日 5月28日 5月29日 5月30日 5月31日
-  61%     28%     35%     34%     20%     90%     90%
-
-  🔥 爆肝王: 5月9日 → 摸鱼指数 19% 🔥 爆肝战神 🧱 勤恳搬砖人
+  6月22日 6月23日 6月24日 6月25日 6月26日 6月27日 6月28日
+  95%     51%     95%     95%     78%     95%     95%
 
 --------------------------------------------------
 🤖 锐评：
@@ -261,7 +261,38 @@ fish -g
 
 ---
 
-## 🎨 算法说明：摸鱼指数计算公式
+## 🎨 算法说明：摸鱼指数计算公式（v2 重设计）
+
+### 设计哲学
+
+摸鱼指数（0~100）是反向指标——**越高越摸鱼**。算法的核心假设是：
+
+> Commit 次数、持续工作时长、提交分布，比代码行数更能体现"没摸鱼"。
+> 代码行数仅作辅助参考，使用对数压缩并降低权重。
+
+### 指标区间直觉
+
+| 摸鱼指数 | 含义 | 典型场景 |
+|----------|------|----------|
+| 95~100 | 几乎没干活 | 0 commit，或仅 1~2 行微调 |
+| 70~85 | 小需求、小修复，整体悠闲 | 1~3 个有效 Commit，1~3 小时 |
+| 40~60 | 正常搬砖 | 4~7 个有效 Commit，4~8 小时 |
+| 20~40 | 爆肝工作 | 8~12 个有效 Commit，8~12 小时 |
+| 0~20 | 通宵上线、人形 CI/CD | 13+ 有效 Commit，12+ 小时 + 深夜 |
+
+### 核心概念：有效 Commit
+
+只有单次修改行数（additions + deletions）**≥ 20 行**的 Commit 才算"有效 Commit"。
+这可以天然过滤掉：
+
+- 格式化 / 缩进调整
+- 单行 typo 修复
+- 配置微调
+- 注释增删
+
+用 \(N_{eff}\) 表示有效 Commit 数量，只有它参与核心计分。
+
+### 五项子指标
 
 每天同时计算 **五个维度**的指数：
 
@@ -269,42 +300,129 @@ fish -g
 |------|------|
 | 🐟 摸鱼指数 | 反向指标，越高越摸鱼 |
 | 🌙 修仙指数 | 深夜 (00:00-05:00) 提交频率 |
-| 🧱 搬砖指数 | 代码量 (additions + deletions) + 提交频率 |
+| 🧱 搬砖指数 | 代码量 + 有效提交频率 |
 | 💥 爆发指数 | 单次提交修改量（一把梭） |
 | 🏷 人格标签 | 任意指数 ≥ 80 时触发 + 隐藏成就 |
 
 ### 输入数据
 
-- $N$ = 当天 Commit 数量
-- $S$ = 最早与最晚 Commit 时间跨度（小时）
-- $L$ = 总修改行数 (additions + deletions)
-- $avgLines = L / \max(N, 1)$ = 平均每次修改行数
-- $D = N / (S + 1)$ = Commit 密度
-- $Night$ = 深夜 (00:00-05:00) 提交数
-- $Weekend$ = 是否为周末
+- \(N\) = 当天 Commit 总数
+- \(N_{eff}\) = 有效 Commit 数（增删 ≥ 20 行）
+- \(S\) = 最早与最晚 Commit 时间跨度（小时）
+- \(L\) = 总修改行数 (additions + deletions)
+- \(H_{active}\) = 有至少 1 次 Commit 的小时数
+- \(Night\) = 深夜 (00:00-05:00) 提交数
+- \(Weekend\) = 是否为周末
 
-### 基础得分（0 ~ 100）
+### 子分数计算（各项 0 ~ 100）
 
-| 得分项 | 公式 | 设计意图 |
-|--------|------|----------|
-| 提交活跃度 | $\min(100,\ \log_2(N+1) \times 18)$ | 对数防刷 commit，降低轻量提交惩罚 |
-| 工时跨度 | $\min(100,\ \sqrt{S} \times 18)$ | 平方根防拉长跨度，避免正常工时过度爆肝 |
-| 代码活跃度 | $\min(100,\ \log_2(L+1) \times 8)$ | 对数防刷行数，避免小改动直接拉低摸鱼指数 |
-| 密度得分 | $N \le 1$ 时为 0，否则 $\min(100,\ D \times 35)$ | 单次提交无密度可言，密集提交才明显加分 |
-| 修仙得分 | $\min(100,\ Night \times 30)$ | 深夜加班证据 |
+#### I₁ 有效提交分（权重 35%）
 
-### 最终指数
+\[
+commitScore = \min(100,\ \log_2(N_{eff} + 1) \times 20)
+\]
 
-```
-hardworking = 提交活跃度×0.30 + 代码活跃度×0.30 + 密度得分×0.20 + 工时跨度×0.20
-if (isWeekend && N > 0) hardworking += 8
-hardworking = min(100, round(hardworking))
-
-fish       = max(1, 100 - hardworking)
-nightOwl   = min(100, round(修仙得分×0.7 + 工时跨度×0.3))
-builder    = min(100, round(代码活跃度×0.7 + 提交活跃度×0.3))
-burst      = min(100, round(log₂(avgLines + 1) × 12))
-```
+对数衰减防刷 Commit。校准点：
+
+| \(N_{eff}\) | 0 | 1 | 2 | 3 | 5 | 7 | 10 | 15 |
+|--------------|---|---|---|---|---|---|----|-----|
+| commitScore | 0 | 20 | 32 | 40 | 52 | 60 | 69 | 80 |
+
+#### I₂ 工时跨度分（权重 30%）
+
+\[
+spanScore = \min(100,\ \sqrt{S} \times 22)
+\]
+
+平方根防无限拉长跨度。校准点：
+
+| \(S\) (h) | 0.5 | 1 | 2 | 4 | 6 | 8 | 10 | 12 |
+|------------|-----|----|----|----|----|----|----|-----|
+| spanScore | 16 | 22 | 31 | 44 | 54 | 62 | 70 | 76 |
+
+#### I₃ 时间分布分（权重 20%）
+
+\[
+spreadScore = \min(100,\ H_{active} \times 12)
+\]
+
+有 Commit 的小时数越多，说明不是集中突击、而是持续投入。
+
+| \(H_{active}\) | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8+ |
+|-----------------|---|---|---|---|---|---|---|-----|
+| spreadScore | 12 | 24 | 36 | 48 | 60 | 72 | 84 | 96+ |
+
+#### I₄ 代码行数加分（权重 10%）
+
+\[
+lineBonus = \min(100,\ \log_{10}(L + 1) \times 25)
+\]
+
+log₁₀ 重度压缩 + 10% 低权重，避免 200 行被误判为大量工作。
+
+| \(L\) | 10 | 100 | 200 | 500 | 1000 | 2000 | 5000 |
+|--------|-----|------|------|------|-------|-------|-------|
+| lineBonus | 26 | 50 | 58 | 68 | 75 | 83 | 93 |
+
+#### I₅ 深夜加成（+5 分）
+
+\[
+nightBonus = Night > 0\ ?\ 5 : 0
+\]
+
+有深夜提交直接加 5 分工作分，不参与权重乘法。
+
+### 最终公式
+
+\[
+\begin{aligned}
+workScore &= commitScore \times 0.35 \\
+           &+ spanScore \times 0.30 \\
+           &+ spreadScore \times 0.20 \\
+           &+ lineBonus \times 0.10 \\
+           &+ nightBonus \\[4pt]
+if\ (isWeekend\ \&\&\ N > 0):\quad workScore &+= 5 \\[4pt]
+hardworking &= \min(100,\ round(workScore)) \\[4pt]
+fish &= \max(1,\ 100 - hardworking)
+\end{aligned}
+\]
+
+#### 修仙指数
+
+\[
+nightScore = \min(100,\ Night \times 30)
+\]
+\[
+nightOwl = Night = 0\ ?\ 0 : \min(100,\ round(nightScore \times 0.7 + spanScore \times 0.3))
+\]
+
+#### 搬砖指数
+
+\[
+builder = \min(100,\ round(lineBonus \times 0.6 + commitScore \times 0.4))
+\]
+
+#### 爆发指数
+
+\[
+avgLines = N_{eff} > 0\ ?\ \frac{effLines}{N_{eff}} : \frac{L}{\max(N,1)}
+\]
+\[
+burst = \min(100,\ round(\log_2(avgLines + 1) \times 12))
+\]
+
+### 典型场景校验
+
+| 场景 | N | \(N_{eff}\) | S(h) | \(H_{active}\) | L | fish |
+|------|---|--------------|------|------------------|---|------|
+| 摸鱼一天 | 0 | 0 | 0 | 0 | 0 | **95** |
+| 小修小补 | 1 | 0 | 0.1 | 1 | 15 | **89** |
+| 小需求 | 2 | 1 | 1 | 1 | 150 | **80** |
+| 轻量一天 | 3 | 2 | 3 | 2 | 300 | **69** |
+| 正常搬砖 | 6 | 5 | 6 | 4 | 600 | **49** |
+| 较忙 | 8 | 7 | 8 | 5 | 900 | **39** |
+| 爆肝 | 12 | 10 | 10 | 7 | 1500 | **28** |
+| 通宵上线 | 18 | 15 | 14 | 10 | 3000 | **16** |
 
 ### 人格标签
 
@@ -320,13 +438,25 @@ burst      = min(100, round(log₂(avgLines + 1) × 12))
 
 | 条件 | 成就 |
 |------|------|
-| 提交活跃度 ≥ 70 且 代码活跃度 ≤ 15 | 🏷 PPT 架构师 |
+| N ≥ 8 且 \(N_{eff}\) ≤ 1 且 L ≤ 50 | 🏷 PPT 架构师 |
 | N ≥ 10 且 L ≤ 30 | 🏷 格式化大师 |
-| N ≥ 15 且 avgLines ≤ 2 | 🏷 Git 聊天达人 |
+| N ≥ 15 且 L/N ≤ 2 | 🏷 Git 聊天达人 |
 | 修仙 ≥ 80 且 N ≤ 3 | 🏷 深夜刺客 |
 | 爆肝 ≥ 90 且 修仙 ≥ 70 且 周末 | 🏷 生产队的驴 |
 | 摸鱼 ≥ 95 且 N ≤ 1 | 🏷 摸鱼仙人 |
 
 ### 特殊情况
 
-- **0 Commit**：摸鱼 = 90（不判 100，可能开会/调研/排查问题），其余为 0，标签 = "🐟 今日暂无代码活动"
+- **0 Commit**：摸鱼 = 95（不判 100，可能开会/调研/排查问题），其余为 0，标签 = "🐟 今日暂无代码活动"
+- **纯刷 Commit（大量 <20 行的提交）**：\(N_{eff}\) = 0 → commitScore = 0，工作分主要来自 span/spread，摸鱼指数保持在 80+
+- **单次大提交（如 500 行 1 次 Commit）**：commitScore = 20，spreadScore ≤ 12，工作分 ≈ 17，摸鱼 ≈ 83 — 一把梭不算持续工作
+
+### v2 vs v1 改进要点
+
+| 问题 | v1 行为 | v2 改进 |
+|------|---------|---------|
+| 150 行小需求 | fish ≈ 55，被判"正常营业" | fish ≈ 80，合理识别为悠闲 |
+| 刷 Commit（多次小提交） | 每次提交都计分，轻松拉低 fish | 仅 ≥20 行有效提交才计分 |
+| 行数权重过高 | lineScore 权重 30%，200 行已显著加分 | log₁₀ 压缩 + 权重 10%，大幅抑制 |
+| 缺少分布维度 | 密度分仅看 Commit/时间比 | 新增 spreadScore，奖励跨小时持续工作 |
+| 0 commit 基线 | fish = 90 | fish = 95，工作日自然摸鱼基线 |

package/README.md

@@ -33,13 +33,16 @@
   * `host`: 可选。私有部署的 GitLab 域名（如 `https://gitlab.mycompany.com`），缺省默认使用 `https://gitlab.com`。
   * `name`: 可选。给该数据源指定的别名（如 `my-company`），缺省时自动使用 host 域名作为别名。若别名已存在则会覆盖更新。
 
+## 🆕 v1.0.9 更新内容
 
-## 🆕 v1.0.7 更新内容
+- **月报新增节假日与调休标记**：每日摸鱼指数概览中，法定节假日日期后追加绿色圆点 `•`，法定调休上班日（周末补班）追加红色叹号 `!`，一眼分辨哪天是假日、哪天在还债。内置 2025-2026 年中国法定节假日数据，周末自动识别。
 
-- 校准摸鱼指数算法：降低轻量提交、小改动和正常工时跨度对爆肝分的惩罚，避免「只要有提交就很低」。
-- 优化月报每日摸鱼指数概览：按周一到周日真实日历排列，并标注周几。
-- GitLab 远程扫描默认统计所有分支提交，不再只看默认分支。
-- 修复低版本 Node 环境缺少 `fetch` 时 GitLab 连接失败的问题。
+## 🆕 v1.0.8 更新内容
+
+- **摸鱼指数算法 v2 重设计**：引入「有效 Commit」概念（单次增删 ≥ 20 行），天然过滤格式化/小修复；代码行数改用 log₁₀ 压缩并降权至 10%，工作时长+时间分布合计占 50% 权重，摸鱼/爆肝判断更贴合直觉。
+- **新增代码量指数（🧱 Code Volume Index）**：独立于摸鱼指数，纯基于修改行数 L 采用对数公式 `51.3·log₁₀(L+50)-79.5` 映射到 0~100 分，六档等级从「✏️ 改两行就下班」到「☢️ 这提交能过 CR？」。
+- **锐评系统全面升级**：新增 11 类标签锐评池（摸鱼宗师/爆肝战神/深夜修仙者/勤恳搬砖人/一把梭哈/PPT 架构师/格式化大师/Git 聊天达人/深夜刺客/生产队的驴/摸鱼仙人），根据每日人格标签触发对应幽默吐槽。
+- **周报新增代码行数 & 修仙指数展示**：每日报告同时展示 🧱 代码量、🌙 修仙指数，多维度可视化你的开发日常。
 
 
 ## 📖 CLI 命令行示例
@@ -56,7 +59,7 @@ fish
 
 📅 本周提交详情：
   周一：0 次 | 🐟 摸鱼指数: 90% (终极摸鱼 🎣)  🏷 🐟 今日暂无代码活动
-  周二：2 次 | 🐟 摸鱼指数: 51% (正常营业 💻) | 1个项目 (项目名称)
+  周二：2 次 | 🐟 摸鱼指数: 51% (正常营业 💻) | 🧱 代码量: 150行 (大型改动 🧱) | 1个项目 (项目名称)
   周三：0 次 | 🐟 摸鱼指数: 90% (终极摸鱼 🎣)  🏷 🐟 今日暂无代码活动
   周四：未到
   周五：未到
@@ -64,7 +67,7 @@ fish
 --------------------------------------------------
 ☕ 最快乐的日子：周一、周三 | 🐟 摸鱼指数：90%
 --------------------------------------------------
-📊 本周均值：🐟 摸鱼 77%
+📊 本周均值：🐟 摸鱼指数 77%
 --------------------------------------------------
 🤖 锐评：
 看来本周的项目进入了‘养精蓄锐’阶段——手机太好玩，或者床太暖和。摸鱼技巧已达炉火纯青之境。