📦 Gitlog — 查看提交历史

# GitLog GitLog v2.0.0 — 一款用于在命令行管理提交历史和日志分析的开发者工具包。日志检查、验证、变更日志生成、lint 结果、diff 等功能一应俱全。每条记录都带时间戳并本地持久化。完全离线运行 — 你的数据绝不会离开本机。 ## 为何选择 GitLog？ - 完全离线工作 — 你的数据绝不会离开本机 - 简单的命令行界面，无需 GUI 依赖 - 随时导出为 JSON、CSV 或纯文本，便于共享或归档 - 自动记录所有命令的活动历史 - 每个领域命令既是记录器也是查看器 ## 命令 ### 领域命令 每个领域命令有两种模式：记录模式（带参数）保存带时间戳的条目，查看模式（无参数）显示最近 20 条记录。 | 命令 | 描述 | |---------|-------------| | gitlog check | 记录检查操作，例如验证提交签名、作者一致性或分支保护合规性。跨版本和分支跟踪验证结果。 | | gitlog validate | 记录提交消息格式检查、约定式提交合规性或 PR 标题标准的验证条目。记录通过/失败结果及发现的具体违规项。 | | gitlog generate | 记录变更日志创建、发布说明起草或提交摘要生成的生成任务。跟踪生成的内容、覆盖的提交范围及贡献者数量。 | | gitlog format | 记录日志输出重排、日期格式调整或提交展示重构的格式化操作。记录应用的格式变更及最终输出样式。 | | gitlog lint | 记录 lint 结果，识别缺失 scope、非标准前缀或主题过长的提交。用于在团队中强制保持一致的提交消息质量。 | | gitlog explain | 记录解释条目，说明为何做出特定提交、变更背后的架构决策或复杂合并的背景。构建带注释的历史。 | | gitlog convert | 记录转换任务，将日志格式在不同表示之间转换，如 Markdown 变更日志、HTML 发布页面或 RSS 订阅。记录源格式与目标格式。 | | gitlog template | 记录模板操作，用于创建提交消息模板、PR 描述模板或变更日志段落模板。跟踪模板版本及采用情况。 | | gitlog diff | 记录 diff 结果，比较分支、标签或时间范围。记录领先/落后提交数、分歧点及分支间潜在合并冲突。 | | gitlog preview | 记录预览条目，用于在发布前审查暂存提交、即将发布的内容或草稿变更日志。适用于预发布审计。 | | gitlog fix | 记录修复操作，如提交消息重写、作者更正或历史清理。跟踪修复内容、所用方法（amend、rebase、filter-branch）及变更范围。 | | gitlog report | 记录报告条目，用于提交频率分析、贡献者统计或发布节奏摘要。从仓库历史中捕获关键指标与趋势。 | ### 工具命令 | 命令 | 描述 | |---------|-------------| | gitlog stats | 显示所有日志文件的汇总统计，包括各类别条目数及磁盘总占用。 | | gitlog export | 将所有数据以指定格式导出到文件。支持的格式：json、csv、txt。输出保存至数据目录。 | | gitlog search | 使用不区分大小写的匹配搜索所有日志条目。结果按日志类别分组，便于浏览。 | | gitlog recent | 显示统一活动日志中最近 20 条条目，快速了解所有命令的近期工作。 | | gitlog status | 健康检查，显示版本、数据目录路径、总条目数、磁盘使用情况及最后活动时间戳。 | | gitlog help | 显示内置帮助信息，列出所有可用命令及用法说明。 | | gitlog version | 打印当前版本（v2.0.0）。 | ## 数据存储 所有数据本地存储于 ~/.local/share/gitlog/。每个领域命令写入各自的日志文件（如 check.log、lint.log）。统一的 history.log 跟踪跨命令的所有操作。随时使用 export 备份数据。 ## 要求 - Bash (4.0+) - 无外部依赖 — 纯 shell 脚本 - 无需网络访问 ## 何时使用 - 跨版本和拉取请求验证提交消息合规性与签名有效性 - 基于提交历史生成变更日志与发布说明，并附带贡献者署名 - 对提交消息进行 lint，以在团队中强制采用约定式提交标准 - 比较分支历史并跟踪分歧，用于合并规划与冲突预防 - 构建可搜索的提交解释、修复及格式转换记录档案 ## 示例 ``bash # 记录一次检查操作 gitlog check "Verified all 47 commits in v2.0 release are GPG-signed by authorized authors" # 生成一条变更日志条目 gitlog generate "v2.0.0 changelog — 47 commits, 12 contributors, 3 breaking changes" # 验证提交消息 gitlog validate "All 23 commits follow conventional format: feat(scope): message" # 记录 lint 结果 gitlog lint "Found 3 commits with missing scope in message, 1 with subject over 72 chars" # 记录 diff 比较 gitlog diff "main..feature-auth: 23 commits ahead, 5 behind, no merge conflicts detected" # 查看所有统计 gitlog stats # 全部导出为 CSV gitlog export csv # 搜索包含 release 的条目 gitlog search release # 查看近期活动 gitlog recent # 健康检查 gitlog status `` --- 由 BytesAgain 强力驱动 | bytesagain.com | hello@bytesagain.com