astrbot_plugin_qq_group_daily_analysis/README.md

QQ群日常分析插件

✨ 一个基于AstrBot的智能群聊分析插件，能够生成精美的群聊日常分析报告。灵感来源。 ✨

功能特色

🎯 智能分析

• 话题分析: 使用LLM智能提取群聊中的热门话题和讨论要点
• 用户画像: 基于聊天行为分析用户特征，分配个性化称号
• 统计数据: 全面的群聊活跃度和参与度统计

📊 可视化报告

• PDF报告: 生成专业的PDF格式分析报告（推荐）
• 精美图片: 生成美观的HTML+CSS可视化报告
• 多种格式: 支持图片和文本输出格式
• 用户头像: 自动获取QQ头像，让报告更加生动
• 详细数据: 包含消息统计、时间分布、关键词等

🛠️ 灵活配置

• 群组管理: 支持指定特定群组启用功能
• 参数调节: 可自定义分析天数、消息数量等参数

效果

使用方法

基础命令

群分析

/群分析 [天数]

• 分析群聊近期活动
• 天数可选，默认为1天
• 例如：/群分析 3 分析最近3天的群聊

分析设置

/分析设置 [操作]

• enable: 为当前群启用分析功能
• disable: 为当前群禁用分析功能
• status: 查看当前群的启用状态
• 例如：/分析设置 enable

配置选项

配置项	说明	默认值
enabled_groups	启用分析的QQ群列表	[] (所有群)
max_messages	最大分析消息数量	1000
analysis_days	默认分析天数	1
output_format	输出格式 (image/text/pdf)	image
topic_analysis_enabled	启用话题分析	true
user_title_analysis_enabled	启用用户称号分析	true
pdf_output_dir	PDF文件输出目录	reports
pdf_filename_format	PDF文件名格式	群聊分析报告_{group_id}_{date}.pdf
enable_auto_analysis	启用自动分析	false
auto_analysis_time	自动分析时间	09:00

分析内容

📊 基础统计

• 消息总数
• 参与人数
• 总字符数
• 表情数量
• 最活跃时段

💬 话题分析

• 自动提取主要话题
• 识别话题参与者
• 总结讨论要点和结论

🏆 用户称号

基于用户行为特征分配称号（例）：

• 水群小能手: 发言频繁的活跃用户
• 技术专家: 经常讨论技术话题
• 夜猫子: 深夜活跃用户
• 表情包批发商: 经常发表情
• 沉默终结者: 经常开启话题
• 剧作家: 平均发言长度很长
• 互动达人: 经常回复他人
• KOL: 群内意见领袖

🔥 数据洞察

• 热门关键词统计
• 用户活跃度排行
• 时间分布分析
• MBTI性格类型推测

安装要求

基础要求

• 已配置LLM提供商（用于智能分析）
• QQ平台适配器

注意事项

1. 性能考虑: 大量消息分析可能消耗较多LLM tokens
2. 数据准确性: 分析结果基于可获取的群聊记录，可能不完全准确

更新日志

v1.0.0

• 初始版本发布
• 支持基础群聊分析功能
• 智能话题和用户称号分析
• 精美可视化报告生成

v1.1.0

• 修复了部分bug
• 优化了权限情况，管理员控制绝大部分命令（防止滥用 token）
• 增加了定时自动触发分析功能
• 发送 PDF 版的推送，提供命令安装相关配置，也可以不配置 PDF 版

v1.2.0

• 增加了对 LLM 话题分析部分的提示词提示规范，并且提供正则处理来提高服务可用性

v1.3.0

• token 消耗情况说明

v1.4.0

• PDF 版本情况说明更新

许可证

MIT License

贡献

欢迎提交Issue和Pull Request来改进这个插件！