🔥 GitHub Hot Hub

发现 GitHub 上正在爆发的热门项目，打破技术信息差。

功能

• 爬取 GitHub Trending — 自动采集多语言、多周期的 Trending 榜单
• GitHub API 补充 — 获取项目详细信息（topics、创建时间、issue 等）
• 火爆度评分 — 多维度评分算法，识别"正在爆发"的项目
• 智能过滤 — 排除 awesome-list、面试题等非技术项目
• 每日报告 — 生成 Markdown 格式的热点速报
• 历史追踪 — 记录每日快照，计算 star 增速加速度
• 企业微信推送 — 一键推送热点摘要到企微群机器人

评分体系

维度	权重	说明
⭐ Star 日增速	40%	短时间内的 star 新增数量
🚀 增速加速度	20%	今日增量 vs 昨日增量
📊 相对增长率	20%	日增量 / 总 star 数
🆕 新鲜度	10%	项目越新分数越高
👥 社区响应	10%	fork + issue 活跃度

爆发类型标签

• 🔥 新星爆发 — 项目创建 < 7 天
• 📈 加速上升 — 增速加速度为正且显著
• 🔄 二次翻红 — 老项目突然爆发
• 🏆 持续霸榜 — 连续高 star 增速

快速开始

1. 安装依赖

cd github-hot-hub
python -m venv .venv
source .venv/bin/activate
pip install -e .

2. 配置

cp .env.example .env
# 编辑 .env，填入你的配置

必填配置：

变量	说明	获取方式
GHH_GITHUB_TOKEN	GitHub Personal Access Token	Settings → Tokens → Generate new token (classic) → 勾选 public_repo
GHH_WECOM_WEBHOOK_URL	企业微信群机器人 Webhook 地址	见下方「企业微信推送」章节

3. 运行

# 完整运行（Trending + API + 报告）
python -m src.main

# 完整运行 + 推送到企业微信
python -m src.main --notify

# 仅使用 Trending 数据（不需要 Token，更快）
python -m src.main --skip-api

# 自定义展示数量
python -m src.main -n 20

# 详细日志
python -m src.main -v

# 组合使用：完整模式 + 推送 + 详细日志
python -m src.main --notify -v

企业微信推送

获取 Webhook 地址

1. 打开企业微信，进入你要推送的群聊
2. 点击群聊右上角 ... → 群机器人 → 添加群机器人
3. 输入机器人名称（如 GitHub 热点速报），点击添加
4. 复制生成的 Webhook 地址（形如 https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx）
5. 将地址填入 .env 文件：

GHH_WECOM_WEBHOOK_URL=https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=你的key

推送内容

推送时会发送 Top 10 的热点项目摘要（企微消息有 4KB 限制，自动截断），包含：

• 项目名称 + 链接
• 今日 star 增量 + 总 star 数
• 技术领域分类
• 爆发度评分 + 爆发标签
• 项目简介

使用

# 采集 + 报告 + 推送
python -m src.main --notify

# 仅推送（跳过 API 获取，更快）
python -m src.main --skip-api --notify

注意： 企业微信群机器人每分钟最多发送 20 条消息。本工具每次运行只发 1 条，正常使用不会触发限制。

项目结构

github-hot-hub/
├── src/
│   ├── crawlers/
│   │   ├── trending.py       # GitHub Trending 页面爬虫
│   │   └── github_api.py     # GitHub REST API 客户端
│   ├── scorers/
│   │   └── hot_scorer.py     # 火爆度评分算法
│   ├── reporters/
│   │   └── markdown_reporter.py  # Markdown 报告生成
│   ├── notifiers/
│   │   └── wecom.py          # 企业微信 Webhook 推送
│   ├── storage/
│   │   └── snapshot_store.py # 本地数据快照存储
│   ├── config.py             # 项目配置
│   ├── models.py             # 数据模型
│   └── main.py               # 主入口
├── data/                     # 每日快照数据
├── reports/                  # 生成的报告
├── tests/                    # 测试
├── pyproject.toml
├── .env.example
└── README.md

后续规划

• 企业微信推送
• LLM 分析"为什么火"
• Web Dashboard
• 定时任务自动运行

License

MIT