git-repo-audit

name	git-repo-audit
description	深度分析 Git 仓库历史，识别高频变更的热点文件、分析代码的实际贡献归属关系、并扫描历史提交中的密钥泄露等安全隐患。当用户提及分析仓库、查看代码归属、寻找热点文件或安全风险扫描，或询问团队协作、代码审查分配、技术债务与安全审计等关键词时触发。
type	tool
license	MIT
tags	["git","security","analysis","devops"]

Git Forensics — Git 历史深度分析

对 Git 仓库进行三维深度分析：热点文件识别、代码归属分析、密钥泄露扫描。

功能概览

1. 热点文件分析 (scripts/hotfiles.sh)

找出仓库中变更最频繁的文件，帮助识别：

• 高风险代码区域（频繁修改 = 潜在不稳定）
• 需要重点 code review 的文件
• 可能需要拆分或重构的模块

用法：

bash scripts/hotfiles.sh [选项]

选项	说明	默认值
--repo PATH	仓库路径	当前目录
--top N	显示前 N 个文件	20
--since DATE	起始日期（如 2024-01-01）	不限
--until DATE	截止日期	不限
--author AUTHOR	按作者过滤	不限
--format FORMAT	输出格式：table / csv / json	table

2. 代码归属分析 (scripts/ownership.sh)

分析代码的实际归属关系，输出每位贡献者在指定范围内的：

• 提交次数与占比
• 修改行数（增/删）
• 最近活跃时间

用法：

bash scripts/ownership.sh [选项]

选项	说明	默认值
--repo PATH	仓库路径	当前目录
--path SUBPATH	分析指定子目录或文件	整个仓库
--top N	显示前 N 位贡献者	10
--since DATE	起始日期	不限
--format FORMAT	输出格式：table / csv / json	table

3. 密钥泄露扫描 (scripts/secret-scan.sh)

扫描 Git 全量历史（包括已删除的 commit），检测常见的密钥和敏感信息泄露：

• AWS Access Key / Secret Key
• GitHub / GitLab / Slack Token
• SSH 私钥
• 通用 API Key、密码、Secret 模式

用法：

bash scripts/secret-scan.sh [选项]

选项	说明	默认值
--repo PATH	仓库路径	当前目录
--branch BRANCH	扫描指定分支	所有分支
--since DATE	起始日期	不限
--format FORMAT	输出格式：table / csv / json	table
--severity LEVEL	最低严重级别：low / medium / high	low

使用场景

• 安全审计：在代码上线前扫描历史中是否有密钥泄露
• Code Review 优化：识别热点文件，优先 review 高风险区域
• 团队协作：了解谁最熟悉哪部分代码，合理分配 review 任务
• 技术债务评估：高频变更文件可能是重构候选

依赖

• git（>= 2.20）
• bash（>= 4.0）
• 标准 Unix 工具：awk、sort、head、grep

无需安装任何额外依赖或付费 API。