📊 群聊日常分析
插件名称： astrbot_plugin_qq_group_daily_analysis
当前版本： v4.10.9
使用大语言模型分析群聊消息，生成包含活跃度、热门话题、用户形象和精彩发言的群聊报告。
插件支持手动分析、定时分析和面向高消息量群聊的增量分析模式。
🚀 快速开始
分析最近一天
@bot 群分析
分析最近三天
@bot 群分析 3
生成的报告可能以图片、文本或 HTML 链接形式发送，具体取决于管理员配置。
⌨️ 命令速查
| 命令 | 说明 |
|---|---|
@bot 群分析 | 分析当前群最近 1 天的聊天活动 |
@bot 群分析 3 | 分析当前群最近 3 天的聊天活动 |
@bot 增量状态 | 查看当前群增量分析的实时状态 |
@bot 分析设置 enable | 为当前群启用分析 |
@bot 分析设置 disable | 为当前群禁用分析 |
@bot 分析设置 status | 查看当前群的分析启用状态 |
@bot 查看模板 | 查看可用模板及预览 |
@bot 设置模板 | 查看当前模板和模板列表 |
@bot 设置模板 1 | 按序号切换模板 |
@bot 设置模板 scrapbook | 按模板名称切换模板 |
仓库 README 没有为每条命令明确标注权限。本站哪些用户可以启停分析或切换模板，以实际 AstrBot 权限配置为准。
✨ 报告包含什么？
| 内容 | 说明 |
|---|---|
| 活跃度统计 | 消息数量、参与人数、时间分布和最活跃时段 |
| 热门话题 | 使用 LLM 提取近期主要讨论内容 |
| 用户形象 | 根据聊天行为生成个性化称号和特征 |
| 群聊圣经 | 自动筛选精彩、典型或有趣的发言 |
| 关键词与金句 | 展示高频词和代表性聊天内容 |
| Token 统计 | 可显示报告生成所消耗的模型 Token |
| 用户头像 | 部分模板会在称号或金句区域显示头像 |
分析结果基于插件能够取得的聊天记录，并不保证完整或绝对准确。
🎨 报告模板
仓库 README 展示了多种视觉模板，包括：
scrapbook：默认剪贴簿风格；- Retro Futurism；
- HatsuneMiku；
- Hack；
- ATRI；
- BlueArchive。
查看实际可用模板：
@bot 查看模板
按序号切换：
@bot 设置模板 1
按名称切换：
@bot 设置模板 scrapbook
模板是否允许普通用户自行切换，由管理员配置决定。
🖼️ 输出方式
| 输出形式 | 说明 |
|---|---|
| 图片 | 生成精美的可视化日报 |
| 文本 | 图片生成失败时可能回退为文本总结 |
| HTML | 生成网页报告，并发送可访问链接 |
| QQ 群相册 | 可把报告上传到群相册 |
| QQ 群文件 | 可将报告保存到群文件中 |
HTML 外链需要管理员自行配置保存目录、域名和 Web 服务器。插件本身不提供网站服务器。
🕒 定时分析
管理员可以让插件自动按计划生成日报。
定时任务是否会运行，通常会经过以下范围判断：
- 当前群是否拥有基础分析权限；
- 定时分析采用白名单还是黑名单模式；
- 当前群是否在对应名单中；
- 是否达到计划执行时间。
当定时分析使用白名单模式，而白名单为空时，自动任务不会运行。
🧠 增量分析模式
增量分析用于消息量很大的群聊，例如日均超过 500 条消息的群。
它的特点包括：
| 特性 | 说明 |
|---|---|
| 滑动窗口 | 按过去若干小时分析，不局限于自然日 |
| 分批处理 | 定时把消息拆成小批次交给 LLM |
| 自动去重 | 合并重复话题和重复金句 |
| 最终汇总 | 将多次增量结果合成为完整报告 |
| 失败回退 | 管理员可启用失败后自动回退到全量分析 |
查看当前状态：
@bot 增量状态
该命令只有在管理员启用了增量分析时才有意义。
🌐 平台支持
| 平台 | 使用要求 |
|---|---|
| QQ OneBot v11 | 推荐 NapCat 或 Lagrange；历史消息拉取可能受分页限制 |
| QQ 官方机器人 | 需要开启群全量消息；只能分析功能启用后实时缓存的消息 |
| Discord | bot 必须拥有 Read Message History 权限 |
| Telegram | 非管理员 bot 需要在 BotFather 关闭隐私模式，重新入群后生效 |
| 飞书 / Lark | 仓库 metadata 将 lark 列为支持平台 |
不同平台能获取的历史消息范围不同，因此同一时间段的报告内容可能存在差异。
💰 Token 与生成时间
群消息越多，分析消耗的 LLM Token 和处理时间通常越高。
以下情况可能使报告生成变慢：
- 分析天数较多；
- 群聊消息量很大；
- 话题和参与者很多；
- 报告模板复杂；
- 图片渲染服务较慢；
- 当前大模型响应速度较低。
不要短时间内反复发送相同分析命令，以免重复消耗额度。
⚠️ 隐私与准确性提醒
- 插件会读取群聊消息，并将内容交给管理员配置的大语言模型进行分析。
- 报告可能包含昵称、头像、用户称号、讨论主题和群聊金句。
- 群聊记录能够获取多少，取决于平台权限和消息缓存。
- AI 生成的用户形象、话题总结和锐评可能存在误解，不应当作严肃的人格鉴定。
- 管理员应向群成员说明分析功能和报告用途。
- 报告上传到群相册、群文件或公网 HTML 后，可能被长期保存和转发。
❓ 常见问题
Q：为什么 @bot 群分析 只分析到部分消息？
平台可能限制历史消息读取，或者插件只缓存了启用后的消息。QQ 官方机器人尤其只能分析实时缓存内容。
Q：为什么生成图片失败后只返回文字？
日报内容较大时，图片渲染可能超时。插件会按配置回退到文本输出。
Q：为什么 @bot 增量状态 显示不可用？
管理员没有为当前群启用增量分析模式。
Q：为什么设置了自动日报，却没有触发？
可能原因包括：
- 当前群没有基础分析权限；
- 使用了定时白名单模式，但名单为空；
- 当前群不在定时分析名单中；
- 定时任务或 bot 当时未正常运行。
Q：为什么分析结果中的人物评价不准确？
用户形象和称号由 LLM 根据可获取的聊天片段生成，可能缺少上下文或产生误判，仅供娱乐和群聊总结参考。
Q：为什么生成报告很慢？
消息量、分析天数、模型速度和图片渲染都会影响耗时。
📎 项目信息
- 显示名称：群分析总结插件
- 当前版本：v4.10.9
- 作者：SXP-Simon
- AstrBot 要求：
>= 4.16.0 - 支持平台：OneBot、QQ 官方机器人、Discord、Telegram、Lark
- 开源协议：MIT
- 项目地址：https://github.com/SXP-Simon/astrbot_plugin_qq_group_daily_analysis
