活跃统计与缓存机制
本篇说明活跃数据的统计口径、备用活跃等级的计算方式,以及头像缓存、图片缓存与数据目录的管理方法。
📊 活跃统计从何时开始
插件启用并收到群消息后才开始记录活跃数据,安装前的历史消息不会自动导入。
记录内容包括:
- 累计发言数
- 当月发言数
- 首次记录时间
- 最后发言时间
- 活跃日期
其中活跃天数统计的是插件记录到发言的不同日期数量;活跃数据均从插件启用后开始累计,不会追溯历史消息。
🧮 备用活跃等级
「每级发言数」与「最高等级」两个设置只用于 QQ 等级无法读取时的备用活跃等级:
text
备用等级 = 累计发言数 / 每级发言数 + 1备用等级不会覆盖真实等级
备用等级仅作为 QQ 等级读取失败时的兜底展示,不会覆盖能够正常读取的真实 QQ 等级。
例如累计发言 100 条、每级发言数设为 10 时,备用等级为 100 / 10 + 1 = 11,且不会超过「最高等级」设置的上限。
等级读取的完整回退顺序见资料字段与数据来源。
🖼️ 头像缓存
头像下载成功后保存在 avatar-cache 目录。在缓存有效期内重复查询同一用户,不会重新下载头像。
头像已经更换但资料卡仍显示旧头像时:
- 等待头像缓存到期;
- 或关闭插件后清理
avatar-cache中对应文件; - 重新启用插件并生成资料卡。
🖼️ 成品图片缓存
插件会对同一群、同一用户的成品图片进行短时缓存,减少连续生成造成的 CPU 占用。
刚修改外观但群内仍返回旧图片时:
- 等待缓存时间结束;
- 或重新启用插件清空内存缓存。
📁 数据目录
点击控制台右上角「数据目录」可以直接打开插件的数据保存目录,常见内容如下:
| 目录 / 文件 | 说明 |
|---|---|
config.json | 插件设置 |
activity.json | 成员活跃记录 |
template-preferences.json | 用户模板偏好 |
avatar-cache | 头像缓存 |
rendered | 生成的资料卡图片 |
rendered 中超过保留时间的图片会自动清理,无需手动维护。
缓存目录需要定期清理吗
通常不需要。头像在缓存有效期内自动复用,成品图片短时缓存自动失效,rendered 中的过期图片也会自动清理;只有更换头像后想立即看到新头像等场景,才需要按上文步骤手动处理。
数据目录也是升级备份的入口
升级插件前建议备份其中的配置与活跃记录文件,完整备份清单与迁移步骤见升级备份与版本记录。
📚 下一节:控制台页面详解
