GitHub Trending 项目收藏器

每日自动抓取 GitHub 热度最高的 10 个项目，展示功能介绍与安装代码，支持收藏保存，未收藏项目 7 天后自动删除。

快速启动

方式一：生产模式（单端口，推荐 demo）

# 1. 安装依赖
npm run install:all

# 2. 构建前端
npm run build

# 3. 启动服务
npm start

访问 → http://localhost:3001

---

方式二：开发模式（热更新）

npm run install:all
npm run dev

• 前端：http://localhost:5173（热更新）
• 后端 API：http://localhost:3001

---

可选配置

添加 GitHub Token 可将 API 速率限制从 60次/小时 提升至 5000次/小时：

cp .env.example .env
# 编辑 .env，填入 GITHUB_TOKEN=ghp_xxx

---

功能说明

功能	说明
自动抓取	每天凌晨 2:00 自动抓取 GitHub 当日 Top 10 趋势项目
手动刷新	点击页面右上角「↻ 刷新」按钮立即触发抓取
功能摘要	自动从 README 提取功能介绍段落
安装代码	自动从 README 提取安装/快速开始代码块
收藏保存	点击「☆ Save」收藏项目，收藏后永久保留
自动删除	未收藏的项目在首次抓取 7 天后自动删除
删除倒计时	卡片上显示「⏱ Auto-deletes in Nd」徽章
筛选标签	All Repos / Today's Trending / Favorites 三个视图

API 接口

GET  /api/repos?filter=all|today|favorites  # 获取项目列表
GET  /api/repos/:id                          # 获取单个项目
POST /api/repos/:id/favorite                 # 收藏
DELETE /api/repos/:id/favorite               # 取消收藏
GET  /api/stats                              # 统计数据
POST /api/scrape                             # 手动触发抓取

技术栈

• 后端：Node.js + Express + SQLite (better-sqlite3)
• 前端：React + Vite + Tailwind CSS
• 抓取：cheerio 解析 github.com/trending + GitHub REST API
• 调度：node-cron 每日定时任务