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功能详解.mdAI服务配置、女仆聊天、Agent 45工具、知识库、技能系统、联网搜索、管家模式🤖 想用AI的人
06-指令大全.md全部群内指令、权限、参数、别名与 AI 口语指令📖 速查手册
07-娱乐与实用功能.md点歌、签到、金币与奴隶玩法、点赞、图片、便民查询、戳一戳、出租系统🎮 玩家与群主
08-多机器人认领操作流程.md多QQ号「1群1管理」:归属指定、验证、换绑全流程🤖 多号用户
09-常见问题FAQ.md安装、功能、AI、更新等常见问题排查🆘 遇到问题时
10-文字转图片功能详解.md文字转图片:原理、开关指令、触发条件、控制台参数、渲染引擎🖼️ 想美化回复的人
11-AI审核Token消耗与成本优化.mdAI 审核单次/二次复核 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 步:安装插件

  1. 拿到插件包 XiaoLin.ZLComprehensivePlugin.uniqq

  2. 把它放进 UniQQ 的 Plugins 文件夹

  3. 启动(或重启)UniQQ,在插件管理里启用「ZL-综合插件」

💡 提示:UniQQ 需要 .NET 运行库和 WebView2 运行时,一般电脑都自带;打不开控制台时优先检查 WebView2。

第 2 步:打开控制台

在 UniQQ 插件管理里点击本插件的「设置/配置」,会打开图形化控制台窗口。

控制台 = 机器人的驾驶舱,所有配置都在这里改,改完记得点「保存」。

第 3 步:完成绑定(重要)

  • 插件安装后有 7 天全功能试用期

  • 试用期结束后,点歌 AI聊天 自定义回复 / AI总结会被限制(菜单、状态等基础功能不受影响)

  • 免费绑定方法:

    1. 加入官方群 327942687

    2. 在群内发送「绑定码」获取专属一次性绑定码(24小时有效)

    3. 打开控制台右上角「设置」→「安全」→ 输入绑定码 → 完成绑定

⚠️ 注意:绑定是免费的,任何收费都是骗子。

第 4 步:配置主人 QQ

控制台 →「全局配置」→「全局主人QQ」→ 填你自己的 QQ 号 → 保存。

主人拥有最高权限,可以授权群、加管理员、更新插件等。

第 5 步:授权第一个群

机器人默认只在授权过的群里工作,未授权群完全静默。

方式一(群内指令):在目标群发送

授权本群

只有主人能执行,也可以指定天数:授权本群 30天

方式二(控制台):控制台 →「授权群组」→ 找到目标群 → 点击授权。

第 6 步:验收

在已授权的群里发送:

菜单

机器人回复完整菜单,就说明全部配置成功啦!🎉


🗺️ 功能地图(先混个眼熟)

ZL-综合插件
├── 👑 管家基础
│   ├── 授权群组 / 出租系统
│   ├── 权限管理(主人/插件管理员/群管理员)
│   ├── 黑白名单
│   ├── 运行状态 / 检测更新
│   └── 多号 1群1管理(群归属指定)
├── 🛡️ 群管防护
│   ├── 违禁词(撤回/警告/禁言)
│   ├── 刷屏检测
│   ├── 入群审核 / 入群验证 / 入群名片
│   ├── 群聊提示(进群/退群/禁言/管理变动)
│   ├── 撤回三件套(自身撤回/监控撤回/主动撤回)
│   ├── AI 内容审核(规则候选/精判/复核/处置日志)
│   ├── 成员比对(两群交集清人,2.2.1新增)
│   └── 针对系统(撤回/艾特联动,2.2.1新增)
├── 🤖 AI 智能
│   ├── AI Agent(45个内置工具,口语化指令直接办事,危险操作二次确认)
│   ├── 知识库(42条内置功能知识,按词条原文回答)
│   ├── 技能系统(直发技能名调用 + 技能市场在线安装)
│   ├── 女仆聊天(萝莉/御姐/管家)
│   ├── 图片识别(发图@机器人)
│   ├── 联网搜索(智谱/千问)
│   ├── 群聊总结(总结 / 总结@某人)
│   └── 管家模式(大白话执行指令)
├── 🎮 娱乐互动
│   ├── 在线点歌(网易云/QQ/酷狗/酷我,支持共享酷狗账号)
│   ├── 每日签到 + 连签加成
│   ├── 金币玩法(抢金币/奴隶系统)
│   ├── 投票系统(多行发起/投票1参与/匿名统计,2.2.1新增)
│   ├── 留言反馈(反馈转达主人,2.2.1新增)
│   ├── 群聊点赞
│   ├── 图片接口(动漫/游戏/风景)
│   └── 便民查询(热搜/天气/解梦/运势…)
├── 📊 统计排行
│   ├── 发言统计全家桶 / 发言排行
│   ├── 成员去重(查分布/对比/踢重复)
│   ├── 邀请统计 / 邀请排行
│   ├── 群龙王 / 成员信息
│   └── 签到排行 / 连签排行
└── ⏰ 自动化
    ├── 定时任务(每天/工作日/每周/每月)
    ├── 循环消息
    ├── 授权到期提醒
    └── 消息历史(聊天记录 / 查记录)

🧭 学完这套教程你会

  • ✅ 独立安装、绑定、授权机器人

  • ✅ 看懂控制台每一个页面的每个开关

  • ✅ 配置出专属的 AI 女仆 / 管家

  • ✅ 用指令管理群聊的一切

  • ✅ 知道出问题时去哪里排查

共 27 篇 ZL-综合插件知识库 / 快速开始 0 字 0 行 zhangxiaolin
创建 2026-09-22T09:38:27.430039984Z 更新 2026-10-13T08:15:16.500818681Z