HeatPulse 热点追踪平台

HeatPulse

AI 驱动的热点追踪系统，自动监控多个数据源并通过 AI 分析发现热点

HeatPulse

提示

本项目是一个纯 Vibe Coding 项目

HeatPulse 是一个智能化的热点追踪平台，能够自动监控多个数据源中的关键词，并通过 AI 技术分析内容相关性、生成摘要，帮助用户第一时间发现和跟踪感兴趣的热点话题。

仓库地址

• https://gitee.com/yindong-wen/HeatPulse

• https://github.com/Yd-Wen/HeatPulse

技术栈

后端

• 框架: Express + TypeScript
• 数据库: Prisma + SQLite
• AI 分析: OpenRouter (deepseek/deepseek-chat)
• 实时推送: WebSocket (ws)
• 定时任务: node-cron
• 邮件通知: nodemailer

前端

• 框架: React 19 + TypeScript
• 构建工具: Vite
• 样式: TailwindCSS 4
• 动画: Framer Motion
• 路由: React Router
• 布局: react-masonry-css

项目结构

HeatPulse/
├── skills/                     # Claude Code 自定义 Skill
│   └── heatpulse/
│       ├── SKILL.md           # Skill 定义文件
│       ├── README.md          # Skill 说明文档
│       ├── evals/             # 评估测试
│       └── references/        # 参考资料
├── .claude/
│   ├── commands/              # Claude Code 自定义命令 (Skills)
│   │   ├── 相关性与热度值优化.md
│   │   ├── QueryExpansion的并行扫描.md
│   │   ├── 生成Agent Skill.md
│   │   ├── 前端UI优化.md
│   │   └── 项目介绍.md
│   └── settings.json         # Claude Code 配置
├── docs/                      # 项目文档
│   ├── 00-HEATPULSE.md        # 项目概述
│   ├── 01-需求文档.md         # 需求规格说明
│   ├── 02-技术方案.md         # 技术实现方案
│   ├── 03-后端开发计划.md     # 后端开发规划
│   └── ...                    # 其他迭代文档
├── backend/
│   ├── prisma/
│   │   └── schema.prisma      # 数据库模型定义
│   └── src/
│       ├── routes/            # REST API 端点
│       │   ├── hotspots.ts    # 热点管理
│       │   ├── keywords.ts   # 关键词管理
│       │   ├── scan.ts        # 扫描触发
│       │   └── stats.ts       # 统计数据
│       ├── services/
│       │   ├── ai/            # AI 分析服务
│       │   │   ├── openrouter.ts
│       │   │   ├── prompts.ts
│       │   │   └── queryExpansion.ts
│       │   ├── scanner/       # 数据源扫描
│       │   │   ├── sources/
│       │   │   │   ├── bilibili.ts
│       │   │   │   ├── sogou.ts
│       │   │   │   └── twitter.ts
│       │   │   └── index.ts
│       │   ├── websocket.ts   # WebSocket 实时推送
│       │   └── email.ts       # 邮件通知
│       ├── jobs/
│       │   └── scanCron.ts    # 定时扫描任务
│       ├── types/
│       │   └── index.ts
│       ├── app.ts
│       ├── server.ts
│       └── utils/
│           └── prisma.ts
└── frontend/
    └── src/
        ├── api/
        │   └── client.ts      # API 客户端
        ├── components/
        │   ├── common/        # 通用组件
        │   │   ├── Button.tsx
        │   │   ├── Card.tsx
        │   │   ├── Input.tsx
        │   │   ├── Modal.tsx
        │   │   └── ...
        │   ├── hotspots/       # 热点相关组件
        │   │   ├── HotspotCard.tsx
        │   │   └── HotspotList.tsx
        │   ├── keywords/      # 关键词相关组件
        │   │   └── KeywordCard.tsx
        │   └── layout/        # 布局组件
        │       └── Layout.tsx
        ├── contexts/
        │   └── WebSocketContext.tsx
        ├── hooks/
        │   └── useWebSocket.ts
        ├── pages/
        │   ├── Dashboard.tsx  # 仪表盘
        │   ├── Hotspots.tsx   # 热点列表
        │   └── Keywords.tsx   # 关键词管理
        ├── types/
        │   └── index.ts
        ├── utils/
        │   └── date.ts
        ├── App.tsx
        └── main.tsx

功能特性

核心功能

• 多数据源监控: 支持搜狗、B站、X (Twitter) 三大数据源
• 关键词管理: 添加、删除、启用/禁用关键词，支持分类管理
• AI 内容分析: 自动分析内容相关性、热度评分、生成摘要和标签
• Query Expansion: 智能扩展搜索词，提升搜索覆盖率
• 实时推送: WebSocket 实时推送新发现的热点
• 邮件通知: 热点达到一定热度时自动发送邮件通知
• 定时扫描: 支持配置定时自动扫描任务

热点管理

• 多维度筛选（关键词、来源、相关性、热度、时间范围）
• 多字段排序（发布时间、热度、相关性）
• 批量删除
• 搜索功能（支持 Query Expansion）

前端特性

• 现代化暗色主题 UI
• 响应式设计
• 流畅的动画效果
• 实时连接状态指示

快速开始

前置要求

• Node.js 18+
• npm 9+

安装

# 克隆项目
git clone https://github.com/Yd-Wen/HeatPulse.git
cd HeatPulse

# 安装后端依赖
cd backend
npm install

# 安装前端依赖
cd ../frontend
npm install

配置

1. 复制环境变量模板：

cd backend
cp .env.example .env

2. 编辑 .env 文件，配置必要参数：

# 数据库
DATABASE_URL="file:./prisma/data/heatpulse.db"

# AI 服务 (从 https://openrouter.ai 获取)
OPENROUTER_API_KEY="your-api-key"

# Twitter API (可选)
TWITTER_API_KEY="your-twitter-api-key"

# 邮件配置 (可选)
SMTP_HOST=smtp.example.com
SMTP_PORT=465
SMTP_USER=your-email@example.com
SMTP_PASS=your-password
NOTIFY_EMAIL=smtp.example.com

# WebSocket 端口
WS_PORT=3002

# 扫描间隔（分钟）
SCAN_INTERVAL_MINUTES=30

启动

# 启动后端 (端口 3001)
cd backend
npm run dev

# 启动前端 (端口 5173)
cd frontend
npm run dev

访问 http://localhost:5173 即可使用。

API 文档

热点

方法	路径	说明
GET	/api/hotspots	获取热点列表（支持分页、筛选、排序）
GET	/api/hotspots/:id	获取热点详情
DELETE	/api/hotspots/:id	删除热点

关键词

方法	路径	说明
GET	/api/keywords	获取关键词列表
POST	/api/keywords	创建关键词
PUT	/api/keywords/:id	更新关键词
DELETE	/api/keywords/:id	删除关键词

扫描

方法	路径	说明
POST	/api/scan/trigger	触发扫描
GET	/api/scan/status	获取扫描状态

统计

方法	路径	说明
GET	/api/stats	获取统计数据

开发指南

数据库操作

# 生成 Prisma 客户端
npm run db:generate

# 执行数据库迁移
npm run db:migrate

# 打开 Prisma Studio
npm run db:studio

构建

# 后端构建
cd backend
npm run build

# 前端构建
cd frontend
npm run build

开源协议

本项目基于 MIT License 开源。

Copyright (C) 2026 - present by Yd Wen

作者

• Yd Wen
  • GitHub
  • Gitee
  • 个人主页

致谢

• AI 热点监控工具 - 编程导航 AI 编程实战项目
• OpenRouter - 提供 AI 推理服务
• DeepSeek - 提供高性能 AI 模型
• Tailwind CSS - CSS 框架
• Framer Motion - React 动画库

更新日志

2026-04-13

• 🎉 新增: 新增热点批量删除功能
• 🎉 新增: 新增热点筛选与排序功能
• 🎉 新增: 新增相关性分级（直击核心/高度贴合/轻度关联）
• 🎉 新增: 新增热度分级（刷屏级/热议中/持续发酵/无人问津）
• ✨ 优化: 优化热点卡片 UI

2026-04-12

• 🎉 新增: 新增前端 UI 优化
• ✨ 优化: 改进界面风格和布局
• 🐛 修复: 修复 p-limit 依赖路径错误
• 🎉 新增: 新增生成 Agent Skill 功能
• 🎉 新增: 新增热点页面功能增强
• 🎉 新增: 新增 Query Expansion 并行扫描
• ✨ 优化: 优化搜索覆盖率
• 🎉 新增: 新增基于 Query Expansion 的搜索优化

2026-04-11

• 🎉 新增: 新增 CLAUDE.md 项目文档
• 🐛 修复: 修复 Dashboard.tsx 期望参数错误
• 🎉 新增: 新增信息源与热点优化
• 🐛 修复: 修复 moduleResolution 和 baseUrl 弃用问题
• 🐛 修复: 修复信息源渠道错误、twitter api 错误、新增搜狗源、修复邮箱配置错误

2026-04-10

• 🎉 新增: 项目初始化

Built with ❤️ by HeatPulse