feat: 完善自动分析名单调度与面板配置说明

- 重构自动分析调度流程:以分层名单解析目标群组,统一报告入口,并按群组模式分发传统/增量任务。

- 新增定时名单与增量名单配置能力:补充 scheduled_group_list(_mode)、incremental_group_list(_mode)、incremental_fallback_enabled。

- 优化失败兜底策略:增量最终报告在超时、异常或无有效结果时,可回退至传统全量分析。

- 完善配置与文档说明:在 _conf_schema.json 与 README 中补充面板操作指引、判定顺序与边界场景说明。

- 兼容旧配置行为:保留废弃接口,并在配置管理中统一名单匹配语义(UMO/群号兼容)。
This commit is contained in:
SXP-Simon
2026-03-26 19:23:49 +08:00
parent aa3ae494ce
commit 9ed4771730
5 changed files with 380 additions and 243 deletions
+56 -3
View File
@@ -97,11 +97,64 @@ _✨ 一个基于 AstrBot 的智能群聊分析插件,支持 **QQ (OneBot)**
| 配置项 | 说明 | 备注 |
|--------|------|--------|
| 启用自动分析 | 启用定时触发自动分析功能。需要在群聊列表中添加群号或者使用 `/分析设置 enable` 启用。 | 默认关闭,建议开启 |
| 启用增量分析 | 启用增量分析模式,定时分批分析消息,最终生成全天报告。 | 适合消息量大的群聊 |
| 定时分析名单模式 + 列表 | 控制哪些群参与定时任务(报告时间点触发)。 | `whitelist + 空列表` 表示不注册定时任务 |
| 增量分析名单模式 + 列表 | 控制哪些群走增量模式,其他群走传统全量。 | `whitelist + 空列表` 表示不启用增量周期任务 |
| PDF格式的报告 | 初次使用需要使用 `/安装PDF` 命令安装依赖。需重启 AstrBot 生效。 | 输出格式需设为 PDF |
| 自定义LLM服务 | 用户可自行选取个人提供的服务商。 | 留空则回退到默认服务商 |
### 分析黑白名单配置说明(小白能懂)
下面只讲“在面板里怎么点”。
#### 自动分析的判定顺序(很重要)
系统会按下面顺序判断,前一关没过就直接停止:
1. 基础群权限(`basic`
2. 定时分析名单(`auto_analysis`
3. 增量名单(`incremental`,只决定模式,不决定放行)
一句话版:
`basic` 决定“能不能参与自动分析” -> `auto_analysis` 决定“会不会自动触发” -> `incremental` 决定“触发后用哪种分析方式”。
#### 场景 A:只让一个群自动出报告(最常用)
1. 在插件配置面板找到 `定时分析设置`
2.`定时分析名单模式` 设为 `whitelist`
3.`定时分析群列表` 里添加你的目标群(建议粘贴 `/sid` 拿到的完整会话ID)。
4.`自动分析时间列表` 里填时间(例如 `09:00``21:30`)。
5.`增量分析设置`
6.`增量分析名单模式` 设为 `whitelist`,并保持 `增量分析群列表` 为空。
这样就是“这个群会自动跑,但走普通分析,不走增量”。
#### 场景 B:除了某个群,其他群都自动跑
1.`定时分析设置` 里把 `定时分析名单模式` 设为 `blacklist`
2.`定时分析群列表` 里填“不要自动跑”的那个群。
3.`自动分析时间列表` 里填每天自动运行时间。
4. 如果你希望其他群默认走增量:
5.`增量分析设置``增量分析名单模式` 设为 `blacklist`,并把 `增量分析群列表` 留空。
#### 场景 CTelegram 用户怎么填最稳
1. 在面板里需要填群的地方,尽量填完整会话ID(例如 `telegram2:GroupMessage:-1001234567890`)。
2. 不建议新手只填纯群号,容易填错平台。
3. 先在群里执行 `/sid`,复制结果粘贴到列表里就行。
#### 最容易踩坑的 3 点
- `定时分析名单模式``whitelist` 时,如果 `定时分析群列表` 为空,任务不会自动跑。
- `增量分析名单模式``whitelist` 时,如果 `增量分析群列表` 为空,增量不会生效,会走普通分析。
- `增量失败自动回退全量分析` 建议保持开启,这样增量异常时也能尽量产出报告。
#### 你可能会问(关键边界)
- 不在“定时白名单”里,但在“增量白名单”里,会触发吗?
不会。因为会先被“定时白名单”拦住,进不到增量判断。
- 不在“基础群权限”里,但你开了定时分析,会触发吗?
不会。基础群权限是第一关,不通过就不会进入后续流程。
> [!IMPORTANT]
> **多平台配置注意**
> - **自动发现**: 插件会自动发现已登录的 Bot 实例。
@@ -214,7 +267,7 @@ _✨ 一个基于 AstrBot 的智能群聊分析插件,支持 **QQ (OneBot)**
- **自动去重**:智能识别重复话题和金句,合并生成最终报告。
**启用方法:**
- 在插件配置中开启 `incremental_enabled`,并根据需要调整分析间隔 (`incremental_interval_minutes`) 和消息阈值。
- 通过 `incremental_group_list_mode + incremental_group_list` 指定哪些群走增量模式,并根据需要调整分析间隔 (`incremental_interval_minutes`) 和消息阈值。
## 常见问题 (FAQ)