QQgroup-annual-report-analyzer

一个用于分析QQ群聊记录并生成年度热词报告的工具，支持热词发现、趣味统计、可视化报告生成等功能。

Github地址

https://github.com/ZiHuixi/QQgroup-annual-report-analyzer

项目功能

• 智能词频统计：基于jieba分词的高级文本分析。
• 新词发现：自动识别群聊专属新词。
• 多维度排行榜：包括发言量、活跃度、表情包、夜猫子等多个维度。
• 精美可视化报告：自动生成HTML/PNG格式的年度报告。
• AI智能点评：集成OpenAI API，提供AI年度总结（可选）。
• 交互式选词：Web界面支持从热词列表中自主选择展示词汇。
• 数据持久化：支持JSON文件或MySQL数据库存储。
• 历史记录管理：随时查看、搜索、删除历史报告。
• 响应式设计：完美适配各种设备。
• 高度可定制：丰富的配置参数，满足不同需求。

快速开始

安装必需软件

• Python 3.8+。
• Node.js 16+。
• MySQL 5.7+（可选）。
• qq-chat-exporter，用于导出QQ群聊天记录为JSON格式。

启动服务

• Windows用户：

• 首次运行：双击运行start.bat，脚本会自动创建配置文件并提示配置，编辑配置文件后再次运行start.bat即可启动。
• 后续运行：直接双击start.bat启动所有服务。

• macOS/Linux用户：

• 启动后端：在终端中执行以下命令：

  cd backendpip install -r requirements.txtPORT=5000 python app.py

  如果5000端口被占用，会自动尝试5001端口。

• 启动前端：在终端中执行以下命令：

  cd frontendnpm installnpm run dev




• 配置前端代理：如果后端不是5000端口，需编辑frontend/vite.config.js，修改proxy.target为实际后端地址（如http://localhost:5001）。

• 方式A：手动启动前后端

• 方式B：使用Docker部署：详见DOCKER.md文件，或执行以下命令：

  docker-compose up -d --builddocker-compose logs -f

  访问http://localhost:5001。

访问应用

• 前端界面：http://localhost:5173。
• 后端API：http://localhost:5000（或你配置的端口）。
• Docker部署：http://localhost:5001。