From ae58ca58df9c3d9d3aa03b27493e7c77a749c350 Mon Sep 17 00:00:00 2001 From: SXP-Simon Date: Tue, 10 Feb 2026 18:43:57 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=20README=20=E6=B7=BB?= =?UTF-8?q?=E5=8A=A0=E5=A2=9E=E9=87=8F=E5=88=86=E6=9E=90=E5=8A=9F=E8=83=BD?= =?UTF-8?q?=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 25 +++++++++++++++++++++++-- 1 file changed, 23 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index a5e17af..dbc064b 100644 --- a/README.md +++ b/README.md @@ -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) ### 获取不到带记录的引用消息