QQ群年度报告分析器完整教程从安装到生成报告的终极指南【免费下载链接】QQgroup-annual-report-analyzer一个用于分析QQ群聊记录并生成年度热词报告的工具。支持热词发现、趣味统计、可视化报告生成等功能。项目地址: https://gitcode.com/gh_mirrors/qq/QQgroup-annual-report-analyzerQQ群年度报告分析器是一款功能强大的QQ群聊天记录分析工具能够帮助用户生成精美的年度热词报告。它支持热词发现、趣味统计、可视化报告生成等多种实用功能让你轻松了解QQ群的年度聊天概况和成员互动特点。✨ 核心特性解析QQ群年度报告分析器之所以受到欢迎源于其丰富而实用的功能设计智能词频统计基于jieba分词的高级文本分析精准提取群聊中的关键信息新词发现自动识别群聊专属新词捕捉群内独特的交流用语多维度排行榜涵盖发言量、活跃度、表情包、夜猫子等多个维度全面展示群成员特点精美可视化报告自动生成HTML/PNG格式年度报告直观呈现分析结果AI智能点评集成OpenAI API提供AI年度总结可选功能交互式选词Web界面支持从热词列表中自主选择展示词汇定制个性化报告 快速开始3步启动 第1步安装必需软件开始使用前请确保已安装以下软件Python 3.8必需下载地址python.org安装时请勾选Add Python to PATH选项Node.js 16必需下载地址nodejs.orgMySQL 5.7可选下载地址mysql.com⚡ 默认使用JSON文件存储无需安装MySQLqq-chat-exporter必需用于导出QQ群聊天记录为JSON格式下载地址github.com/shuakami/qq-chat-exporter 第2步获取项目代码并启动服务首先克隆项目仓库git clone https://gitcode.com/gh_mirrors/qq/QQgroup-annual-report-analyzer cd QQgroup-annual-report-analyzerWindows用户推荐使用一键启动首次运行双击运行start.bat脚本会自动创建配置文件并提示你进行配置编辑配置文件默认配置即可使用无需MySQL再次运行start.bat即可启动后续运行直接双击start.bat即可启动所有服务。macOS / Linux用户方式A手动启动前后端启动后端新开一个终端cd backend pip install -r requirements.txt PORT5000 python app.py # 如果5000端口被占用会自动尝试5001启动前端再开一个终端cd frontend npm install npm run dev配置前端代理如果后端不是5000端口编辑frontend/vite.config.js修改proxy.target为实际后端地址如http://localhost:5001方式B使用Docker部署# 构建并启动 docker-compose up -d --build # 查看日志 docker-compose logs -f # 访问 http://localhost:5001✅ 第3步访问应用启动成功后浏览器访问前端界面http://localhost:5173后端APIhttp://localhost:5000或你配置的端口Docker部署http://localhost:5001就是这么简单⚙️ 配置说明首次运行时会自动创建两个配置文件backend/.envWeb模式配置# 存储模式默认使用JSON文件存储无需MySQL STORAGE_MODEjson # Flask配置 FLASK_SECRET_KEYyour_secret_key FLASK_PORT5000 DEBUGfalse # CORS配置 ALLOWED_ORIGINShttp://localhost:5173,http://localhost:5000 # OpenAI API用于AI功能可选 OPENAI_API_KEYsk-... OPENAI_BASE_URLhttps://api.openai.com/v1 OPENAI_MODELgpt-3.5-turbo存储模式说明STORAGE_MODEjson默认✅ 无需安装MySQL✅ 数据存储在runtime_outputs/reports_db/目录✅ 适合个人本地使用STORAGE_MODEmysql可选适合多用户环境或生产部署需要安装MySQL并配置相关参数config.py命令行模式配置可选仅在使用命令行模式python main.py时需要配置。大多数用户使用Web模式即可。 使用方式本项目提供两种使用方式方式一Web界面模式推荐⭐通过浏览器访问可视化界面提供最友好的交互体验。使用步骤启动服务后浏览器访问http://localhost:5173上传QQ群聊天记录JSON文件选择想要展示的热词生成并查看精美报告方式二命令行模式高级用户直接通过终端运行分析脚本适合批量处理或自动化场景。使用步骤准备聊天记录JSON文件编辑config.pyINPUT_FILE path/to/your/chat.json运行分析python main.py查看结果生成的报告在runtime_outputs目录 生成的报告包含使用QQ群年度报告分析器生成的报告内容丰富主要包括以下部分基础统计消息总数、成员数量等基本信息年度热词群聊最热门的词汇可自定义选择多维度排行榜发言量排行谁是群里最活跃的成员表情包达人谁最爱发表情包夜猫子/早起人群成员活跃时间分析图片分享达人谁分享的图片最多时间分析活跃时段分布了解群聊高峰期趣味统计最长发言、撤回次数等有趣数据AI点评对热词进行智能点评可选功能️ 技术栈QQ群年度报告分析器采用现代化技术栈构建后端Flask, Python 3.8前端Vue 3, Vite分析引擎jieba中文分词图片生成Playwright数据存储JSON文件 / MySQL可选AI功能OpenAI API可选 项目结构QQgroup-annual-report-analyzer/ ├── start.bat # 一键启动脚本 ├── README.md # 项目文档 ├── config.example.py # 命令行模式配置模板 ├── main.py # 命令行模式入口 ├── requirements.txt # Python依赖命令行模式 ├── analyzer.py # 分析核心逻辑 ├── report_generator.py # 报告生成器 ├── image_generator.py # 图片导出功能 ├── utils.py # 工具函数 ├── backend/ # Web后端 │ ├── app.py # Flask应用 │ ├── db_service.py # 数据库服务 │ ├── json_storage.py # JSON存储服务 │ ├── init_db.py # 数据库初始化 │ ├── .env.example # 环境变量模板 │ └── requirements.txt # Python依赖Web模式 ├── frontend/ # Web前端 │ ├── src/ # 源代码 │ ├── package.json # NPM配置 │ └── vite.config.js # Vite配置 └── templates/ # HTML模板 └── report_template.html 使用建议首次使用推荐使用Web模式更直观默认配置即可使用无需复杂设置如需AI功能配置OpenAI API Key日常使用Windows双击start.bat启动macOS/Linux手动启动前后端或使用Docker在浏览器中上传聊天记录关闭服务窗口即停止服务高级用法使用命令行模式批量处理自定义分析参数编辑config.py部署到服务器供多人使用 版权声明作者Huixi Jingkun开源协议AGPL-3.0 License本项目采用GNU Affero General Public License v3.0开源协议。⚠️ 重要声明禁止商业用途本软件为开源软件严禁用于任何商业用途。开源义务如果您修改本软件并通过网络提供服务必须向用户提供修改后的完整源代码。个人使用本软件仅供个人学习、研究和非商业用途使用。免责声明本软件按现状提供不提供任何明示或暗示的担保。数据安全请妥善保管您的聊天记录数据作者不对数据泄露或丢失承担责任。【免费下载链接】QQgroup-annual-report-analyzer一个用于分析QQ群聊记录并生成年度热词报告的工具。支持热词发现、趣味统计、可视化报告生成等功能。项目地址: https://gitcode.com/gh_mirrors/qq/QQgroup-annual-report-analyzer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考