name: git-repo-audit description: “深度分析 Git 仓库历史，识别高频变更的热点文件、分析代码的实际贡献归属关系、并扫描历史提交中的密钥泄露等安全隐患。当用户提及分析仓库、查看代码归属、寻找热点文件或安全风险扫描，或询问团队协作、代码审查分配、技术债务与安全审计等关键词时触发。” type: tool license: MIT tags:
- git
- security
- analysis
- devops
Git Forensics — Git 历史深度分析
对 Git 仓库进行三维深度分析：热点文件识别、代码归属分析、密钥泄露扫描。
功能概览
1. 热点文件分析 (scripts/hotfiles.sh)
找出仓库中变更最频繁的文件，帮助识别：
- 高风险代码区域（频繁修改 = 潜在不稳定）
- 需要重点代码审查的文件
- 可能需要拆分或重构的模块
用法：
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 |
使用场景
- 安全审计：在代码上线前扫描历史中是否有密钥泄露
- 代码审查优化：识别热点文件，优先审查高风险区域
- 团队协作：了解谁最熟悉哪部分代码，合理分配审查任务
- 技术债务评估：高频变更文件可能是重构候选
依赖
git（>= 2.20）bash（>= 4.0）- 标准 Unix 工具：
awk、sort、head、grep
无需安装任何额外依赖或付费 API。