Skip to content

快速上手 ​

本篇介绍 ZL-关键词统计插件的定位、核心能力,以及从安装激活到投入使用的完整流程,帮助新用户快速上手。

🧩 插件简介 ​

ZL-关键词统计插件是一款面向 UniQQ 群聊的统计工具。成员发送命中规则的消息后,插件自动计数,无需预先创建编号表或统计批次;图片、文件、视频、语音等媒体消息也可独立设置规则进行统计。

插件会记录每位成员发送各关键词的次数、时间与原消息,并提供群内查询、桌面控制台管理与定时汇总推送能力,适合聊天热词追踪、媒体发送盘点与群内活动记录等场景。

✨ 功能特性 ​

功能说明
灵活规则支持包含、全等、正则等匹配方式,规则优先级可调
指定范围每条规则可限定生效群与监听成员
消息类型限制关键词可限定只在图片 / 文件 / 视频 / 语音消息中生效
媒体统计图片、文件、视频、语音独立设置规则,命中即计数,无需关键词
撤回扣减消息撤回后自动从统计中剔除,保留撤回记录
重复去重同一条消息最多计数一次
群内查询汇总、排行、个人记录与命中明细随口即查
定时推送每日日报多时间点或固定间隔自动推送汇总
桌面控制台规则、群配置、推送任务与权限集中管理,支持 CSV 导出与数据库备份

🔐 安装与激活 ​

插件采用在线授权模式,安装后需完成激活方可使用:

  1. 安装插件 —— 将插件安装到 UniQQ,打开插件桌面控制台;
  2. 填写授权信息 —— 在控制台激活页填入授权服务器地址(HTTPS 域名)与授权码;
  3. 完成激活 —— 激活成功后,监听、统计、查询与推送功能开始运行。

授权机制说明

授权码与设备绑定,防止盗用;插件本地仅以加密方式保存服务器签发的短时凭证,不保存授权码本身。控制台中的「授权有效期」是授权真正的到期日期,「在线凭证有效期」是自动续期的短时安全凭证(通常约 30 分钟,定期在线校验续期),后者临近到期并不代表授权即将到期,请以前者为准。

🚀 基础使用流程 ​

步骤操作说明
1激活插件在控制台填入授权服务器地址与授权码
2添加规则在「关键词规则」「媒体规则」中创建统计规则
3配置群在「群配置」中添加目标群并开启对应功能
4按需推送需要日报时,再创建一个定时推送任务

配置完成后,群友发送命中关键词的消息或图片、文件等媒体消息即可自动计数,随时在群内发指令查询结果。

默认关闭原则

未在「群配置」中添加并开启的群,不统计、不响应、不推送,请先完成群配置再投入使用。

🧪 规则示例 ​

以关键词 抽烟、匹配方式 包含、排除词 不 为例:

群友发送是否计数原因
我要抽烟✅ 计数命中关键词,且未命中排除词
抽烟✅ 计数命中关键词
我不抽烟❌ 不计数命中排除词

📚 后续阅读 ​

  • 群内查询指令与权限规则,见下一节「指令与查询」;
  • 使用过程中的常见疑问,见「常见问题」。

📚 下一节:指令与查询

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