⚡ Ch4120N CVE Pulse

带智能搜索与威胁情报的实时 CVE PoC 聚合器

CVE Pulse 自动从 GitHub 发现、评分并索引 CVE 概念验证。
它使用 EPSS 评分 和 CISA KEV 数据对其进行丰富，构建每日 快照与差异对比，并提供快速、可搜索的 静态网站

📋 目录

• 👨‍💻 项目创建者
• 🎯 功能简介
• ✨ 主要特性
• 🧱 架构
• ⚙️ 工作原理
• 🚀 快速开始
• 📦 安装
• 💻 使用方法
  • 子命令
  • 完整流水线
• 📊 输出与网站
• 🗂️ 项目结构
• 🔧 配置
• 📡 数据来源
• 📅 自动化 (CI/CD)
• 📈 热门 PoC
• ⚠️ 免责声明
• 📄 许可证

👨‍💻 项目创建者

Ch4120N – 安全爱好者与自动化爱好者。
📧 [email protected]

🎯 功能简介

1. 获取最新的 EPSS 评分和 CISA 已知被利用漏洞 (KEV) 目录。
2. 扫描 GitHub，查找包含 CVE 漏洞利用 PoC 的仓库（使用搜索 + GraphQL 元数据）。
3. 使用置信度模型对每个候选进行评分（星标数、时效性、关键词匹配、黑名单等）。
4. 将 PoC 数据与 EPSS 和 KEV 合并，然后构建完整的 JSON API。
5. 生成带有强大客户端搜索引擎的静态网站。
6. 创建每日快照和差异对比，以便跟踪新的高置信度 PoC。

✨ 主要特性

• 🔍 自动化 PoC 发现 – 多窗口 GitHub 代码/仓库搜索
• 🧠 智能评分 – 代码与文档匹配、星标数、时效性、黑名单和启发式规则
• 📈 EPSS 与 KEV 集成 – CISA 的 KEV 列表和 FIRST 的 EPSS 评分与 PoC 数据合并
• 📊 每日快照与差异对比 – 查看新增内容、被提升为“高置信度”的内容以及被移除的内容
• 🌐 可搜索网站 – 按 CVE ID、供应商、产品、关键词进行模糊搜索，支持否定过滤（-windows）
• 🚀 全自动化 – GitHub Actions 流水线按计划更新所有内容
• 💾 零服务器成本 – 所有数据均为静态 JSON/HTML，托管在 GitHub Pages 上
• 🛡️ 黑名单支持 – 忽略嘈杂或不相关的仓库

🧱 架构

⚙️ 工作原理

1. fetch-epss 下载 EPSS 评分排名前 2000 的 CVE。
2. fetch-kev 下载 CISA KEV 目录。
3. sync-cves 读取 data/github.txt 并从 MITRE API 获取 CVE 元数据，然后为每个 CVE 创建/更新 markdown 文件。
4. pipeline（或单独的 build-* 命令）：
   • 构建要扫描的 CVE 范围（来自 github.txt 或之前的低置信度 CVE）。
   • 使用 GitHub 搜索 API 查找提及 CVE ID 的仓库。
   • 通过 GraphQL 使用仓库元数据（星标数、语言、主题）丰富候选。
   • 对每个仓库评分并分配置信度等级（高、中、低）。
   • 写入每个 CVE 的 JSON 文件、索引和 top-100 列表。
   • 创建当前状态的快照以及与前一天对比的差异。
5. build-site 生成 CVE_list.json、trending_poc.json 和静态 HTML 页面。
6. 网站（docs/）部署到 GitHub Pages。

🚀 快速开始```bash

Clone the repository

git clone https://github.com/Ch4120N/Ch4120N-CVE-Pulse.git cd Ch4120N-CVE-Pulse

Install dependencies

pip install -r requirements.txt

Download base data

python chCVEPulse.py fetch-epss python chCVEPulse.py fetch-kev

Sync your initial CVE list (from data/github.txt)

python chCVEPulse.py sync-cves

Run the full discovery pipeline (needs GITHUB_TOKEN for higher rate limits)

export GITHUB_TOKEN=your_token_here python chCVEPulse.py pipeline --days 7

Generate the static website

python chCVEPulse.py build-site

Open docs/index.html in your browser

---

## 📦 安装

**环境要求：**
- Python 3.9+
- `pip`

安装软件包：```bash
pip install -r requirements.txt

(requirements.txt 包含 requests、jinja2 以及其他依赖项。）

💻 使用方法

所有操作都通过单一脚本 chCVEPulse.py 完成。

子命令

示例：```bash

Fetch new data

python chCVEPulse.py fetch-epss --limit 2000 python chCVEPulse.py fetch-kev

Update a specific CVE

python chCVEPulse.py sync-cves --cve CVE-2025-12345

Full pipeline (daily mode)

python chCVEPulse.py pipeline --days 7 --mode daily --limit 50

Regenerate website only

python chCVEPulse.py build-site --html-mode summary

### 完整流水线

`pipeline` 子命令可以进行微调：

- `--days`：回溯搜索 GitHub 的天数（默认：7）
- `--mode`：`daily`（近期 CVE，速度更快）或 `weekly`（更广泛的扫描）
- `--limit`：最多扫描的 CVE 数量（默认：50）
- `--cve`：指定一个或多个要扫描的 CVE ID
- `--skip-discovery`：仅从现有数据重新生成输出
- `--check-links`：验证仓库 URL 是否仍然有效

---

## 📊 输出与网站

流水线成功运行后，`docs/` 包含：

- **`index.html`** – 主搜索页面（由 `logic.js` 和 `style.css` 驱动）
- **`CVE_list.json`** – 所有 CVE 及其描述和 PoC 链接
- **`trending_poc.json`** – 最近更新的 PoC（来自自动更新的 README）
- **`api/v1/`** – 完整的类 REST JSON 端点：
  - `joined_top.json` – 带有 PoC、EPSS 和 KEV 状态的高优先级 CVE
  - `kev.json` – 增强的 KEV 列表
  - `epss_top.json` – 带有 PoC 的顶级 EPSS CVE
  - `cve/{CVE-ID}.json` – 每个 CVE 的详细 PoC 信息
  - `snapshots/` – 每日状态快照
  - `diffs/` – 逐日变化

搜索支持**模糊匹配**、供应商/产品过滤器以及否定词（例如 `-windows`）。

---

## 🗂️ 项目结构```
Ch4120N-CVE-Pulse/
├── chCVEPulse.py
├── scripts/
│   ├── config.py
│   ├── helpers.py
│   ├── github_api.py
│   ├── scoring.py
│   ├── discovery.py
│   ├── outputs.py
│   ├── diff.py
│   ├── joined.py
│   ├── site.py
│   ├── sync.py
│   ├── fetch_epss.py
│   ├── fetch_kev.py
│   └── pipeline.py
├── templates/
│   └── index.html# Jinja2 template for the website
├── data/
│   ├── github.txt# CVE -> PoC URL list (edit this)
│   ├── blacklist.txt
│   ├── cache/
│   └── evidence/
├── docs/
│   ├── api/v1/
│   └── index.html, style.css, logic.js
├── requirements.txt
└── README.md

🔧 配置

几乎所有设置都位于 scripts/config.py 中：

• GITHUB_SOURCES – 指向你的 data/github.txt 的路径
• EPSS_API_URL、KEV_URL、CVE_API_TEMPLATE – 外部 API 端点
• HIGH_EPSS_THRESHOLD – “高”警报的最低 EPSS 值
• TOP_KEV_COUNT – 保留多少条 KEV 条目
• SNAPSHOT_RETENTION_DAYS – 旧快照保留多长时间

📡 数据源

建议使用 GitHub token 以提高 API 速率限制（设置为 GITHUB_TOKEN 环境变量）。

📅 自动化（CI/CD）

三个 GitHub Actions 工作流保持一切更新：

• sync_cve_pocs.yml – 每天运行，读取 data/github.txt，获取最新的 CVE 元数据并更新 markdown 文件。
• hot_cves.yml – 每 6 小时运行一次，更新本 README 中的 Trending PoCs 部分。
• site.yml – 构建静态网站并部署到 GitHub Pages。

所有工作流都位于 .github/workflows/ 中。

📈 Trending PoCs

下面的 Trending PoCs 表格由 CI 流水线每 6 小时自动更新。

2026 (latest 20 of 584 repos)

2025 (latest 20 of 594 repos)

2024 (latest 20 of 636 repos)

2023 (latest 20 of 531 repos)

2022 (latest 20 of 560 repos)

⚠️ 免责声明

本项目旨在用于威胁情报、漏洞管理和防御性安全研究。
请勿将链接的仓库用于任何非法或未经授权的活动。
作者不托管也不认可 PoC 代码——他们仅索引公开可用的信息。

📄 许可证

GPLv3 许可证 – 完整文本请参见 LICENSE 文件。