用途:在 GitHub 仓库中查看与分析提交,包括提交历史、差异(diff)和提交详情,主要借助 gh CLI 与 git 命令完成。
主要能力:列出仓库或指定分支的提交历史;查看单个提交的详情(作者、日期、统计、变更文件、父提交、签名验证);比较提交、分支或标签之间的差异;按提交信息、作者、日期、路径等条件搜索提交;获取提交活动、贡献者统计与代码频率等统计信息;生成变更日志、审计轨迹和分支对比结果。
使用方式:通过 gh api 调用 GitHub 提交接口,例如 gh api repos/owner/repo-name/commits,并用 --jq 过滤输出;也可克隆仓库后使用 git log、git show、git diff、git blame 等命令。常用示例包括 git log --oneline -20、git show abc123def、git diff abc123..def456、git log --grep="bug fix"、git log --author="John Doe"、git log -S"function name"。支持分页参数 page 与 per_page,以及 since、until、author、path 等过滤参数。
适用场景:代码审查与变更追溯、发布版本对比与变更日志生成、按作者或时间审计提交、跟踪特定文件历史、查找某段代码的引入或修改时间。
限制:需要具备仓库访问权限并完成 gh 认证;API 存在速率限制,建议使用已认证请求;大量历史分析建议本地克隆;提交签名验证结果取决于仓库配置;资料未提供具体收费、价格或平台支持范围等信息。