ZL综合插件使用说明

让管理更简单，让机器人更智能 💜

插件基本信息
开发初衷
下载与安装
快速上手（5 分钟入门）
控制台界面总览
首页功能详解
全局配置页详解
菜单指令页详解
授权群组页详解
分群配置页详解（8 个标签页）
问答管理页详解
定时任务页详解
黑白名单页详解
违禁词汇页详解
群内聊天指令大全
可用变量大全
权限等级体系
常见问题 FAQ
售后服务与联系方式

一、插件基本信息

项目	内容
插件名称	ZL-综合插件
插件 ID	XiaoLin.ZLComprehensivePlugin
作者	小林
作者 QQ	939921104
当前版本	1.4.6
官网 / 下载地址	https://blog.zxiaolin.com
适用框架	UniQQ（建议 1.1.0.1 及以上版本）
运行环境	Windows 系统，.NET 运行时（dotnet），需支持 WebView2
插件类型	综合群管与自动回复插件
一句话简介	综合群管与自动回复插件，支持全局配置、菜单指令、授权群组、分群配置、问答、定时任务、黑白名单、违禁词和娱乐 API。

二、开发初衷

在 QQ 群的日常管理中，群主和管理员往往需要同时部署多个插件才能凑齐"自动回复、违禁词拦截、入群审核、定时消息、发言统计"等常用功能。插件装多了容易冲突、配置分散、排查问题困难，而且大多数插件的设置界面简陋，上手成本高。

ZL-综合插件的开发初衷就是：把一个 QQ 群机器人日常需要的能力，全部收进一个插件、一个控制台里。

一站式：菜单指令、问答、违禁词、定时任务、名单管理、入群审核、验证码、刷屏检测全部内置，无需再装其他插件。
可视化：全部功能通过现代化网页控制台配置，所见即所得，改完保存立即生效，不用改代码、不用重启。
分群化：每个群可以拥有完全独立的配置，一套插件管多个风格不同的群。
实时化：控制台首页的数据（消息量、指令量、日志、好友数等）每秒实时刷新，机器人在群里干了什么一目了然。

三、下载与安装

3.1 下载

官方渠道：https://blog.zxiaolin.com （打开后进入插件下载栏目，下载 XiaoLin.ZLComprehensivePlugin.uniqq 文件）
温馨提示：目前只有官方渠道和代理渠道可以开通授权，请勿轻信他人低价授权等，以防上当受骗！

3.2 安装步骤

确认你已安装并登录 UniQQ 框架（机器人框架）。
将下载得到的 XiaoLin.ZLComprehensivePlugin.uniqq 文件放入 UniQQ 的 Plugins 目录中（一般在 UniQQ 安装目录下）。
重启 UniQQ（或在框架的插件管理中刷新 / 重载插件）。
在 UniQQ 的插件列表中找到「ZL-综合插件」，确认状态为"已启用"。
点击插件的「设置」按钮，即可打开本插件的控制台窗口。

3.3 授权说明

授权类型	说明
单 Q 版	仅支持已授权的 QQ 使用插件
设备版	支持已授权的设备架上所有 QQ 使用插件，支持自由解绑

总授权群数量上限：20 个
单个群授权成员上限：500 人
授权请联系官方渠道或代理渠道开通。

四、快速上手（5 分钟入门）

第一次使用本插件？按下面 5 步走，5 分钟即可让机器人跑起来：

打开控制台：在 UniQQ 插件列表 → ZL-综合插件 → 点击「设置」。
确认主人 QQ：进入「全局配置」页，确认「全局主人」输入框里是你的 QQ 号（默认为作者 QQ，请改成自己的）。主人拥有插件最高权限。
开启总开关：确认「启用插件总开关」处于打开状态（默认开启）。
给群授权：进入「授权群组」页，点击「授权新群」给你的群开通授权；或在群里发送 授权本群 指令（需主人发送）。未授权的群默认无法使用插件功能。
保存并测试：点击「保存全局配置」，然后去群里发送 菜单，机器人回复菜单内容即表示安装成功！

进阶：修改任何配置后，记得点「保存」（或按 Ctrl + S）。保存后立即生效，无需重启框架。

五、控制台界面总览

控制台窗口整体分为三个区域：

┌──────────┬──────────────────────────────┐
│          │  顶部：框架QQ选择器 / 群号选择器 / 群开关   │
│  左侧     ├──────────────────────────────┤
│  导航     │                              │
│  菜单     │         主内容区              │
│          │   （首页/全局配置/菜单指令/...）  │
│          │                              │
├──────────┴──────────────────────────────┤
│  底部：版本号 · 框架信息 · 设备码 · 未保存提示  │
└─────────────────────────────────────────┘

5.1 左侧导航菜单（9 个页面）

菜单项	功能定位
首页	数据看板：插件状态、运行数据、日志、快捷操作
全局配置	对所有群生效的全局设置：主人、小尾巴、行为开关等
菜单指令	配置机器人的菜单类指令及回复内容
授权群组	管理哪些群可以使用插件（授权/取消/开关群）
分群配置	单个群的独立配置（8 个标签页，功能最多的一页）
问答管理	关键词自动回复（问答规则）管理
定时任务	定时/周期性自动执行任务
黑白名单	成员黑名单/白名单管理与策略
违禁词汇	违禁词库管理与触发处置

5.2 顶部选择器（全局配置 / 菜单指令页可见）

元素	说明
框架QQ	点击可切换当前操作的机器人账号（多机器人框架可选）
群　号	点击下拉选择要配置的群，选中的群即为"当前分群"
群开关	快速开/关当前选中群的插件功能（开关立即自动保存）

5.3 底部状态栏

元素	说明
版本号	当前插件版本（如 v1.4.6）
框架信息	UniQQ 框架名称与版本
设备码	当前设备的唯一识别码（授权相关）
未保存	显示当前有几处修改未保存，提示及时保存

六、首页功能详解

首页是插件的"仪表盘"，所有数据每秒实时刷新——你在群里发一条指令，机器人处理后，首页的统计数字和日志会立即变化。

6.1 欢迎栏

元素	含义
欢迎语	按时间段显示问候（如"早上好，欢迎回到控制台"）
服务状态点 + 状态文本	绿色=服务运行中；橙色=全局开关已关闭；红色=运行异常（附错误原因）
"N 个群组启用"	当前有多少个群开启了插件功能
「进入全局配置」按钮	快捷跳转到全局配置页

6.2 四大数据卡片

卡片	数据含义	数据来源
插件状态	运行中 / 已停用 / 异常，以及当前全局开关状态	全局配置的总开关
授权群组	`已授权数 / 已知群组数`，例如 `12 / 15` 表示 15 个群里有 12 个已授权	授权群组管理
在线时长	机器人从插件启动至今的持续运行时间，逐秒跳动	插件启动时间
好友数量	机器人 QQ 当前的好友总数	框架好友列表接口，实时读取

6.3 运行数据概览（4 项指标）

指标	含义	统计口径
消息处理	机器人处理过的消息总数（大数字为累计，下方小字为今日）	每收到一条群消息 +1
指令响应	成功响应的指令/问答总数	每命中一条指令或问答 +1
定时任务	定时任务累计执行次数	每执行一次定时任务 +1
拦截违规	违禁词/黑名单/刷屏等累计拦截次数	每拦截一次 +1

每日数据每天 0 点自动清零重新统计，累计数据一直保留。

6.4 功能状态列表

显示五大功能模块当前的启用状态徽章（绿色"已启用" / 红色"未启用"）：

功能项	判定依据
运行数据概览	全局总开关是否开启
问答系统	是否存在启用中的问答规则
定时任务	是否存在启用中的定时任务
黑白名单	名单功能始终可用
违禁词过滤	是否存在违禁词且当前群开启了违禁词检测

6.5 最近运行日志

以滚动列表形式显示最近的插件动作（最多保留 80 条），每条包含时间、级别、内容：

级别	颜色	含义
INFO	蓝色	普通信息（如启动、保存配置、发送事件提示）
CMD	紫色	群内触发了指令 / 命中问答
TASK	黄色	定时任务执行记录
WARN	橙色	警告（拦截违规、拒绝加群等）
ERROR	红色	运行错误
ADD	绿色	新增类操作（自动同意好友、授权等）

6.6 快捷操作按钮（4 个）

按钮	功能	点击后的反馈
保存配置	一次性保存控制台所有页面（全局、分群、问答、定时、违禁词）的全部修改，快捷键 `Ctrl + S`	提示"已保存"
重新加载	丢弃控制台未保存的修改，从磁盘配置文件重新读取最新配置	提示"加载成功"
导入/导出	弹出系统对话框：选「是」导出配置为 JSON 文件备份；选「否」从 JSON 文件导入配置	导出/导入完成后提示"已保存"
使用帮助	调用系统默认浏览器打开官方帮助站点 https://blog.zxiaolin.com	浏览器自动打开

七、全局配置页详解

全局配置对所有群生效，是插件的"总设置中心"。

7.1 顶部机器人信息栏

数据项	说明
QQ昵称	当前选中机器人的昵称
在线时长	机器人本次在线时长
管理群数	机器人所在的总群数
好友数量	机器人的好友总数
当前群状态	当前选中群是"已启用"还是"已停用"
授权状态	当前选中群的授权情况（已授权/未授权/到期时间）

7.2 核心字段

字段	说明	使用方法
全局主人	插件最高权限人 QQ 列表，默认 `939921104`（作者），请务必改成自己的 QQ	多个 QQ 用逗号或换行分隔。主人可以执行授权、管理管理员等一切操作
全局小尾巴	机器人每条回复消息末尾自动附加的一段文字，常用于署名或广告	填写如 `— ZL插件`；留空则不附加。修改后必须点保存，下一条回复即生效

7.3 机器人行为设置（8 个开关）

开关	作用	建议场景
启用插件总开关	插件总电源，关闭后所有群的功能全部停止	临时维护时关闭
仅授权群可使用插件	开启后未授权的群无法使用功能；关闭则所有群均可用	正式运营建议开启
未授权群回复提示	未授权的群里有人发疑似指令时，机器人回复"未授权提示语"	让群主知道需要授权
启用扩展 API 指令	开启后才能使用段子/谜语/今日运势/诗词等娱乐查询指令（见指令大全）	按需开启
机器人被邀请加群时自动同意	有人邀请机器人进群时自动接受邀请	多群运营开启
机器人被邀请进群后通知主人	机器人被邀请进群时私聊通知主人	建议开启，防止机器人被恶意拉群
机器人被添加好友时自动同意	收到好友申请时自动通过	按需开启
风险事件通知主人	好友申请等风险事件私聊通知主人	建议开启

7.4 指令相关字段

字段	说明	示例
命令前缀	所有指令前的引导符号，可留空	填 `/` 后群内需发送 `/菜单` 触发
菜单指令	触发菜单回复的关键词，默认"菜单"	也可改成"功能"等
未授权提示	未授权群触发指令时的回复文本	默认"本群暂未授权使用 ZL-综合插件。"

7.5 操作

点击「保存全局配置」按钮保存本页所有设置（或按 Ctrl + S）。
页面底部有三条官方公告（温馨提示 / 插件信息 / 售后服务），鼠标悬停可查看完整内容。

八、菜单指令页详解

菜单指令即"关键词 → 固定回复"的指令集合，最典型的就是群里的 菜单 指令。

8.1 指令列表（左侧表格）

列	说明
ID/序号	指令编号，点击行可选中编辑
关键词	触发指令的文字
权限	无 / 管理员 / 主人
状态	已启用 / 已停用（停用后不响应）
操作	编辑 / 删除

工具栏按钮：

按钮	功能
添加指令	新增一条菜单指令（清空编辑器进入新增模式）
导入 / 导出	批量导入导出指令配置
搜索框	按关键词过滤列表

8.2 内容设定（右侧编辑器）

字段	说明
关键词	群成员发送这个词即触发回复
触发方式	完全匹配（消息须与关键词完全一致）/ 模糊匹配（包含即触发）/ 正则匹配
权限	无=所有人可用；管理员=群管可用；主人=仅主人可用
指令内容预览	指令命中后机器人回复的完整文本，支持多行

8.3 操作按钮

按钮	功能
保存	保存当前编辑的指令
删除	删除当前选中的指令
测试发送	让机器人向当前群真实发送一次该指令内容，用于预览效果

九、授权群组页详解

管理"哪些群可以使用插件"。只有授权过的群，插件功能才会对该群生效（需配合全局开关"仅授权群可使用插件"）。

9.1 顶部统计卡

卡片	含义
授权群总数	`已授权群数 / 授权上限`（上限 20 个）
已授权成员	授权群内成员总数
剩余授权数	还可以再授权多少个群
今日新增授权	今天新授权的群数量

9.2 授权群列表

列	说明
ID/序号	序号
群号	QQ 群号
群名称	群名片
群成员数	当前群人数
授权状态	已授权 / 未授权（含到期时间）
授权时间	授权的设置时间
操作	编辑授权

支持按群号/群名称搜索；列表下方有分页器（可切换每页 10/20/50 条）。

9.3 授权编辑器

选中某个群后可操作：

按钮	功能
到期时间（年/月/日）	设置授权的有效截止日期
设置授权	按设定的到期时间给该群授权
取消授权	撤销该群授权
开启/关闭群	切换该群的插件启用状态
开启全部群	一键启用所有群的插件
关闭全部群	一键停用所有群的插件

9.4 授权说明（官方规则）

授权后，群内成员可正常使用插件全部功能。
取消授权后，群内成员将无法使用插件功能。
单个群授权数量上限：500 人；总授权群数量上限：20 个。

十、分群配置页详解（8 个标签页）

分群配置是本插件功能最多的页面，所有设置只对"当前分群"生效（顶部群号选择器选中的群）。每个标签页顶部都有"当前分群信息卡"，显示正在配置的群名称与群号——配置前务必确认是这个群！

10.1 标签页一：基础配置

管理员设置

字段	说明
主人QQ	只读展示全局主人（在全局配置页修改）
管理QQ	本群的管理员 QQ 列表，多个用逗号分隔

群行为选项

选项	说明
开启聊天女仆	开启后群成员可用"聊天前缀+内容"与机器人闲聊
聊天女仆角色	萝莉 / 御姐 / 管家，影响聊天语气
聊天前缀	触发聊天女仆的前缀，默认 `#`，如发送 `#你好`
警告次数达到 N 次后踢出群	违禁词警告累计达到次数自动踢人
倒计时 N 秒后撤回自身消息	机器人自己发的提示消息倒计时后自动撤回
每 N 分钟机器人自动在群里发送一条消息	定时循环发言功能，下方文本框填内容

开关组

开关	说明
启用本群插件	本群插件总开关
启用违禁词检测	是否检测本群违禁词
触发后警告	违禁词命中时发警告
触发后禁言	违禁词命中时禁言（需机器人是群管理员）
开启邀请统计	开启本群邀请数据统计

文本配置

字段	说明
自定义菜单	本群专属菜单内容，留空使用全局菜单
违禁警告文本	触发违禁词时发送的警告语，默认"请注意文明发言。"

监控撤回（9 项复选框）

勾选后，机器人会对本群所有成员的对应类型消息执行"防撤回"（有人撤回时机器人自动补发内容），包括：群消息防撤回、红包消息撤回、图片消息撤回、视频消息撤回、签到消息撤回、网址消息撤回、卡片消息撤回、语音消息撤回、XML 消息撤回。

「应用到全部群」按钮：把当前配置一键复制应用到所有群（批量配置神器）。

10.2 标签页二：入群审核

前提：机器人需要是本群管理员，且 QQ 群设置中开启了"需要验证消息"。

加群申请处理

选项	说明
有人申请加群	不处理（人工审核）/ 同意（全部自动通过）/ 拒绝（全部自动拒绝）
默认拒绝理由	自动拒绝时发给对方的理由
新人进群禁言 N 分钟	新人进群自动禁言，留空或 0 表示不禁言

审核规则设置（命中任一条将拒绝加群）

规则	条件	拒绝理由（可自定义）
审核QQ昵称	昵称包含指定关键词则拒绝	默认"您的昵称包含违禁词，请修改后再申请"
审核QQ签名	个性签名包含指定关键词则拒绝	默认"您的个性签名包含违禁内容"
审核QQ等级	QQ等级低于设定值则拒绝	默认"您的QQ等级过低，不符合本群要求"
审核QQ达人	QQ达人天数低于设定值则拒绝	默认"您的QQ达人天数过低，请活跃后再申请"

审核条件留空表示不启用该项审核。

入群名片

开启后，新人进群自动设置统一格式的群名片（最长 16 字符）：男生名片（默认 ♂ 小林）、女生名片（默认 ♀ 小林）、默认名片（默认 小林的朋友）。

10.3 标签页三：入群验证

新人进群后，机器人发送验证码做人机核验，未通过验证的会被自动踢出。

验证码参数

字段	说明
开启验证码	本群验证功能总开关
验证码有效期	超时自动失效（默认 120 秒，可选秒/分钟）
验证码长度	建议 4~8 位（默认 5 位）
验证码类型	随机数字 / 随机字母 / 数字字母混合；可选择"固定验证码"并指定固定内容

自定义回复消息（4 段文案均可自定义，支持变量）

文案	触发时机	默认内容
发送验证码	新人进群时	`[AT] [QQ头像][提示] 本群已开启验证码模式，请在 [验证码时间] 秒内输入您的验证码...`
验证码正确回复	验证通过	通过验证，欢迎入群！
验证码错误回复	输入错误	验证码错误，请重新输入
验证码超时回复	超时被踢	超时未输入验证码，已自动踢出，请重新申请入群

可用变量（点击即可插入）：[AT]、[QQ头像]、[验证码]、[验证码时间]。每段文案限 200 字。

10.4 标签页四：群聊提示

为 9 种群事件分别设置"是否提示 + 提示内容"：

事件	默认状态	默认提示内容
新人进群提示	开	欢迎 [QQ] 加入本群！[AT] 请先阅读群公告哦~
进群私聊提示	开	[AT] 你好，欢迎加入 [群名]！我是本群的管理机器人，输入「菜单」查看功能。
邀请好友提示	关	[操作QQ] 邀请 [QQ] 加入了本群。
群员退群提示	关	[QQ] 离开了我们，一路走好。
被踢出群提示	关	[QQ] 已被 [操作QQ] 移出本群。
群员禁言提示	开	[AT] 你被禁言了，请遵守群规。
群员解禁提示	关	[AT] 已解除禁言。
升级管理提示	开	[AT] 恭喜成为本群管理员！
取消管理提示	关	[AT] 已被取消管理员。

操作方式：左侧列表点击事件 → 右侧编辑器修改内容（限 500 字）→ 支持点击插入变量 → 下方实时预览气泡效果。

10.5 标签页五：刷屏检测

自动识别并处罚刷屏/灌水行为。

频率规则：群成员在 N 秒（默认 60）内最多发送 M 条（默认 10）消息，超出判定为刷屏。

处罚设定

字段	说明
刷屏处罚方式	警告 / 禁言 / 踢出群
禁言时间	选择"禁言"处罚时的时长（分钟）

单条消息规则（任一超出即触发）

规则	默认阈值
发言消息行数超过	5 行
发言消息汉字超过	50 个
发言消息数字超过	100 个
发言消息字母超过	100 个

白名单成员不受刷屏检测约束。

10.6 标签页六：功能开关

按需开/关本群的细分功能：

开关	分类	说明
开启图片菜单	菜单功能	控制图片菜单类指令是否响应
开启视频菜单	菜单功能	控制视频菜单类指令是否响应
开启便民查询	实用工具	控制农历、历史今天、QQ评估等查询指令
开启文案语录	实用工具	控制段子、谜语、土味情话等文案指令
开启在线听歌	预留功能	预留开关，当前机器人执行侧暂未接入
开启看图猜词	预留功能	预留开关，当前机器人执行侧暂未接入
开启猜数游戏	预留功能	预留开关，当前机器人执行侧暂未接入
开启成语接龙	预留功能	预留开关，当前机器人执行侧暂未接入

10.7 标签页七：邀请统计

展示本群的邀请数据（需在基础配置开启"邀请统计"）：

三个统计卡：本周邀请人数、本周退群人数、活跃邀请者人数。
邀请数据表：按成员列出邀请人数、退群人数及周对比（"邀请列表/退群列表"明细按钮为预留，暂未接入）。
近 7 天邀请趋势图：紫色折线为邀请人数、粉色折线为退群人数。
数据概览：累计邀请人数、累计退群人数、平均每人邀请、邀请成功率。
邀请排行榜（本周）：金银铜牌展示 Top 邀请者。
「导出数据」按钮可导出当前数据。

10.8 标签页八：发言统计

展示本群的发言活跃度数据：

三个统计卡：今日总发言、本周活跃成员、月度发言总数。
发言明细表与趋势图表。
「导出数据」按钮可导出当前数据。

十一、问答管理页详解

问答系统 = 关键词自动回复。群成员发言命中关键词，机器人立即回复设定内容。

11.1 问答列表

列	说明
复选框	勾选后可批量操作
ID	规则编号，点击行可载入编辑器
关键词	触发词
分辨方式	精确匹配 / 模糊匹配
发送内容	命中后回复的内容
生效范围	当前群 / 全部群
启用	开关状态

工具栏：搜索框、批量启用、批量停用、新增问答。列表下方有分页器。

11.2 问答编辑器

字段	说明
关键词 *	必填。多个关键词用 `\|` 分隔，任一命中即触发
分辨方式	精确匹配（整句一致）/ 模糊匹配（包含即触发）
生效范围	当前群（仅本群生效）/ 全部群（所有群通用）
发送内容 *	必填。支持变量 `[AT]` `[QQ]` `[昵称]`；多条回复用 `\|` 分隔时随机选一条

11.3 操作按钮

按钮	功能
添加/修改	新增规则，或保存对已选规则的修改
删除选中	删除列表中勾选的规则
保存全部	把整个问答库保存到宿主
测试发送	让机器人真实发送一次当前编辑的回复内容

右侧"效果预览"会实时模拟聊天气泡，变量自动替换为示例值。

十二、定时任务页详解

让机器人在指定时间自动执行任务。

12.1 顶部统计

卡片	含义
已启用任务	当前启用中的任务数
今日待执行	今天还会执行的任务数
成功执行率	历史执行成功率

12.2 任务列表

列	说明
执行时间	HH:mm 格式
周期	每天 / 每周 / 每月 / 每隔N分钟
任务类型	发送群消息 / 群禁言 / 群解除禁言 / 群提醒 / 签到通知 / 群欢迎 / 福利通知
发送内容	任务执行的内容
目标范围	当前群 / 全部群
启用	任务开关

工具栏：搜索、按类型筛选、按状态筛选、查询、重置、新增任务。

12.3 任务编辑器

字段	说明
执行时间	时 : 分（24 小时制）
执行周期	每天 / 每周 / 每月 / 每隔N分钟
任务类型	同上表 7 种
目标范围	当前群 / 全部群
发送内容 *	支持变量 `[群号]` `[群名]` `[日期]` `[时间]`

操作按钮：添加/修改、删除选中、保存全部、立即执行（不等到设定时间，马上跑一次，用于验证任务配置）。

修改任务后记得点"保存全部"，定时器会自动重启并按新配置运行。

十三、黑白名单页详解

13.1 顶部统计

黑名单人数、白名单人数、今日拦截次数。

13.2 名单表格（黑/白名单各一张表）

列	说明
复选框	勾选后可批量移除
成员	QQ 号
添加时间	进入名单的时间
状态	名单状态

每张表底部有：移除选中、清空、页码。支持按 QQ/昵称搜索。

13.3 名单策略（右侧面板）

字段	说明
触发行为	黑名单成员发言时的处置：拒绝处理消息 / 警告一次 / 自动禁言 / 直接踢出
禁言时长（分钟）	选择"自动禁言"时的时长
拒绝理由	处置时提示的文本
批量添加账号	文本框内每行一个 QQ 号，自动统计已输入个数
批量加入黑名单 / 批量加入白名单	一键批量入名单
保存名单策略	保存策略设置（对当前分群生效）

13.4 名单规则说明

黑名单：成员消息按策略处置（拒绝/警告/禁言/踢出），进群也会被拦截。
白名单：成员可豁免违禁词检测、刷屏检测等功能限制。
名单数据仅对当前分群生效。

十四、违禁词汇页详解

14.1 顶部统计

违禁词总数、今日触发次数、自动处理规则数。

14.2 违禁词列表

列	说明
ID	编号，点击行载入编辑器
违禁词	敏感词本体
分类	广告词 / 敏感词 / 违规词
范围	当前群 / 全部群
警告 / 撤回 / 禁言 / 踢出	四档处置的组合勾选
状态	启用 / 停用

工具栏：搜索、分类筛选（全部/广告词/敏感词/违规词）、刷新、导出（导出 JSON）、新增词汇。

14.3 违禁词编辑器

字段	说明
违禁词 *	必填。多个词用 `\|` 分隔，如 `广告\|刷单\|兼职`
词汇分类	广告词 / 敏感词 / 违规词
生效范围	当前群 / 全部群
触发处置	警告 / 撤回 / 禁言 / 踢出四个复选框任意组合

处置执行顺序：消息命中违禁词时，按 警告 → 撤回 → 禁言 → 踢出 的顺序执行勾选的组合。例如同时勾选"警告+撤回"，机器人会先发警告语再撤回该消息。

撤回/禁言/踢出需要机器人是群管理员。

十五、群内聊天指令大全

以下指令直接在群里发送即可（若全局配置设置了命令前缀如 /，则在指令前加前缀，如 /菜单）。

15.1 状态与管理类

指令	权限	说明
`菜单`	所有人	返回菜单内容（触发词可在全局配置自定义）
`插件状态`	所有人	查看插件运行状态、授权情况
`开启本群`	插件管理员	开启本群插件功能
`关闭本群`	插件管理员	关闭本群插件功能
`授权本群`	主人	永久授权当前群
`授权本群 30`	主人	授权当前群 30 天（数字自定义，可带"天"）
`取消授权本群`	主人	取消当前群授权

15.2 主人/管理员管理类

指令	权限	说明
`添加主人 QQ号`	主人	添加全局主人
`删除主人 QQ号`	主人	删除全局主人
`添加插件管理员 QQ号`	主人	添加插件管理员（跨群权限）
`删除插件管理员 QQ号`	主人	删除插件管理员
`添加群管理员 QQ号`	插件管理员	添加本群管理员
`删除群管理员 QQ号`	插件管理员	删除本群管理员
`管理员列表`	所有人	查看主人/管理员列表

15.3 名单管理类

指令	权限	说明
`添加白名单 QQ号`	群管理员	加入白名单
`删除白名单 QQ号`	群管理员	移出白名单
`添加黑名单 QQ号`	群管理员	加入黑名单
`删除黑名单 QQ号`	群管理员	移出黑名单
`名单列表`	所有人	查看本群黑白名单

15.4 问答管理类

指令	权限	说明
`添加问答问题\\|答案`	群管理员	添加本群问答，如 `添加问答你好\|你好呀~`
`删除问答问题`	群管理员	删除本群问答
`问答列表`	所有人	查看本群问答
`添加全局问答问题\\|答案`	插件管理员	添加全局问答（所有群生效）
`删除全局问答问题`	插件管理员	删除全局问答
`全局问答列表`	所有人	查看全局问答

15.5 违禁词管理类

指令	权限	说明
`添加违禁词词`	群管理员	添加本群违禁词
`删除违禁词词`	群管理员	删除本群违禁词
`违禁词列表`	所有人	查看本群违禁词
`添加全局违禁词词`	插件管理员	添加全局违禁词
`删除全局违禁词词`	插件管理员	删除全局违禁词
`全局违禁词列表`	所有人	查看全局违禁词
`违禁词策略警告`	群管理员	查看违禁词处置策略

15.6 定时任务类

指令	权限	说明
`添加定时 08:30\\|早上好`	插件管理员	添加每天 08:30 发送"早上好"的任务
`定时列表`	所有人	查看本群定时任务
`删除定时 1`	插件管理员	删除编号为 1 的任务

15.7 娱乐 API 指令类

需在全局配置开启「启用扩展 API 指令」，且对应功能开关（分群配置→功能开关）已开启。

指令	说明
`段子`	随机返回一条段子
`谜语`	随机谜语
`土味情话`	随机土味情话
`舔狗日记`	随机舔狗日记
`今日运势关键词`	查询今日运势，如 `今日运势小林`
`诗词内容`	诗词查询/创作，如 `诗词静夜思`
`QQ评估 QQ号`	对指定 QQ 进行趣味评估
`农历`	查询今日农历日期
`历史今天` / `历史上的今天`	查看历史上的今天

十六、可用变量大全

在以下位置填写内容时可以使用变量，机器人发送时会自动替换为真实值：

变量	替换为	可用位置
`[AT]`	@对方（艾特该成员）	问答、群事件提示、验证码文案
`[QQ]`	对方 QQ 号	问答、群事件提示
`[昵称]`	对方昵称	问答
`[QQ头像]`	对方头像	验证码文案
`[验证码]`	当前验证码内容	验证码文案
`[验证码时间]`	验证码有效期秒数	验证码文案
`[操作QQ]`	执行操作的人（如踢人者）	群事件提示
`[群号]`	群号	群事件提示、定时任务
`[群名]` / `[群名称]`	群名称	群事件提示、定时任务
`[当前时间]`	当前时间	群事件提示
`[日期]`	当前日期	定时任务
`[时间]`	当前时间	定时任务

变量输入技巧：编辑器旁一般有"插入变量"按钮或变量标签，点击即可自动插入，无需手打。

十七、权限等级体系

插件采用五级权限体系，高级权限自动包含低级权限：

成员 < 群管理员 < 群主 < 插件管理员 < 主人(Owner)

等级	获得方式	典型权限
成员	所有人	菜单、问答、娱乐指令、各类列表查询
群管理员	群内是管理员，或被 `添加群管理员`	名单管理、本群问答/违禁词管理
群主	QQ 群主身份	同群管理员
插件管理员	被 `添加插件管理员` 或在控制台填写	开关本群、定时任务、全局问答/违禁词
主人	全局配置「全局主人」中填写	一切权限：授权群、管理主人等

十八、常见问题 FAQ

Q1：机器人不回复指令？ 按顺序排查：① 全局配置「启用插件总开关」是否开启；② 群是否已授权（且开启了"仅授权群可使用"）；③ 分群配置→基础配置「启用本群插件」是否开启；④ 指令是否写错/带了命令前缀；⑤ 首页日志里有没有对应记录。

Q2：修改了全局小尾巴，机器人回复还是旧的？ 修改后必须点击「保存全局配置」（或 Ctrl+S）才会生效。保存成功后机器人下一条回复就会使用新尾巴。留空小尾巴则完全不附加。

Q3：禁言、踢人、撤回别人消息不生效？ 这些操作要求机器人是本群管理员或群主，请先给机器人提升群权限。

Q4：入群审核/入群验证不触发？ ① 机器人需为群管理员；② QQ 群设置中需开启"需要验证消息"；③ 检查对应开关是否开启。

Q5：配置文件保存在哪里？ 配置存储在 UniQQ 数据目录的 ZL-综合插件/config.json，与 .uniqq 安装包在同一插件数据体系内。建议定期用首页「导入/导出」按钮备份。

Q6：换电脑/重装框架怎么迁移配置？ 旧环境首页 →「导入/导出」→ 选"是"导出 JSON 文件；新环境同样位置选"否"导入该文件即可。

Q7：首页数据多久刷新一次？ 实时数据（统计、日志、好友数、在线时长）每秒自动刷新，无需手动刷新页面。

Q8：多个机器人账号可以用吗？ 可以。控制台顶部「框架QQ」下拉可切换机器人，配置按机器人独立加载。

Q9：娱乐指令提示"该功能已在本群关闭"？ 去「分群配置 → 功能开关」把对应功能（文案语录/便民查询等）打开，并确认全局配置已开启「启用扩展 API 指令」。

Q10：「在线听歌」「看图猜词」等开关打开没反应？ 这些是预留功能，当前版本机器人执行侧暂未接入，开关仅作为后续版本预留，敬请期待更新。

十九、售后服务与联系方式

项目	信息
作者	小林
作者 QQ	939921104
官方网站 / 帮助文档	https://blog.zxiaolin.com
控制台快捷帮助	首页 → 快捷操作 → 「使用帮助」按钮

售后服务说明：如果遇到不懂的问题、无法解决的问题或 BUG 等问题，请联系自己的上级或作者远程协助处理。

购买/授权提示：目前只有官方渠道和代理渠道可以开通授权，请勿轻信他人低价授权等，以防上当受骗！

文档版本：v1.0 ｜对应插件版本：1.4.6 ｜最后更新：2026-08-29

© 小林 · ZL-综合插件 · 让管理更简单，让机器人更智能 💜

目录