Git Log Summary — Git 记录 Summary

Git 记录 Summary 技能 (Markdown格式)

此技能用于生成Markdown格式的Git提交记录摘要报告，适合文档化、分享和在线阅读。

快速开始 基本用法

生成当前git仓库的Markdown格式提交记录摘要：

./scripts/生成_git_summary.sh

输出格式示例 # 项目名 Git提交记录摘要

报告信息

• 生成时间: 2026-03-25 20:03:35
• 仓库路径: /path/to/仓库
• 仓库基本信息:

分支信息

当前分支

远程仓库

• origin https://example.com/repo.git (fetch)
• origin https://example.com/repo.git (push)

提交统计

总提交数

按作者统计

最近提交记录

所有分支

本地分支

• master
• feature-branch

远程分支

• origin/HEAD
• origin/master

提交类型统计

脚本功能 主要脚本

scripts/生成_git_summary.sh - Markdown格式脚本，生成完整的git提交记录摘要

功能特性

项目信息提取：

自动获取项目名称（从git remote或目录名） 获取仓库路径和基本信息 记录生成时间

分支信息：

当前分支 远程仓库信息 所有分支列表

提交统计：

总提交数 按作者统计提交次数和占比（Markdown表格格式） 提交类型统计（feat, fix, merge等）

详细提交记录：

最近提交的详细记录（Markdown表格格式） 格式化输出：Commit 哈希 | 作者 | 提交时间 | 提交日志

提交类型分析：

自动分析提交信息中的类型前缀 统计各类提交的数量和占比 提供类型说明 使用示例 # 生成默认报告（自动保存为 项目名-git-记录-年月日-时分秒.md） ./scripts/生成_git_summary.sh

# 指定输出文件 ./scripts/生成_git_summary.sh -o custom-报告.md

# 限制最近提交数量 ./scripts/生成_git_summary.sh -n 20

# 包含所有分支的统计 ./scripts/生成_git_summary.sh -a

# 组合使用 ./scripts/生成_git_summary.sh -n 15 -a

自动文件名格式

当不指定-o参数时，脚本会自动生成文件名：

项目名-git-记录-年月日-时分秒.md

示例：

long-shop-git-记录-20260325-203045.md

文件名组成：

项目名: 从git remote或目录名自动提取 git-记录: 固定标识 年月日: 报告生成日期（如20260325） 时分秒: 报告生成时间（如203045） 远程仓库分析 远程分析脚本

scripts/生成_git_summary_remote.sh - 专门用于分析远程Git仓库

功能特性 自动克隆: 自动克隆远程仓库到临时目录 保留报告: 生成报告后保留报告文件 可选保留: 可选择保留或删除克隆的仓库 完整分析: 包含所有本地分析功能 远程仓库使用示例 # 分析远程仓库（自动生成报告文件） ./scripts/生成_git_summary_remote.sh -u https://gitee.com/forever_1236/long-shop.git

# 指定输出文件 ./scripts/生成_git_summary_remote.sh -u https://gitee.com/user/repo.git -o my-报告.md

# 保留克隆的仓库目录 ./scripts/生成_git_summary_remote.sh -u https://github.com/user/repo.git -k

# 组合使用 ./scripts/生成_git_summary_remote.sh -u https://gitee.com/user/repo.git -n 30 -a -o 报告.md

脚本参数 本地分析脚本 (生成_git_summary.sh) -o, --输出 : 指定输出文件（默认自动生成：项目名-git-记录-年月日-时分秒.md） -n, --num-commits : 指定显示的最近提交数量（默认20） -a, --all-branches: 包含所有分支的统计（默认只统计当前分支） -h, --help: 显示帮助信息 远程分析脚本 (生成_git_summary_remote.sh) -u, --url : 远程Git仓库URL（必需） -o, --输出 : 指定输出文件（默认自动生成） -n, --num-commits : 指定显示的最近提交数量（默认20） -a, --all-branches: 包含所有分支的统计（默认只统计当前分支） -k, --keep-clone: 保留克隆的仓库目录（默认不保留） -h, --help: 显示帮助信息 提交类型识别

脚本会自动识别以下提交类型：

feat: 新功能 fix: Bug修复 merge: 合并分支 docs: 文档更新 style: 代码格式调整 refactor: 代码重构 test: 测试相关 chore: 构建过程或辅助工具变动 perf: 性能优化 ci: CI/CD相关 build: 构建系统 revert: 回退提交 注意事项 确保在git仓库中: 脚本必须在git仓库目录下运行 git版本: 需要git 1.8.0或更高版本 权限: 需要读取git配置和提交历史的权限 大型仓库: 对于大型仓库，统计所有提交可能需要较长时间 故障排除 常见问题

"错误：当前目录不是git仓库":

确保当前目录是git仓库 运行 git init 初始化新仓库

统计不准确:

运行 git fetch --all 更新远程分支信息 使用 -a 参数包含所有分支统计

提交类型识别错误:

检查提交信息是否符合约定格式（如 "feat: 添加新功能"） 调整脚本中的类型匹配规则 性能优化

对于大型仓库：

使用 -n 参数限制最近提交数量 避免使用 -a 参数除非必要 考虑使用 git 记录 --since 限制时间范围