docs: 更新 README 添加增量分析功能说明

This commit is contained in:
SXP-Simon
2026-02-10 18:43:57 +08:00
parent f1f804d2b9
commit ae58ca58df
+23 -2
View File
@@ -39,8 +39,8 @@ _✨ 一个基于 AstrBot 的智能群聊分析插件,支持 **QQ (OneBot)**
- **群组管理**: 支持指定特定群组启用功能(支持跨平台黑白名单)
- **参数调节**: 可自定义分析天数、消息数量等参数
- **定时任务**: 支持设置每日自动分析时间
- **自定义LLM服务** :支持自定义指定的LLM服务
- **增量分析**: 全新的滑动窗口分析模式,全天候覆盖群聊消息
- **自定义LLM服务**: 支持自定义指定的LLM服务
## 配置选项
@@ -50,6 +50,7 @@ _✨ 一个基于 AstrBot 的智能群聊分析插件,支持 **QQ (OneBot)**
| 配置项 | 说明 | 备注 |
|--------|------|--------|
| 启用自动分析 | 启用定时触发自动分析功能。需要在群聊列表中添加群号或者使用 `/分析设置 enable` 启用。 | 默认关闭,建议开启 |
| 启用增量分析 | 启用增量分析模式,定时分批分析消息,最终生成全天报告。 | 适合消息量大的群聊 |
| PDF格式的报告 | 初次使用需要使用 `/安装PDF` 命令安装依赖。需重启 AstrBot 生效。 | 输出格式需设为 PDF |
| 自定义LLM服务 | 用户可自行选取个人提供的服务商。 | 留空则回退到默认服务商 |
@@ -94,6 +95,14 @@ retro_futurism 模板效果图
- 天数可选,默认为1天
- 例如:`/群分析 3` 分析最近3天的群聊
#### 增量状态
```
/增量状态
```
- 查看当前增量分析的实时状态
- 显示当前滑动窗口内的分析次数、消息数、话题数等统计
- **仅在启用增量分析模式时可用**
#### 分析设置
```
/分析设置 [操作]
@@ -135,6 +144,18 @@ retro_futurism 模板效果图
> 1. **性能考虑**: 大量消息分析可能消耗较多 LLM tokens
> 2. **数据准确性**: 分析结果基于可获取的群聊记录,可能不完全准确
## 增量分析模式 (Beta)
增量分析模式是为了解决消息量大的群聊(如日均消息 > 500 条)在单次分析时容易丢失上下文的问题。
**核心特性:**
- **滑动窗口**:不再受限于自然日,分析窗口随时间滑动(如过去 24 小时),确保任何时候生成的报告都覆盖完整的时间段。
- **分批处理**:定时(如每 2 小时)执行一次小批量分析,减轻 LLM 瞬时压力。
- **自动去重**:智能识别重复话题和金句,合并生成最终报告。
**启用方法:**
在插件配置中开启 `incremental_enabled`,并根据需要调整分析间隔 (`incremental_interval_minutes`) 和消息阈值。
## 常见问题 (FAQ)
### 获取不到带记录的引用消息