git-fish-log 1.0.3 → 1.0.4

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

@@ -0,0 +1,321 @@
+# 🐟 fish - Git 摸鱼 & 爆肝分析器
+
+`fish` 是一个好玩有趣的命令行工具（CLI），专为程序员设计。它通过扫描本地 Git 仓库的 Commit 历史（支持多项目扫描和自动发现），深度挖掘你的开发轨迹，自动计算出你每天的**“摸鱼指数”**，生成幽默风趣的周报与月报，并配有令人会心一笑的 **AI 风格无情吐槽**！
+
+---
+
+## ✨ 核心特色
+
+1. **摸鱼指数算法**：基于每日提交次数与提交时间跨度进行轻量级多维拟合。0 次提交为 99% 摸鱼，频繁提交且跨度长达 8 小时以上为 10% 狂热爆肝。
+2. **多维度报告展示**：
+   - **默认周报**：按天梳理工作轨迹、努力/轻松天数以及趣味 锐评。
+   - **月度分析 (`-m`)**：利用常规 Git 提交前缀正则分类（`feat`/`fix`/`chore`/`docs`），生成图形化比例条与深度吐槽。
+   - **项目排行榜 (`-p`)**：对比你名下各个项目的爆肝程度，定位你的“主力搬砖地”与“划水摸鱼点”。
+   - **黄金时间段分析 (`-t`)**：绘制 24 小时 commit 频次分布柱状图，精准识别你的下班突击时间和开会摸鱼期。
+   - **深夜幽灵检测 (`-g`)**：统计半夜 12 点至凌晨 5 点的 commits，劝阻无谓爆肝，保命要紧！
+3. **多仓库/多项目管理**：支持将多个 Git 仓库注册到全局配置中，甚至支持一键递归扫描某目录下所有的 Git 仓库。
+4. **极速零阻塞体验**：纯原生 `git log` 命令执行并返回结构化数据，不依赖大型第三方封装，由 `tsup` 预打包为极轻量独立 ESM 运行。
+
+---
+
+
+
+## 🚀 安装与使用指南
+
+### 1. 克隆与安装依赖
+```bash
+npm install
+```
+
+### 2. 编译打包
+```bash
+npm run build
+```
+编译产物会生成在 `./dist/index.js`
+
+### 3. 全局链接 CLI 命令
+在当前目录中运行：
+```bash
+npm link
+```
+这将在你全局的 `npm` bin 目录中创建符号链接。你现在可以在系统的任何目录中直接通过 `fish` 运行该程序了！
+### 4.配置【划重点】
+配置/新增 GitLab 远程扫描源（支持多数据源管理）：
+  ```bash
+  fish config gitlab <token> [host] [name]
+  ```
+  * `token`: 你的 GitLab 个人/项目访问令牌 (PAT)，需有 `read_api` 或 `api` 权限。
+  * `host`: 可选。私有部署的 GitLab 域名（如 `https://gitlab.mycompany.com`），缺省默认使用 `https://gitlab.com`。
+  * `name`: 可选。给该数据源指定的别名（如 `my-company`），缺省时自动使用 host 域名作为别名。若别名已存在则会覆盖更新。
+
+---
+
+## 📖 CLI 命令行示例
+
+### 1. 基础摸鱼周报（月报）
+```bash
+fish
+```
+默认展示本周（周一零点至周日 23:59）的所有提交记录以及每日的摸鱼指数统计。
+```bash
+==================================================
+ 🐟 FISH - 本周 Git 摸鱼周报
+==================================================
+
+📅 本周提交详情：
+  周一：0 次 | 🐟 摸鱼指数: 90% (终极摸鱼 🎣)  🏷 🐟 今日暂无代码活动
+  周二：2 次 | 🐟 摸鱼指数: 51% (正常营业 💻) | 1个项目 (项目名称)
+  周三：0 次 | 🐟 摸鱼指数: 90% (终极摸鱼 🎣)  🏷 🐟 今日暂无代码活动
+  周四：未到
+  周五：未到
+
+--------------------------------------------------
+☕ 最快乐的日子：周一、周三、周四、周五 | 🐟 摸鱼指数：90%
+--------------------------------------------------
+📊 本周均值：🐟 摸鱼 77%
+--------------------------------------------------
+🤖 锐评：
+看来本周的项目进入了‘养精蓄锐’阶段——手机太好玩，或者床太暖和。摸鱼技巧已达炉火纯青之境。
+```
+
+### 2. 月度报告与工作分类
+```bash
+fish --month
+# 或
+fish -m
+```
+查看本月的所有 Commit 分类（Bug 修复、新功能、杂务文档、其他）占比图以及大月度 锐评。
+```bash
+==================================================
+ 🐟 FISH - 本月 Git 摸鱼月报
+==================================================
+
+📅 本月主要贡献占比 (基于 Commit Message 正则归类)：
+  - 修 bug (fix)        ：[■■■□□□□□□□□□□□□] 18% (10 次)
+  - 新功能 (feat)       ：[■■■■■■■■■□□□□□□] 62% (34 次)
+  - 杂务与文档 (chore)  ：[■■■□□□□□□□□□□□□] 18% (10 次)
+  - 其他提交 (other)    ：[□□□□□□□□□□□□□□□] 2% (1 次)
+
+📅 每日摸鱼指数概览：
+  6月1日  6月2日  6月3日  6月4日  6月5日  6月6日  6月7日
+  36%     40%     90%     38%     90%     90%     90%
+
+  6月8日  6月9日  6月10日 6月11日 6月12日 6月13日 6月14日
+  90%     90%     20%     34%     11%     90%     90%
+
+  6月15日 6月16日 6月17日 6月18日 6月19日 6月20日 6月21日
+  32%     38%     23%     35%     90%     90%     90%
+
+  6月22日 6月23日 6月24日
+  90%     51%     90%
+
+  🔥 爆肝王: 6月12日 → 摸鱼指数 11% 🔥 爆肝战神 🧱 勤恳搬砖人
+
+--------------------------------------------------
+🤖 锐评：
+本月 Feat 占比高达 62%。新功能一项接一项，开发火力全开，业务线因你而飞速前进！
+```
+
+### 3. 横向项目爆肝排行
+```bash
+fish --project
+# 或
+fish -p
+```
+对目前配置监控的多个项目按照 Commit 数量进行降序排行，并配有幽默的地位标识。
+```bash
+fish -w 1 -p
+```
+```bash
+==================================================
+ 🐟 FISH - 项目爆肝排行 (上周)
+==================================================
+
+📊 对应时段项目爆肝排行 (2026/6/15 ~ 2026/6/21)
+  1. 项目名称: 13 次提交 (主力搬砖地 🧱)
+  2. 项目名称: 3 次提交 (偶尔上去点一下 🐟)
+  3. 项目名称: 2 次提交 (边缘挂机项目 💤)
+  4. 项目名称: 1 次提交 (测完就跑，纯粹路过 🚬)
+```
+
+### 4. 24 小时黄金提交时间段图表
+```bash
+fish --time
+# 或
+fish -t
+```
+以水平柱状图形象打印 24 小时中你提交代码的波峰和波谷，包含个性化的时段说明。
+```bash
+fish -w 1 -t
+```
+```bash
+==================================================
+ 🐟 FISH - 黄金工作时间段分析 (24小时分布) (上周)
+==================================================
+
+🕒 对应时段 24 小时 commit 频次分布图：
+  00:00 | [                              ] 0 次
+  01:00 | [                              ] 0 次
+  02:00 | [                              ] 0 次
+  03:00 | [                              ] 0 次
+  04:00 | [                              ] 0 次
+  05:00 | [                              ] 0 次
+  06:00 | [                              ] 0 次
+  07:00 | [                              ] 0 次
+  08:00 | [                              ] 0 次
+  09:00 | [██████                        ] 3 次 (上午表演型选手 🚀)
+  10:00 | [██████████████████████████    ] 12 次 (上午表演型选手 🚀)
+  11:00 | [██████████████████████████████] 14 次 (正常人类工作时间 ✅)
+  12:00 | [██                            ] 1 次 (干饭是第一生产力 🍚)
+  13:00 | [█████████████                 ] 6 次 (干饭是第一生产力 🍚)
+  14:00 | [█████████████                 ] 6 次 (午后灵魂出窍者 👻)
+  15:00 | [██████████████████████████████] 14 次 (CPU 重启中 🔄)
+  16:00 | [███████████████████           ] 9 次 (临近下班突然勤奋 🤔)
+  17:00 | [██████████████████████████████] 14 次 (临近下班突然勤奋 🤔)
+  18:00 | [████                          ] 2 次 (自愿（被迫）加班人 💪)
+  19:00 | [                              ] 0 次
+  20:00 | [                              ] 0 次
+  21:00 | [                              ] 0 次
+  22:00 | [                              ] 0 次
+  23:00 | [                              ] 0 次
+```
+
+### 5. 幽灵提交检测
+```bash
+fish --ghost
+# 或
+fish -g
+```
+检测本周在 00:00 - 05:00 期间生成的 Commit，如有发现，会触发防猝死警告与尖锐吐槽。
+```bash
+==================================================
+ 🐟 FISH - 幽灵提交检测 (深夜 00:00 ~ 05:00)
+==================================================
+
+🎉 恭喜！本时间段内未检测到任何深夜幽灵提交。
+你的发际线十分安全，大福报已被无情拒收，睡眠健康得分：100 分！
+```
+
+### 6. 报告时间偏移与远程源筛选 (通用选项)
+在运行任何报告命令时，都可以配合以下选项：
+- **`-w, --weeks-ago <number>`**：查看之前某周/某月的报告（默认 `0` 表示本周/本月，`1` 表示上周/上月，`2` 表示上上周/上上月，以此类推）。
+  ```bash
+  # 查看上周的摸鱼周报
+  fish -w 1
+  # 查看两个月前的摸鱼月报
+  fish -m 2
+  ```
+- **`-s, --source <source>`**：指定要查询的 GitLab 远程数据源，支持填别名或序号（例如 `1`, `2`）。如不填默认查询首个配置。
+  ```bash
+  # 查询别名为 company-gitlab 的源在上周的数据
+  fish -w 1 -s company-gitlab
+  ```
+
+---
+
+### 7. 项目与 GitLab 配置管理命令 (`fish config`)
+- **列出当前配置的所有监控项目与 GitLab 源**：
+  ```bash
+  fish config list
+  ```
+
+- **【划重点】配置/新增 GitLab 远程扫描源（支持多数据源管理）**：
+  ```bash
+  fish config gitlab <token> [host] [name]
+  ```
+  * `token`: 你的 GitLab 个人/项目访问令牌 (PAT)，需有 `read_api` 或 `api` 权限。
+  * `host`: 可选。私有部署的 GitLab 域名（如 `https://gitlab.mycompany.com`），缺省默认使用 `https://gitlab.com`。
+  * `name`: 可选。给该数据源指定的别名（如 `my-company`），缺省时自动使用 host 域名作为别名。若别名已存在则会覆盖更新。
+- **清除 GitLab 远程扫描配置**：
+  ```bash
+  # 清除指定的某一个 GitLab 配置（支持写序号或别名）
+  fish config gitlab-clear <name_or_index>
+  
+  # 清除所有的 GitLab 配置并关闭远程扫描
+  fish config gitlab-clear
+  ```
+
+- **手动添加一个本地 Git 仓库**：
+  ```bash
+  fish config add <path_to_repo>
+  ```
+- **从监控列表中移除一个仓库**：
+  ```bash
+  fish config remove <path_to_repo>
+  ```
+- **自动扫描指定目录下的一级子目录，批量添加 Git 仓库**：
+  ```bash
+  fish config scan <root_path>
+  ```
+
+---
+
+## 🎨 算法说明：摸鱼指数计算公式
+
+每天同时计算 **五个维度**的指数：
+
+| 指数 | 说明 |
+|------|------|
+| 🐟 摸鱼指数 | 反向指标，越高越摸鱼 |
+| 🌙 修仙指数 | 深夜 (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$ = 是否为周末
+
+### 基础得分（0 ~ 100）
+
+| 得分项 | 公式 | 设计意图 |
+|--------|------|----------|
+| 提交活跃度 | $\min(100,\ \log_2(N+1) \times 25)$ | 对数防刷 commit |
+| 工时跨度 | $\min(100,\ \sqrt{S} \times 25)$ | 平方根防拉长跨度 |
+| 代码活跃度 | $\min(100,\ \log_2(L+1) \times 12)$ | 对数防刷行数 |
+| 密度得分 | $N \le 1$ 时为 0，否则 $\min(100,\ D \times 50)$ | 单次提交无密度可言 |
+| 修仙得分 | $\min(100,\ Night \times 30)$ | 深夜加班证据 |
+
+### 最终指数
+
+```
+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))
+```
+
+### 人格标签
+
+| 条件 | 标签 |
+|------|------|
+| 🐟 摸鱼 ≥ 80 | 摸鱼宗师 |
+| 🔥 爆肝 ≥ 80 | 爆肝战神 |
+| 🌙 修仙 ≥ 80 | 深夜修仙者 |
+| 🧱 搬砖 ≥ 80 | 勤恳搬砖人 |
+| 💥 爆发 ≥ 80 且 N ≤ 2 | 一把梭哈型程序员 |
+
+### 隐藏成就
+
+| 条件 | 成就 |
+|------|------|
+| 提交活跃度 ≥ 70 且 代码活跃度 ≤ 15 | 🏷 PPT 架构师 |
+| N ≥ 10 且 L ≤ 30 | 🏷 格式化大师 |
+| N ≥ 15 且 avgLines ≤ 2 | 🏷 Git 聊天达人 |
+| 修仙 ≥ 80 且 N ≤ 3 | 🏷 深夜刺客 |
+| 爆肝 ≥ 90 且 修仙 ≥ 70 且 周末 | 🏷 生产队的驴 |
+| 摸鱼 ≥ 95 且 N ≤ 1 | 🏷 摸鱼仙人 |
+
+### 特殊情况
+
+- **0 Commit**：摸鱼 = 90（不判 100，可能开会/调研/排查问题），其余为 0，标签 = "🐟 今日暂无代码活动"

package/dist/index.js

@@ -289,6 +289,38 @@ function getLocalGitIdentity() {
 }
 
 // src/gitlab.ts
+import http from "http";
+import https from "https";
+async function gitLabFetch(url, headers) {
+  if (typeof globalThis.fetch === "function") {
+    const res = await globalThis.fetch(url, { headers });
+    return {
+      ok: res.ok,
+      statusText: res.statusText,
+      json: () => res.json()
+    };
+  }
+  return new Promise((resolve, reject) => {
+    const parsed = new URL(url);
+    const client = parsed.protocol === "http:" ? http : https;
+    const req = client.request(parsed, { method: "GET", headers }, (res) => {
+      let body = "";
+      res.setEncoding("utf8");
+      res.on("data", (chunk) => {
+        body += chunk;
+      });
+      res.on("end", () => {
+        resolve({
+          ok: (res.statusCode || 0) >= 200 && (res.statusCode || 0) < 300,
+          statusText: res.statusMessage || `HTTP ${res.statusCode}`,
+          json: async () => JSON.parse(body)
+        });
+      });
+    });
+    req.on("error", reject);
+    req.end();
+  });
+}
 async function fetchGitLabCommits(since, until, source) {
   const config = readConfig();
   const gitlabs = config.gitlabs || [];
@@ -324,9 +356,7 @@ async function fetchGitLabCommits(since, until, source) {
   const cleanHost = host.replace(/\/$/, "");
   try {
     const userUrl = `${cleanHost}/api/v4/user`;
-    const userRes = await fetch(userUrl, {
-      headers: { "PRIVATE-TOKEN": token }
-    });
+    const userRes = await gitLabFetch(userUrl, { "PRIVATE-TOKEN": token });
     if (!userRes.ok) {
       console.warn(`\x1B[33m[Warning] Failed to fetch GitLab user info: ${userRes.statusText}\x1B[0m`);
       return [];
@@ -337,9 +367,7 @@ async function fetchGitLabCommits(since, until, source) {
     const lowerUsername = user.username.toLowerCase();
     const activeAfter = since.toISOString();
     const projectsUrl = `${cleanHost}/api/v4/projects?membership=true&last_activity_after=${activeAfter}&per_page=100`;
-    const projectsRes = await fetch(projectsUrl, {
-      headers: { "PRIVATE-TOKEN": token }
-    });
+    const projectsRes = await gitLabFetch(projectsUrl, { "PRIVATE-TOKEN": token });
     if (!projectsRes.ok) {
       console.warn(`\x1B[33m[Warning] Failed to fetch GitLab projects: ${projectsRes.statusText}\x1B[0m`);
       return [];
@@ -352,10 +380,8 @@ async function fetchGitLabCommits(since, until, source) {
     const untilStr = until.toISOString();
     const commitPromises = projects.map(async (project) => {
       try {
-        const commitsUrl = `${cleanHost}/api/v4/projects/${project.id}/repository/commits?since=${sinceStr}&until=${untilStr}&per_page=100`;
-        const commitsRes = await fetch(commitsUrl, {
-          headers: { "PRIVATE-TOKEN": token }
-        });
+        const commitsUrl = `${cleanHost}/api/v4/projects/${project.id}/repository/commits?since=${sinceStr}&until=${untilStr}&per_page=100&all=true`;
+        const commitsRes = await gitLabFetch(commitsUrl, { "PRIVATE-TOKEN": token });
         if (!commitsRes.ok) {
           return [];
         }
@@ -379,9 +405,7 @@ async function fetchGitLabCommits(since, until, source) {
               let dels = 0;
               try {
                 const detailUrl = `${cleanHost}/api/v4/projects/${project.id}/repository/commits/${encodeURIComponent(c.id)}`;
-                const detailRes = await fetch(detailUrl, {
-                  headers: { "PRIVATE-TOKEN": token }
-                });
+                const detailRes = await gitLabFetch(detailUrl, { "PRIVATE-TOKEN": token });
                 if (detailRes.ok) {
                   const detail = await detailRes.json();
                   if (detail.stats) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "git-fish-log",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "🐟 Git 摸鱼 & 爆肝分析器 CLI — 给你的提交记录生成摸鱼指数和 AI 锐评",
   "type": "module",
   "main": "./dist/index.js",
@@ -9,7 +9,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "README-啰嗦版.md"
   ],
   "scripts": {
     "build": "tsup",