nezumi/astrbot_plugin_qq_group_daily_analysis
1
0
Fork 0
mirror of https://github.com/Nezumi-2711/astrbot_plugin_qq_group_daily_analysis.git synced 2026-09-22 13:38:43 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: 移除增量分析设计文档中的旧版兼容说明

Browse Source
This commit is contained in:
SXP-Simon
2026-02-10 18:46:49 +08:00
parent ae58ca58df
commit bf4cfac869
1 changed files with 9 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/INCREMENTAL_ANALYSIS.md
+9 -14
View File
@@ -11,7 +11,7 @@
3. **API端点短期压力暴增**：所有群聊在同一时间点执行分析，LLM API 瞬时负载极高 3. **API端点短期压力暴增**：所有群聊在同一时间点执行分析，LLM API 瞬时负载极高
4. **天然日期隔离问题**：旧版按天存储（key含日期），跨天分析数据断裂，多次发送报告时窗口内容相同 4. **天然日期隔离问题**：旧版按天存储（key含日期），跨天分析数据断裂，多次发送报告时窗口内容相同
## 架构设计（v2 — 滑动窗口批次架构） ## 架构设计
增量分析遵循项目现有的 DDD 分层架构： 增量分析遵循项目现有的 DDD 分层架构：
@@ -32,16 +32,15 @@
└── LLMAnalyzer # LLM分析（增量并发方法） └── LLMAnalyzer # LLM分析（增量并发方法）
``` ```
### 核心设计变更（v1 → v2） ### 核心特性
| 维度 | v1（旧版） | v2（当前版本） | | 维度 | 设计方案 | 优势 |
|------|-----------|--------------| |------|---------|------|
| 存储单元 | 按天的 `IncrementalState` | 独立的 `IncrementalBatch` | | 存储单元 | 独立的 `IncrementalBatch` | 批次间天然隔离，无并发冲突 |
| KV Key | `incremental_state_{group_id}_{date}` | `incr_batch_{group_id}_{batch_id}` | | KV Key | `incr_batch_{group_id}_{batch_id}` | 支持无限扩展和按时间范围查询 |
| 合并时机 | 每次增量分析时合并 | 报告生成时按窗口查询后合并 | | 合并时机 | 报告生成时按窗口查询后合并 | 灵活调整窗口（如24h/48h），无数据断裂 |
| 窗口范围 | 自然日（0:00-24:00） | 滑动窗口（now - analysis_days×24h ~ now） | | 窗口范围 | 滑动窗口（now - analysis_days×24h ~ now） | 任何时间点生成的报告都覆盖完整周期 |
| 日期隔离 | 有（跨天数据断裂） | 无（窗口连续覆盖） | | 多次发送 | 窗口随时间滑动，数据不同 | 支持一天多次生成报告，每次都是最新的 |
| 多次发送 | 相同数据 | 窗口随时间滑动，数据不同 |
## 数据流 ## 数据流
@@ -171,10 +170,6 @@ similarity = len(chars_a & chars_b) / len(chars_a | chars_b)
| `/增量状态` | 查看当前滑动窗口内的增量分析累积情况 | | `/增量状态` | 查看当前滑动窗口内的增量分析累积情况 |
| `/分析设置 status` | 查看完整设置状态（含增量分析配置） | | `/分析设置 status` | 查看完整设置状态（含增量分析配置） |
## 旧版兼容
`IncrementalStore.migrate_legacy_state()` 支持将旧版 `incremental_state_{group_id}_{date}` 格式的数据迁移到新批次架构。迁移后旧键会被删除。
## 文件清单 ## 文件清单
| 文件 | 层 | 说明 | | 文件 | 层 | 说明 |