完整使用手册
本篇是全插件的浓缩总览:基本信息、设计原则、安装绑定、控制台结构、各功能模块要点与权限体系。各模块的详细操作请参阅对应分篇教程。
📇 插件基本信息
| 项目 | 内容 |
|---|---|
| 插件名称 | ZL-综合插件 |
| 插件 ID | XiaoLin.ZLComprehensivePlugin |
| 作者 | 小林(QQ 939921104) |
| 官方群 | 327942687 |
| 官网 / 下载 | https://blog.zxiaolin.com |
| 适用框架 | UniQQ(建议 1.1.0.1 及以上) |
| 运行环境 | Windows,.NET 运行时,需 WebView2 |
| 插件类型 | 综合群管与自动回复插件 |
| 收费模式 | 完全免费,授权群数量与成员数量均无上限 |
查看当前版本:控制台「设置 → 维护」,或群内发送 运行状态。
🎯 设计原则
| 原则 | 具体表现 |
|---|---|
| 一站式 | 菜单指令、问答、知识库、违禁词、定时任务、名单管理、入群审核、验证码、刷屏检测、AI 全部内置,无需再装其他插件 |
| 可视化 | 全部功能通过网页控制台配置,所见即所得,改完保存立即生效 |
| 分群化 | 每个群可拥有完全独立的配置,一套插件管理多个风格不同的群 |
| 实时化 | 首页数据(消息量、指令量、日志、好友数)每秒实时刷新 |
| 多号友好 | 支持多机器人「1 群 1 管理」,每群指定归属号,其余号完全静默 |
📦 下载与安装
- 从官方直链下载插件包:https://i.zxiaolin.com/zl-plugin/XiaoLin.ZLComprehensivePlugin.uniqq(请只从官方渠道下载,谨防二次打包);
- 放入 UniQQ 的
Plugins目录,重启 UniQQ 并在插件管理中启用; - 点插件「设置」按钮打开控制台窗口。
免费绑定:安装后提供 3 天全功能试用期。试用期结束后,AI 聊天、点歌、自定义问答、AI 爬楼总结对普通群友完全静默;主人的功能指令照常可用,但回复末尾附带绑定提醒;内容安全与提醒推送同步停摆(菜单、状态等基础功能不受影响)。
绑定方法:加入官方群 327942687 → 群内发送「绑定码」获取一次性绑定码(24 小时有效)→ 控制台右上角「设置 → 安全」输入绑定码完成绑定。绑定完全免费,任何收费授权均为骗子。
🚀 五分钟上手
- 打开控制台:UniQQ 插件列表 → ZL-综合插件 →「设置」;
- 确认主人 QQ:「全局配置 → 全局主人」填自己的 QQ(默认为作者 QQ,务必修改);
- 开启总开关:确认「启用插件总开关」已打开(默认开启);
- 完成绑定:按上文方法获取并填入绑定码(也可先用试用期体验);
- 给群授权:「授权群组 → 授权新群」,或群里发
授权本群(仅主人); - 验收:在已授权的群里发送
菜单,机器人回复完整菜单即安装成功。
任何配置改完都要点「保存」(或按 Ctrl + S),保存后立即生效,无需重启框架。
🖥️ 控制台结构
左侧导航共 6 个分组、26 个页面:
| 分组 | 页面 |
|---|---|
| — | 首页(数据看板与快捷操作) |
| 基础设置 | 全局配置、授权群组、分群配置、官方协作 |
| 消息互动 | 菜单指令、问答管理、知识库、长期记忆、定时任务 |
| 安全防护 | 黑白名单、违禁词汇、内容安全、成员比对、针对系统 |
| 扩展玩法 | AI 中心、文字转图片、金币玩法 |
| 提醒服务 | 邮件提醒、异常告警、关键词预警、生日纪念、日程提醒、留言反馈 |
| 其他 | 使用帮助、关于插件 |
- 底部状态栏:服务状态、插件版本、框架、设备码、未保存修改提示;
- 右上角设置弹窗:🔒 安全(绑定与设备码)、🎛️ 行为(指令前缀、小尾巴等快捷项)、🎨 外观(公告栏与自动检查更新)、🧰 维护(版本与检查更新)。
🧩 功能模块速览
| 模块 | 要点 |
|---|---|
| 菜单指令 | 关键词 → 固定回复,支持官机 Markdown 卡片,与普通文本独立保存 |
| 问答管理 | 精确 / 模糊 / 正则三种匹配,多答案随机,支持变量与 CQ 码 |
| 知识库与长期记忆 | 内置 42 条功能知识,AI 回答用法类问题前强制检索;长期记忆每范围 100 条 |
| 定时任务 | 每天 / 工作日 / 每周几 / 每月 N 日;类型含发消息、AI 群聊总结、群禁言 / 解禁;睡眠错过 30 分钟内自动补跑 |
| 黑白名单 | 白名单豁免检测,黑名单禁用插件,支持退群 / 被踢自动拉黑 |
| 违禁词汇 | 支持正则词库,警告 / 撤回 / 禁言 / 踢出四档处置可组合 |
| 内容安全(AI 审核) | 候选提取 → AI 精判 → 延迟复核 / 处罚前二次确认,低误伤优先 |
| AI 中心 | AI 服务、五套人设、技能系统与 Agent 智能助手(45 个内置工具) |
| 文字转图片 | 纯文字回复本地渲染卡片图,失败自动回退文字 |
| 金币玩法 | 抢金币与奴隶系统,使用每日签到产生的钱包 |
| 提醒服务 | 邮件 / 告警 / 预警 / 生日 / 日程 / 留言反馈六个页面 |
| 官方协作 | 官机管「说话」、普通机器人管「执行」 |
| 多机器人认领 | 每群一个归属号,其余号静默 |
各模块的群内指令与控制台操作,详见「控制台页面详解(上 / 下)」「指令大全」等篇章。
🔑 权限等级体系
v2.2.11 起为三层纯名单制,全部按名单判定:
text
成员 < 群管(名单) < 副主(名单) < 主人| 等级 | 获得方式 | 典型权限 |
|---|---|---|
| 成员 | 所有人 | 菜单、问答、娱乐指令、各类列表查询 |
| 群管 | 副主及以上 添加群管理员 或控制台分群配置填写 | 日常群管指令:名单管理、本群问答 / 违禁词、撤回与检测 |
| 副主 | 仅主人 添加副主#群号#QQ 或控制台分群配置填写 | 开关本群、功能开关、定时任务、问答 / 违禁词;无授权 / 取消授权权限 |
| 主人 | 「全局主人」中填写 | 一切权限:授权群、添加 / 删除副主、跨群控制 |
- AI Agent 工具按发言人权限动态注入,普通成员拿不到管理类工具;
- QQ 群主 / 群管理员身份不再自动获得插件权限,不进名单就没有管理权限;
- 「插件管理员」体系已下线,相关指令会提示改用副主;
- 出租场景给租客「副主」即可让其自助管理本群,授权与主人名单仍由你掌控。
📮 售后与联系
| 项目 | 信息 |
|---|---|
| 作者 | 小林(QQ 939921104) |
| 官方群 | 327942687(反馈请附插件版本、控制台日志截图、复现步骤) |
| 官网 / 帮助文档 | https://blog.zxiaolin.com |
防骗提醒
本插件完全免费,绑定也免费。任何以「低价授权」「付费激活」为名的收费均为骗子,请注意甄别。各类 QQ 机器人插件可联系作者定制开发。
📚 下一节:热榜与60秒
