Summary

This project analyzes QQ group chat logs to generate comprehensive annual reports, featuring hot word discovery, fun statistics, and visualizations. It targets users seeking insights into their group's communication patterns, offering an automated and visually engaging summary.

How It Works

The tool employs jieba for advanced Chinese text analysis and word frequency statistics, alongside a novel word discovery mechanism. It generates interactive HTML/PNG reports and can optionally integrate OpenAI API for AI-powered summaries. Data is persisted via JSON files or MySQL, supporting flexible deployment.

Quick Start & Requirements

• Installation: Requires Python 3.8+, Node.js 16+, and qq-chat-exporter for log export.
• Running:
  • Web Mode: Use start.bat (Windows) or manual backend/frontend startup (macOS/Linux). Local access via http://localhost:5173.
  • Docker: docker-compose up -d --build. Access via http://localhost:5001.
• Dependencies: MySQL 5.7+ is optional for database storage.
• Links: Online demo: http://115.190.181.207/ (slow/limited).

Highlighted Details

• Intelligent word frequency and new word discovery.
• Multi-dimensional user and content rankings.
• Customizable, visually appealing HTML/PNG reports.
• Optional AI summarization via OpenAI API.
• Interactive hot word selection for reports.
• Flexible data storage (JSON default, MySQL optional).

Maintenance & Community

The project is actively under development with a stable release planned. No specific community channels or contributor details are listed in the README.

Licensing & Compatibility

• License: AGPL-3.0 License.
• Compatibility: The AGPL-3.0 license is a strong copyleft license. Providing the service over a network requires making the modified source code publicly available, which may restrict commercial use or integration into closed-source systems.

Limitations & Caveats

The project is in an active development phase, potentially containing bugs and incomplete features. The online demo is slow and rate-limited. The AGPL-3.0 license's requirements for network services are a significant consideration for adoption. Chat log export requires a separate tool.