git-repo-audit

# Git Forensics — Git 历史深度分析 对 Git 仓库进行三维深度分析：**热点文件识别**、**代码归属分析**、**密钥泄露扫描**。 ## 功能概览 ### 1. 热点文件分析 (`scripts/hotfiles.sh`) 找出仓库中变更最频繁的文件，帮助识别： - 高风险代码区域（频繁修改 = 潜在不稳定） - 需要重点 code review 的文件 - 可能需要拆分或重构的模块 **用法：** ```bash 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 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 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。