# 热点追踪的多智能体系统

**Repository Path**: youngliang1/OpenHotSpot

## Basic Information

- **Project Name**: 热点追踪的多智能体系统
- **Description**: No description available
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-19
- **Last Updated**: 2025-11-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenHotSpot - 智能热点监控与内容生成系统

一个基于Vue.js + Flask的智能热点监控系统，采用现代化智能体架构，能够自动获取多平台热点数据并生成适配不同社交媒体的内容。

## 系统架构

- **前端**: Vue 3 + Element Plus + Vite + ECharts
- **后端**: Flask + Python + 智能体协调器
- **智能体系统**: 模块化智能体架构，支持工作流编排

## 核心功能

### 🔄 多平台热点数据监控
- **数据来源**: 微博、头条、抖音三大社交平台
- **自动获取**: 每10分钟自动获取最新热点数据
- **实时更新**: 支持手动触发即时数据更新
- **数据可视化**: 通过雷达图和词云展示热点分布

### 🧠 现代化智能体架构
项目采用先进的模块化智能体架构：

**核心组件**:
- **AgentFactory**: 智能体工厂，统一创建和管理智能体实例
- **AgentOrchestrator**: 智能体协调器，支持工作流编排和任务调度
- **BaseAgent**: 基础智能体接口，定义统一的行为规范

**核心智能体**:
- **DataCollectionAgent**: 多平台热点数据采集
- **SummaryGenerationAgent**: 热点事件智能总结生成
- **CopywritingGenerationAgent**: 多平台内容文案生成

**工作流支持**:
- `hotspot_analysis`: 热点分析工作流（数据采集 + 总结生成）
- `content_creation`: 内容创作工作流（数据采集 + 总结生成 + 文案生成）
- `data_only`: 仅数据采集工作流

### 📱 多平台内容生成
- **微信公众号**: 生成图文消息和公众号文章
- **微博**: 生成微博博文和话题互动内容
- **抖音**: 生成短视频脚本、文案和话题标签
- **风格定制**: 支持专业严谨、轻松活泼、深度分析等多种内容风格

### 📊 可视化展示
- **热点雷达**: 展示各平台热点排名和热度
- **数据卡片**: 显示今日热点数和覆盖用户量统计
- **词云监控**: 实时展示热门关键词分布
- **平台分类**: 按平台筛选和查看热点数据

## 快速启动

### 1. 启动后端服务

```bash
# 进入后端目录
cd backend

# 安装Python依赖
pip install -r requirements.txt

# 启动后端服务
python app.py
```

后端服务将在 http://localhost:5001 启动，提供以下API接口：
- `GET /api/health` - 健康检查
- `GET /api/hotspots` - 获取热点数据
- `POST /api/hotspots/fetch-now` - 立即获取微博数据
- `POST /api/hotspots/refresh` - 刷新数据缓存
- `POST /api/copywriting/generate` - 生成多平台文案

### 2. 启动前端服务

```bash
# 在项目根目录安装前端依赖
npm install

# 启动开发服务器
npm run dev
```

前端服务将在 http://localhost:5174 启动。

### 3. 访问应用

打开浏览器访问 http://localhost:5174 即可使用热点雷达系统。

## 项目结构

```
OpenHotSpot/
├── backend/                 # 后端服务
│   ├── app.py              # Flask应用主文件
│   └── requirements.txt    # Python依赖
├── src/                    # 前端源码
│   ├── components/         # Vue组件
│   │   ├── HotspotSystem.vue    # 主布局组件
│   │   ├── HotspotRadar.vue     # 热点雷达主界面
│   │   ├── DataCard.vue         # 数据卡片组件
│   │   ├── WordCloudMap.vue     # 词云组件
│   │   ├── CreationFactory.vue  # 内容生成工厂
│   │   ├── Header.vue           # 头部组件
│   │   └── Sidebar.vue          # 侧边栏组件
│   ├── agent/              # 智能体系统
│   │   ├── base_agent.py           # 基础智能体接口
│   │   ├── data_agent.py           # 数据采集智能体
│   │   ├── summary_agent.py        # 总结生成智能体
│   │   ├── copywriting_agent.py    # 文案生成智能体
│   │   ├── agent_factory.py        # 智能体工厂
│   │   ├── agent_orchestrator.py   # 智能体协调器
│   │   ├── workflow_config.py      # 工作流配置
│   │   ├── llm_client.py           # 大模型客户端
│   │   ├── config.json             # 配置文件
│   │   └── trending_tool.py        # 多平台数据获取工具
│   ├── router/             # 路由配置
│   ├── utils/              # 工具函数
│   └── assets/             # 静态资源
├── public/                 # 公共静态资源
└── package.json           # 前端项目配置
```

## 使用说明

### 查看热点数据

1. 系统启动后，热点雷达页面会自动加载热点数据
2. 数据每10分钟自动更新一次
3. 点击"刷新数据"按钮可重新加载当前缓存数据
4. 点击"立即获取"按钮可手动触发微博数据获取
5. 使用平台标签页筛选特定平台的热点

### 生成多平台内容

1. 在热点列表中选择感兴趣的热点
2. 点击"一键生成"按钮
3. 选择目标平台（微信公众号、微博、抖音）
4. 选择内容风格（专业严谨、轻松活泼、深度分析等）
5. 确认生成，系统将跳转到内容生成页面查看结果

### 数据监控

- **今日热点数**: 显示当前获取的热点数量
- **覆盖用户量**: 基于热点数量的估算用户覆盖
- **实时热词监控**: 通过词云展示热点关键词分布
- **平台统计**: 显示各平台热点数据分布情况

## 智能体系统架构

系统采用现代化的模块化智能体架构：

### 架构优势
- **模块化设计**: 每个智能体职责单一，易于维护和扩展
- **工作流编排**: 支持灵活的工作流配置和任务调度
- **统一接口**: 所有智能体遵循相同的接口规范
- **工厂模式**: 统一的智能体创建和管理机制

### 核心组件说明

**AgentFactory**: 负责创建和管理所有智能体实例，支持配置驱动的智能体初始化。

**AgentOrchestrator**: 协调多个智能体协同工作，支持复杂工作流的执行和监控。

**BaseAgent**: 定义智能体的基本行为规范，包括执行、状态管理和错误处理。

## 应用场景

- **内容创作者**: 快速获取热点灵感并生成多平台内容
- **自媒体运营**: 实时监控热点趋势，提升内容时效性
- **营销团队**: 一键生成适配不同平台的营销文案
- **新闻媒体**: 快速跟进热点事件，生成深度分析内容

## 技术特色

- **现代化架构**: 采用协调器+工厂模式的智能体架构
- **全自动化**: 从数据获取到内容生成的全流程自动化
- **多平台适配**: 一次性生成多个平台的适配内容
- **智能分析**: AI驱动的热点分析和内容生成
- **实时监控**: 持续跟踪热点变化趋势
- **用户友好**: 直观的可视化界面和简单操作流程

## 配置说明

### 智能体配置
在 `src/agent/config.json` 中配置智能体参数：
- API密钥设置
- 工作流定义
- 模型参数配置
- 平台数据源配置

### 工作流配置
在 `src/agent/workflow_config.py` 中定义工作流：
- 热点分析工作流
- 内容创作工作流
- 仅数据采集工作流

## 注意事项

- 确保后端服务在启动前端前已正常运行
- 智能体系统需要网络连接以获取各平台数据
- 首次启动时可能需要等待几分钟获取初始数据
- 如遇数据获取失败，请检查网络连接和后端服务状态

## 故障排除

### 后端服务无法启动

```bash
# 检查Python依赖是否安装
pip list | grep flask

# 检查端口是否被占用
netstat -ano | findstr :5001
```

### 前端无法连接后端

- 确认后端服务在 http://localhost:5001 正常运行
- 检查浏览器控制台是否有CORS错误
- 确认前端配置的API地址正确

### 数据获取失败

- 检查网络连接
- 确认各平台API可用性
- 查看后端日志获取详细错误信息

### 智能体执行失败

- 检查配置文件中的API密钥设置
- 查看智能体协调器日志了解工作流执行状态
- 确认大模型服务可用性

## 许可证

本项目采用 木兰宽松许可证，第2版。

## 贡献

欢迎提交 Issue 和 Pull Request 来改进这个项目。