ZL-综合插件 · 新手使用教程
作者:薇薇 | 作者官网:https://blog.zxiaolin.com | 官方群:327942687 当前文档对应版本:2.2.1
> 系统架构图:架构图
📚 教程目录
| 文件 | 内容 | 适合谁看 |
|---|---|---|
| 00-快速开始.md | 插件介绍、安装、首次配置、5分钟跑起来 | 💡 所有人,从这里开始 |
| 01-新手安装教程.md | 从下载、运行库、登录机器人,到安装插件、首次配置、验收和排错 | 🌱 第一次接触 UniQQ 的新手 |
| 02-基础概念与权限体系.md | 权限等级、授权机制、绑定机制、指令触发规则 | 💡 所有人 |
| 03-控制台页面详解(上).md | 首页、全局配置、菜单指令、授权群组 | 🔧 机器人主人 |
| 04-控制台页面详解(下).md | 分群配置(10个子页)、问答、知识库、定时、黑白名单、违禁词、AI中心 | 🔧 机器人主人 |
| 05-AI功能详解.md | AI服务配置、女仆聊天、Agent 45工具、知识库、技能系统、联网搜索、管家模式 | 🤖 想用AI的人 |
| 06-指令大全.md | 全部群内指令、权限、参数、别名与 AI 口语指令 | 📖 速查手册 |
| 07-娱乐与实用功能.md | 点歌、签到、金币与奴隶玩法、点赞、图片、便民查询、戳一戳、出租系统 | 🎮 玩家与群主 |
| 08-多机器人认领操作流程.md | 多QQ号「1群1管理」:归属指定、验证、换绑全流程 | 🤖 多号用户 |
| 09-常见问题FAQ.md | 安装、功能、AI、更新等常见问题排查 | 🆘 遇到问题时 |
| 10-文字转图片功能详解.md | 文字转图片:原理、开关指令、触发条件、控制台参数、渲染引擎 | 🖼️ 想美化回复的人 |
| 11-AI审核Token消耗与成本优化.md | AI 审核单次/二次复核 Token 测算、全量模式消耗量级、省 Token 手段 | 💰 控制成本 |
| 12-版本更新日志.md | 全部版本历史(1.0.0 → 2.2.1),按新增/优化/修复分类 | 📋 查版本变化 |
| 13-官方机器人协作教程.md | 官机登录、群绑定、成员映射、职责分工、Markdown 卡片与故障排查 | 🤝 使用 QQ 官方机器人的用户 |
| 14-完整使用手册.md | 单文件完整版:全部 26 个页面 + 指令大全 + 变量 + 权限 + FAQ | 📘 想一次看全的人 |
🌟 插件是什么
ZL-综合插件是一款运行在 UniQQ 框架上的全能群管机器人插件,完全免费。
一句话总结:装上它,你的QQ号就能变成一个会聊天、能管群、可点歌的智能机器人。
核心能力一览
👑 群管体系:授权群组、黑白名单、违禁词、刷屏检测、入群审核/验证/名片
🤖 多号分身:多机器人「1群1管理」,每个群指定归属号,其他号完全静默
🤖 AI 智能:AI Agent(45 个内置工具,@机器人说人话直接办事)、知识库问答、技能市场、女仆聊天(五套人设:萝莉/御姐/管家/御姐管家/Agent 智能助手)、图片识别、联网搜索、群聊总结
🎵 在线娱乐:四类音乐入口(网易云/QQ/酷狗/酷我)、共享酷狗账号、榜单与序号点歌、每日签到、群聊点赞、图片接口、便民查询
📊 数据统计:发言统计全家桶(今日/昨日/本周/本月/指定日期+排行)、邀请统计、群龙王、成员去重、签到排行
⏰ 自动化:定时任务、循环消息、授权到期提醒、进退群提示
🏠 出租系统:按群出租机器人,授权增减、开/关机、到期自动提醒/退群
📦 2.2.1 版本亮点
🗳️ 全新投票系统:管理员多行发起(
发起投票 周末去哪玩+1、火锅),群友发投票1一键参与;支持多选、▓░条形图结果、匿名一人一票、24小时自动截止📮 全新留言反馈:群友发
反馈/留言 + 内容,机器人回执后私聊转达主人/指定QQ,还可选 Webhook 推送与邮件送达;每人每天3条防骚扰👥 全新成员比对:两群交集成员一键列出,按角色筛选,单人/批量移出、可选拉黑
🎯 全新针对系统:被针对的人每发一条消息就撤回 / 艾特指定人,页面+指令双通道
🔇 踢出/禁言支持「撤回N」:
踢出 @成员 撤回20连带撤回最近消息🎛️ 菜单更新:主菜单与官机卡片新增「投票系统|留言反馈」入口,老用户重启自动升级
🐛 五项修复:群总开关失灵、插件启用失败、针对系统列表不刷新、控制台整页点不动、官机卡片不更新
📦 2.2.0 版本亮点(上一版)
🤝 官方机器人协作体系成型:官机负责菜单、卡片、问答、AI 等可见回复,普通号负责禁言/踢人/撤回等实际动作并在后台静默;官方虚拟群 ID ↔ 真实群号、虚拟成员 ID ↔ 真实 QQ 自动映射,官机发不出时自动回退普通号不丢消息
🖼️ 官机富媒体:官机可发 Markdown 卡片、图片(图文同条)、视频与真音乐卡;主菜单、子菜单、问答、验证码、群事件提示、定时任务都能各自编辑官机专属卡片
🛰️ 定时消息官机投递:官机发不出时自动「顺风车」挂起,等群里再有人说话时补发(不占主动消息额度);需要准点可开「准点触发」
🖥️ 定时任务有官机卡片了:每条任务可单独写一份官机专属 Markdown(标题/图片/列表/按钮),官机发卡片、普通号发纯文本,互不覆盖;也支持只填卡片、文本留空
🐛 官机真艾特彻底修好:入群欢迎等场景艾特显示成员真实昵称,告别 XML 乱码和 @QQ 号;长消息分片不再切断艾特代码
🐛 带艾特指令修复:
赞 @某人 20、戳一戳 @某人、添加/删除群管理员 @某人全部恢复正常🖥️ 控制台布局重构:表单卡按内容自然增高不再被裁切,列表卡撑满剩余高度、行数再多也只滚卡片内部;兼容旧版 WebView2 内核
🤖 Agent 智能助手:45 个内置工具,@机器人说人话直接办事;配置类指令真正写库并回执,不再编一段文案糊弄
🛡️ 2.1.6 版本亮点(上一版)
🤫 新装全静默:未授权群出厂不再发送任何提示(未授权回复/能力提示/权限不足/绑定码提示全部默认关闭),机器人被拉进陌生群一声不吭,不会再被群主当骚扰踢掉;主人授权后照常
🐛 官机真艾特修好:入群欢迎艾特显示成员真实昵称,告别 XML 乱码和 @QQ 号;官方卡片自定义 Markdown 保存后不再丢失
🛰️ 定时消息不再石沉大海:官机发不出时自动「顺风车」挂起,等群里再有人说话时补发(不占主动消息额度);需要准点可开「准点触发」
🖥️ 定时任务有官机卡片了:每条任务可单独写一份官机专属 Markdown(标题/图片/列表/按钮),官机发卡片、普通号发纯文本,互不覆盖
👍 带艾特指令修复:
赞 @某人 20、戳一戳 @某人、添加/删除群管理员 @某人全部恢复正常🤖 女仆开关真生效:关闭聊天女仆后 @机器人不再闲聊;Agent 助手独立开关不受影响
🖥️ 2.1.13 版本亮点
🖥️ 表单卡不再被裁切:邮件提醒、关键词预警、生日纪念、日程提醒、金币玩法、文字转图片等页面的卡片改为按内容自然增高,之前被永久裁掉、滚轮够不到的下半部分全部回来了
📜 列表型表格恢复独立滚动:问答管理、知识库、长期记忆、定时任务、违禁词汇、黑白名单、分群邀请/发言/签到统计的行数再多也能滚着看完
📏 记录卡撑满剩余高度:邮件发送记录、告警记录、预警触发记录、生日名单、日程列表自动占满页面剩余空间,底部不再留大片空白
🗂️ 分群页每个 Tab 独立滚动:长表单能滚,统计表格在卡片内独立滚,互不影响
⚡ 2.1.12 版本亮点
🧩 技能匹配改严格制:Agent 里点名技能只认「技能全名/关键词 + 分隔符」,取消 2~6 字模糊缩写——点名技能一定调得到,普通说话也不会再被技能误撞
⚡ 点名技能直通车:
中英互译 今天天气真好直接执行,不经过模型🔎 无歧义查询直通车:22 个只读查询(运行状态、问答规则、违禁词、群成员、发言统计、提醒、生日…)意图唯一时直接执行,不再让模型挑工具
🧠 长期记忆直通车:
记住xx确定性入库、还记得吗确定性翻查,「提醒我…」仍归日程不会误存🎴 工具结果统一样式:标题 + 图标 + 分隔线,查询结果更整齐
📦 2.1.11 版本亮点
🧭 Agent 路由收口:插件查询/配置/群管意图与 AI 创作技能改为互斥路由——命中本地工具意图后不再把技能清单和
use_skill交给模型,轻量模型没法再把「配置问答」当写文案糊弄过去🚫 修复技能抢消息:Agent 人设下显式 @机器人 时,群级与聊天内两处技能触发都让路,完整请求统一交给 Agent 判断
🎯 技能白名单:只有翻译、润色、起名、写文案等创作意图(或点名技能)才暴露
use_skill🔀 查询不再被当写入:「有哪些问答」调
get_qa_rules、「有哪些违禁词」调get_forbidden_words、「我的提醒」调list_reminders、「我的生日」调my_birthday
📦 2.1.10 版本亮点
🎯 查清「说添加问答却调不到工具」的真凶:消息根本没走到 Agent——被 AI 技能的模糊匹配半路抢走了,模型拿着技能人设编出一大段文案。现在问答配置指令在聊天入口最前面直接执行,谁也别想截胡
🚀 问答配置快车道:
帮我添加一个问答 用户问1回答2这类句子解析出问/答就直接写库回执,不经过模型、不消耗额度,也不受冷却/人设影响🩺 新增
Agent路由诊断日志:每次唤醒都记录女仆开关、角色、引擎状态、是否工具请求,下次"没调到工具"一眼定位
📦 2.1.9 版本亮点
🪞 修复官机自问自答:官机 7 条发送路径只有 1 条记录了发送回显戳,其余路径发出的消息被官机自己收到后当成用户消息再投影回来,AI 对自己的回复再回一轮;现已全部补齐
📦 2.1.8 版本亮点
🔍 修复「Agent 人设下工具全不可用」的静默失效:Agent 引擎开关关闭时,工具类请求旧版会静默变成女仆闲聊(模型只能编内容),现在直接回引导告知开启方法
📊 AI状态新增「Agent 引擎」行:人设和引擎开关是两回事,面板不再谎报"工具/技能全开"
📦 2.1.7 版本亮点
🛰️ 修复官机重启后被永久当成离线:官机 + 普通机器人同时重启后,官机回复全被普通机器人代发且不自愈;现在官机身份按框架虚拟号段直判,不受会话注册时序影响
🛟 官机选怪兜底:机器人列表识别不到官机时,改用「最近收到过官方事件」判定存活,事件新鲜即在线
📦 2.1.6 版本亮点
🛠️ 修复 Agent 不执行「添加问答」:说
帮我添加一个问答 用户问xx回答yy时,不再自己编一段文字回你,而是真正写进问答库并回执🛡️ 配置类指令加固:
添加 / 删除 / 查看 问答、违禁词、定时任务一律判定为工具调用,禁止用"写一段"糊弄过去
📦 2.1.5 版本亮点
🤖 Agent 专用人设:新增「Agent 智能助手」角色,是本群唯一能调用插件全部工具与技能的人设
🎭 人设分能力:萝莉/御姐/管家/御姐管家变为纯陪聊,遇到工具类请求会提示主人切到 Agent(可在控制台关闭该限制)
⌨️ 群内切人设:主人/管理员发
人设 Agent、人设 萝莉即可切换,自动清空会话记忆避免角色串味💅 人设大升级:四套人设从一句话扩成多句行为描述,每个角色还有专属排版风格(图标、行宽、节奏都不一样)
📐 排版美化:强制分行、行首 emoji、
┈┈┈┈┈┈┈┈分隔,并加兜底重排——模型挤成一坨也会被自动拆开
📦 2.1.4 版本亮点
🎬 官机发视频:
小姐姐视频等指令经官方富媒体通道直接出片,失败自动降级文字链接🎵 真音乐卡:官机协作时由普通机器人代发带播放按钮的真音乐卡,官机只发简短回执
🛡️ 官机保护:官机群成员别名自动识别并豁免风控,回复不再被误撤、AI 不再多 @
✅ 等级审核:入群审核新增 QQ 等级门槛,低于设定值自动拒绝
🖥️ 滚动修复:授权群列表 / 菜单列表在窗口偏矮时也能正常滚动
🚀 5分钟快速上手
第 1 步:安装插件
拿到插件包
XiaoLin.ZLComprehensivePlugin.uniqq把它放进 UniQQ 的
Plugins文件夹启动(或重启)UniQQ,在插件管理里启用「ZL-综合插件」
💡 提示:UniQQ 需要 .NET 运行库和 WebView2 运行时,一般电脑都自带;打不开控制台时优先检查 WebView2。
第 2 步:打开控制台
在 UniQQ 插件管理里点击本插件的「设置/配置」,会打开图形化控制台窗口。
控制台 = 机器人的驾驶舱,所有配置都在这里改,改完记得点「保存」。
第 3 步:完成绑定(重要)
插件安装后有 7 天全功能试用期
试用期结束后,点歌 AI聊天 自定义回复 / AI总结会被限制(菜单、状态等基础功能不受影响)
免费绑定方法:
加入官方群 327942687
在群内发送「绑定码」获取专属一次性绑定码(24小时有效)
打开控制台右上角「设置」→「安全」→ 输入绑定码 → 完成绑定
⚠️ 注意:绑定是免费的,任何收费都是骗子。
第 4 步:配置主人 QQ
控制台 →「全局配置」→「全局主人QQ」→ 填你自己的 QQ 号 → 保存。
主人拥有最高权限,可以授权群、加管理员、更新插件等。
第 5 步:授权第一个群
机器人默认只在授权过的群里工作,未授权群完全静默。
方式一(群内指令):在目标群发送
只有主人能执行,也可以指定天数:授权本群 30天
方式二(控制台):控制台 →「授权群组」→ 找到目标群 → 点击授权。
第 6 步:验收
在已授权的群里发送:
机器人回复完整菜单,就说明全部配置成功啦!🎉
🗺️ 功能地图(先混个眼熟)
🧭 学完这套教程你会
✅ 独立安装、绑定、授权机器人
✅ 看懂控制台每一个页面的每个开关
✅ 配置出专属的 AI 女仆 / 管家
✅ 用指令管理群聊的一切
✅ 知道出问题时去哪里排查