快速上手
本篇介绍 ZL-关键词统计插件的定位、核心能力,以及从安装激活到投入使用的完整流程,帮助新用户快速上手。
🧩 插件简介
ZL-关键词统计插件是一款面向 UniQQ 群聊的统计工具。成员发送命中规则的消息后,插件自动计数,无需预先创建编号表或统计批次;图片、文件、视频、语音等媒体消息也可独立设置规则进行统计。
插件会记录每位成员发送各关键词的次数、时间与原消息,并提供群内查询、桌面控制台管理与定时汇总推送能力,适合聊天热词追踪、媒体发送盘点与群内活动记录等场景。
✨ 功能特性
| 功能 | 说明 |
|---|---|
| 灵活规则 | 支持包含、全等、正则等匹配方式,规则优先级可调 |
| 指定范围 | 每条规则可限定生效群与监听成员 |
| 消息类型限制 | 关键词可限定只在图片 / 文件 / 视频 / 语音消息中生效 |
| 媒体统计 | 图片、文件、视频、语音独立设置规则,命中即计数,无需关键词 |
| 撤回扣减 | 消息撤回后自动从统计中剔除,保留撤回记录 |
| 重复去重 | 同一条消息最多计数一次 |
| 群内查询 | 汇总、排行、个人记录与命中明细随口即查 |
| 定时推送 | 每日日报多时间点或固定间隔自动推送汇总 |
| 桌面控制台 | 规则、群配置、推送任务与权限集中管理,支持 CSV 导出与数据库备份 |
🔐 安装与激活
插件采用在线授权模式,安装后需完成激活方可使用:
- 安装插件 —— 将插件安装到 UniQQ,打开插件桌面控制台;
- 填写授权信息 —— 在控制台激活页填入授权服务器地址(HTTPS 域名)与授权码;
- 完成激活 —— 激活成功后,监听、统计、查询与推送功能开始运行。
授权机制说明
授权码与设备绑定,防止盗用;插件本地仅以加密方式保存服务器签发的短时凭证,不保存授权码本身。控制台中的「授权有效期」是授权真正的到期日期,「在线凭证有效期」是自动续期的短时安全凭证(通常约 30 分钟,定期在线校验续期),后者临近到期并不代表授权即将到期,请以前者为准。
🚀 基础使用流程
| 步骤 | 操作 | 说明 |
|---|---|---|
| 1 | 激活插件 | 在控制台填入授权服务器地址与授权码 |
| 2 | 添加规则 | 在「关键词规则」「媒体规则」中创建统计规则 |
| 3 | 配置群 | 在「群配置」中添加目标群并开启对应功能 |
| 4 | 按需推送 | 需要日报时,再创建一个定时推送任务 |
配置完成后,群友发送命中关键词的消息或图片、文件等媒体消息即可自动计数,随时在群内发指令查询结果。
默认关闭原则
未在「群配置」中添加并开启的群,不统计、不响应、不推送,请先完成群配置再投入使用。
🧪 规则示例
以关键词 抽烟、匹配方式 包含、排除词 不 为例:
| 群友发送 | 是否计数 | 原因 |
|---|---|---|
我要抽烟 | ✅ 计数 | 命中关键词,且未命中排除词 |
抽烟 | ✅ 计数 | 命中关键词 |
我不抽烟 | ❌ 不计数 | 命中排除词 |
📚 后续阅读
- 群内查询指令与权限规则,见下一节「指令与查询」;
- 使用过程中的常见疑问,见「常见问题」。
📚 下一节:指令与查询
