01 · 基础概念与权限体系
适用版本:ZL-综合插件 2.1.2(2026-10-08 校准) 在动手配置之前,先搞懂这几个概念,后面所有操作都会顺理成章。
🔐 一、权限等级(从高到低)
插件把使用者分成 6 个等级,不同等级能用的指令不同:
| 等级 | 名称 | 是谁 | 能干什么 |
|---|---|---|---|
| 🌟 5 | 全局主人(Owner) | 你自己(机器人主人) | 一切操作:授权群、管理管理员、一键更新、出租系统、清空统计 |
| 🛡️ 4 | 插件管理员(PluginAdmin) | 你信任的帮手 | 大部分管理操作:问答、违禁词、黑白名单、重置签到、清空统计 |
| 🏢 4 | 本群副主(SubOwner) | 出租模式下租客方的负责人 | 与插件管理员同档 + 开机/关机本群(按群隔离) |
| 🔧 4 | 本群管理员(Admins) | 分群名单里的帮手 | 与插件管理员同档(仅本群生效) |
| 👑 3 | 群主(GroupOwner) | QQ群本身的主人 | 群级管理指令(受群配置影响) |
| 🔧 2 | 群管理员(GroupAdmin) | QQ群的群管 | 部分群管指令(禁言、踢出等,取决于配置) |
| 👤 1 | 普通成员(Member) | 群友 | 菜单、点歌、签到、AI聊天等娱乐功能 |
⚠️ 注意:全局插件管理员、本群副主、本群管理员属于同一档(PluginAdmin 级),只是名单来源不同。 ⚠️ 纯 QQ 群主(没进插件任何名单)等级低于插件管理员——例如
添加问答要求插件管理员级,纯 QQ 群主反而用不了。
🤖 AI Agent 工具按权限动态注入
2.1.1 起 AI Agent 内置 45 个工具(覆盖插件全部功能),会按发言人身份动态注入,权限体系原样生效:
👤 普通成员:只能看到签到、点歌、查询等基础工具,管理类工具根本不会注入
🛡️ 主人/管理员:额外获得问答、违禁词、黑白名单、禁言等管理类工具
⚠️ 危险工具二次确认:踢人、全员禁言、撤回机器人消息、同意/拒绝加群申请、设置/撤销管理员,执行前会先发确认话术,回复「确认」才真正执行
管理指令速览
插件权限与 QQ 群身份不要混用
这两组指令作用完全不同:
| 目标 | 指令 | 实际作用 |
|---|---|---|
| 插件本群管理员 | 添加群管理员+QQ / 删除群管理员+QQ | 只修改插件内部权限名单,不改变 QQ 群身份 |
| QQ 群管理员 | 上管理员@某人 / 删除管理员@某人 | 真正提升或取消 QQ 群管理员,需要机器人本身是群主 |
QQ 群管理员指令同时兼容 设置管理员、设置管理、上管理、取消管理员、取消管理、下管理员、下管理 等说法;推荐使用最直观的 上管理员 与 删除管理员。
💡 提示:
主人和插件管理员都可以设置多个QQ,控制台里用逗号、空格或换行分隔都可以
「管理员列表」只显示QQ号
添加/删除前不用写"添加主人+123456"里的加号也可以,
+、空格、#、:都能当分隔符
🏢 出租场景:给租客什么权限?
出租插件给租客时,给「本群副主」即可(群内发 添加副主 QQ号):
| ✅ 租客(副主)能做 | ❌ 租客不能做 |
|---|---|
| 开机 / 关机本群 | 删除授权(仅主人) |
| 群内日常管理(问答、违禁词等) | 到期提醒/退群/通主三开关(仅主人) |
| 管理本群副主 / 本群管理员名单 | 一键开机 / 一键关机(仅主人) |
私聊发 授权 群号 授权码 自助兑换 | 私聊授权管理(授权群/续期群/关闭授权,仅主人) |
💡 出租安全闭环 = 本群副主(日常操作)+ 授权码(自助续费),租客全程碰不到授权生死权。
🔒 授权安全:谁能碰授权?
授权是插件的生命线,全部操作锁死在主人级,逐条验证过:
🔒 群内
授权本群/取消授权本群→ 仅主人🔒 私聊
授权群续期群关闭授权/授权列表→ 整个入口仅主人(非主人私聊只留授权码兑换通道)🔒 出租系统
删除授权#群号→ 仅主人🔒
添加插件管理员/添加主人→ 仅主人📖 插件管理员唯一能碰的授权相关操作是
授权查询(只读看剩余天数)
💡 插件管理员无法自我提权:添加插件管理员/主人都要求主人级,所以插件管理员给自己加授权的链条不存在。唯一边界:插件管理员可以
添加群管理员,被加的人获得插件管理员级功能——但授权操作全是主人级,依然加不了授权。
🏠 二、授权机制(插件的地基)
核心规则
未授权的群 = 完全静默,不回复任何消息、不做任何统计和监控,就当机器人不存在。
授权后机器人才能在该群正常工作。授权相关指令:
| 指令 | 权限 | 说明 |
|---|---|---|
授权本群 | 主人 | 给当前群永久授权 |
授权本群 30天 | 主人 | 授权30天,到期需续期 |
取消授权本群 | 主人 | 取消当前群授权 |
开启本群 / 关闭本群 | 管理员 | 临时开关(不开机≠取消授权) |
本群授权 | 管理员 | 查看本群授权状态子菜单 |
查群授权#群号 | 主人/副主 | 查看指定群的授权详情 |
授权到期提醒(出租场景利器)
控制台 →「授权群组」页底部可配置:
📩 到期通主:到期前 N 天私聊提醒主人续期(默认提前3天)
📢 到期群内提醒:到期前在本群发提醒
🚪 到期自动退群:超过宽限期仍未续期,机器人自动退群
也支持群内指令开关:开到期提醒#群号、关到期退群#群号 等(见出租系统)。
🎫 三、绑定官方群(免费激活)
插件完全免费,但为了防止滥用,需要绑定官方群获取绑定码。
状态说明
| 状态 | 含义 | 高级功能 |
|---|---|---|
| 🟡 试用中 | 安装后7天内 | ✅ 全部可用 |
| 🟢 已绑定 | 输入过有效绑定码 | ✅ 全部可用 |
| 🟠 宽限期 | 绑定后机器人退出官方群未超48小时 | ✅ 可用,尽快回群 |
| 🔴 受限 | 试用结束未绑定 / 宽限期超48小时 | ❌ 点歌、AI聊天、自定义回复、AI总结被限制 |
💡 菜单、状态、更新等基础功能永远可用,受限不影响机器人基本运作。
绑定流程
用机器人以外的QQ(或让群友)加入官方群
327942687在官方群内发送「绑定码」
机器人私聊/回复你一个 8位一次性绑定码(24小时有效,同一QQ 24小时内重复请求返回同一个码)
打开控制台 → 右上角「设置」→「安全」→ 输入绑定码 → 绑定成功 ✅
心跳同步
绑定后每 6 小时自动心跳同步一次状态
机器人退出官方群 → 进入 48小时宽限期(私聊提醒主人)
回群后自动恢复,无需重新绑定
打开控制台时会立即触发一次心跳刷新状态
⌨️ 四、指令怎么触发
群聊指令
大多数指令直接发文字就能触发,例如:
分隔符规则
指令和参数之间,+、空格、#、:、| 都可以:
@机器人触发(AI相关)
AI 女仆聊天支持两种唤醒方式:
@机器人 + 内容:
@机器人 今天天气怎么样前缀触发:
#今天天气怎么样(默认前缀#,可在分群配置改)
💡 图片识别 = 发图片 + @机器人(可带文字提问)
私聊支持
管理员/主人可以私聊机器人执行部分管理指令(如授权、续期群等敏感操作)。
🤐 五、未授权群例外
未授权群虽然完全静默,但以下指令仍会放行(否则你都没法给群授权):
授权本群/授权本群+天数(仅主人)出租系统的授权类指令
其余一切功能(统计、监控、提示、AI、定时任务…)都不会在未授权群执行。
💾 六、配置存储
| 内容 | 存储位置 | 说明 |
|---|---|---|
| 全局/分群配置 | config.json | 控制台修改的内容 |
| 问答/违禁词/统计等 | SQLite 数据库 | 结构化数据 |
| 配置生效 | 保存后立即生效 | ⚠️ 改完必须点「保存」 |
⚠️ 重要:控制台所有修改必须点保存按钮才生效!底部状态栏会显示未保存数量。
🔄 七、插件更新机制
检测更新
自动:打开控制台时静默检查,有新版本只亮右上角 🔔 铃铛,不弹窗打扰
手动:控制台点「检查更新」按钮,或群里发
检测更新
执行更新
控制台内:检查更新弹窗 → 一键更新(带下载进度条)
群内:主人发送
一键更新
更新流程:下载 → SHA256 校验 → 覆盖插件包 → 重载插件。
⚠️ 注意:更新后如果还是旧行为,需要关闭 UniQQ → 清理
Data\PluginRuntime缓存 → 重新打开。