[docs] (README) 更新 README 说明

This commit is contained in:
SXP-Simon
2025-09-29 21:23:02 +08:00
parent fc78b8798d
commit 7e3640e2d3
+17 -52
View File
@@ -16,20 +16,32 @@ _✨ 一个基于AstrBot的智能群聊分析插件,能够生成精美的群
## 功能特色
### 🎯 智能分析
- **统计数据**: 全面的群聊活跃度和参与度统计
- **话题分析**: 使用LLM智能提取群聊中的热门话题和讨论要点
- **用户画像**: 基于聊天行为分析用户特征,分配个性化称号
- **统计数据**: 全面的群聊活跃度和参与度统计
- **圣经识别**: 自动筛选出群聊中的精彩发言
### 📊 可视化报告
- **PDF报告**: 生成专业的PDF格式分析报告(推荐)
- **精美图片**: 生成美观的HTML+CSS可视化报告
- **多种格式**: 支持图片和文本输出格式
- **用户头像**: 自动获取QQ头像,让报告更加生动
- **详细数据**: 包含消息统计、时间分布、关键词等
- **精美图片**: 生成美观的可视化报告
- **PDF报告**: 生成专业的PDF格式分析报告(需配置)
- **详细数据**: 包含消息统计、时间分布、关键词、金句等
### 🛠️ 灵活配置
- **群组管理**: 支持指定特定群组启用功能
- **参数调节**: 可自定义分析天数、消息数量等参数
- **定时任务**: 支持设置每日自动分析时间
- **自定义LLM服务** :支持自定义指定的LLM服务
### 配置选项
| 配置项 | 说明 | 备注 |
|--------|------|--------|
| 启用自动分析 | 启用定时触发自动分析功能需要按照插件配置里面的说明填写相关的需要的字段;简略说明:打开自动分析功能,在群聊列表中添加群号或者使用 `/分析设置 enable` 启用当前群聊 | 默认关闭,需要填写机器人QQ号 |
| PDF格式的报告 | 初次使用需要使用 `/安装PDF` 命令安装依赖,首次使用命令安装,最后出现提示告诉你需要重启生效,是对的,需要重启 astrbot,而不是热重载插件。 | 输出格式需要设置为 PDF |
| 自定义LLM服务 | 通过配置文件设置自定义LLM服务的API Key、Base URL和模型名称,注意配置中的文字说明, Base URL 需要填写完整,例如 `https://openrouter.ai/api/v1/chat/completions` | 留空则使用 Astrbot 指定的当前提供商 |
上述配置情况仅供参考,注意仔细阅读插件配置页面中各个字段的说明,以插件配置中的说明为准
## 效果
![效果图](./demo.jpg)
@@ -55,54 +67,7 @@ _✨ 一个基于AstrBot的智能群聊分析插件,能够生成精美的群
- `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性格类型推测
## 安装要求