Skip to content

活跃统计与缓存机制 ​

本篇说明活跃数据的统计口径、备用活跃等级的计算方式,以及头像缓存、图片缓存与数据目录的管理方法。

📊 活跃统计从何时开始 ​

插件启用并收到群消息后才开始记录活跃数据,安装前的历史消息不会自动导入。

记录内容包括:

  • 累计发言数
  • 当月发言数
  • 首次记录时间
  • 最后发言时间
  • 活跃日期

其中活跃天数统计的是插件记录到发言的不同日期数量;活跃数据均从插件启用后开始累计,不会追溯历史消息。

🧮 备用活跃等级 ​

「每级发言数」与「最高等级」两个设置只用于 QQ 等级无法读取时的备用活跃等级:

text
备用等级 = 累计发言数 / 每级发言数 + 1

备用等级不会覆盖真实等级

备用等级仅作为 QQ 等级读取失败时的兜底展示,不会覆盖能够正常读取的真实 QQ 等级。

例如累计发言 100 条、每级发言数设为 10 时,备用等级为 100 / 10 + 1 = 11,且不会超过「最高等级」设置的上限。

等级读取的完整回退顺序见资料字段与数据来源。

🖼️ 头像缓存 ​

头像下载成功后保存在 avatar-cache 目录。在缓存有效期内重复查询同一用户,不会重新下载头像。

头像已经更换但资料卡仍显示旧头像时:

  1. 等待头像缓存到期;
  2. 或关闭插件后清理 avatar-cache 中对应文件;
  3. 重新启用插件并生成资料卡。

🖼️ 成品图片缓存 ​

插件会对同一群、同一用户的成品图片进行短时缓存,减少连续生成造成的 CPU 占用。

刚修改外观但群内仍返回旧图片时:

  • 等待缓存时间结束;
  • 或重新启用插件清空内存缓存。

📁 数据目录 ​

点击控制台右上角「数据目录」可以直接打开插件的数据保存目录,常见内容如下:

目录 / 文件说明
config.json插件设置
activity.json成员活跃记录
template-preferences.json用户模板偏好
avatar-cache头像缓存
rendered生成的资料卡图片

rendered 中超过保留时间的图片会自动清理,无需手动维护。

缓存目录需要定期清理吗

通常不需要。头像在缓存有效期内自动复用,成品图片短时缓存自动失效,rendered 中的过期图片也会自动清理;只有更换头像后想立即看到新头像等场景,才需要按上文步骤手动处理。

数据目录也是升级备份的入口

升级插件前建议备份其中的配置与活跃记录文件,完整备份清单与迁移步骤见升级备份与版本记录。


📚 下一节:控制台页面详解

薇薇官机平台 · ZL 系列插件