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只修改插件内部权限名单,不改变 QQ 群身份
QQ 群管理员上管理员@某人 / 删除管理员@某人真正提升或取消 QQ 群管理员,需要机器人本身是群主

QQ 群管理员指令同时兼容 设置管理员、设置管理、上管理、取消管理员、取消管理、下管理员、下管理 等说法;推荐使用最直观的 上管理员 与 删除管理员。

💡 提示:

  • 主人和插件管理员都可以设置多个QQ,控制台里用逗号、空格或换行分隔都可以

  • 「管理员列表」只显示QQ号

  • 添加/删除前不用写"添加主人+123456"里的加号也可以,+、空格、#、: 都能当分隔符

🏢 出租场景:给租客什么权限?

出租插件给租客时,给「本群副主」即可(群内发 添加副主 QQ号):

✅ 租客(副主)能做❌ 租客不能做
开机 / 关机本群删除授权(仅主人)
群内日常管理(问答、违禁词等)到期提醒/退群/通主三开关(仅主人)
管理本群副主 / 本群管理员名单一键开机 / 一键关机(仅主人)
私聊发 授权 群号 授权码 自助兑换私聊授权管理(授权群/续期群/关闭授权,仅主人)

💡 出租安全闭环 = 本群副主(日常操作)+ 授权码(自助续费),租客全程碰不到授权生死权。

🔒 授权安全:谁能碰授权?

授权是插件的生命线,全部操作锁死在主人级,逐条验证过:

  • 🔒 群内 授权本群 / 取消授权本群 → 仅主人

  • 🔒 私聊 授权群 续期群 关闭授权 / 授权列表 → 整个入口仅主人(非主人私聊只留授权码兑换通道)

  • 🔒 出租系统 删除授权#群号 → 仅主人

  • 🔒 添加插件管理员 / 添加主人 → 仅主人

  • 📖 插件管理员唯一能碰的授权相关操作是 授权查询(只读看剩余天数)

💡 插件管理员无法自我提权:添加插件管理员/主人都要求主人级,所以插件管理员给自己加授权的链条不存在。唯一边界:插件管理员可以 添加群管理员,被加的人获得插件管理员级功能——但授权操作全是主人级,依然加不了授权。


🏠 二、授权机制(插件的地基)

核心规则

未授权的群 = 完全静默,不回复任何消息、不做任何统计和监控,就当机器人不存在。

授权后机器人才能在该群正常工作。授权相关指令:

指令权限说明
授权本群主人给当前群永久授权
授权本群 30天主人授权30天,到期需续期
取消授权本群主人取消当前群授权
开启本群 / 关闭本群管理员临时开关(不开机≠取消授权)
本群授权管理员查看本群授权状态子菜单
查群授权#群号主人/副主查看指定群的授权详情

授权到期提醒(出租场景利器)

控制台 →「授权群组」页底部可配置:

  • 📩 到期通主:到期前 N 天私聊提醒主人续期(默认提前3天)

  • 📢 到期群内提醒:到期前在本群发提醒

  • 🚪 到期自动退群:超过宽限期仍未续期,机器人自动退群

也支持群内指令开关:开到期提醒#群号、关到期退群#群号 等(见出租系统)。


🎫 三、绑定官方群(免费激活)

插件完全免费,但为了防止滥用,需要绑定官方群获取绑定码。

状态说明

状态含义高级功能
🟡 试用中安装后7天内✅ 全部可用
🟢 已绑定输入过有效绑定码✅ 全部可用
🟠 宽限期绑定后机器人退出官方群未超48小时✅ 可用,尽快回群
🔴 受限试用结束未绑定 / 宽限期超48小时❌ 点歌、AI聊天、自定义回复、AI总结被限制

💡 菜单、状态、更新等基础功能永远可用,受限不影响机器人基本运作。

绑定流程

  1. 用机器人以外的QQ(或让群友)加入官方群 327942687

  2. 在官方群内发送「绑定码」

  3. 机器人私聊/回复你一个 8位一次性绑定码(24小时有效,同一QQ 24小时内重复请求返回同一个码)

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

心跳同步

  • 绑定后每 6 小时自动心跳同步一次状态

  • 机器人退出官方群 → 进入 48小时宽限期(私聊提醒主人)

  • 回群后自动恢复,无需重新绑定

  • 打开控制台时会立即触发一次心跳刷新状态


⌨️ 四、指令怎么触发

群聊指令

大多数指令直接发文字就能触发,例如:

菜单
签到
运行状态

分隔符规则

指令和参数之间,+、空格、#、:、| 都可以:

禁言+123456 10分钟    ✅
禁言 123456 10        ✅
授权本群 30天          ✅

@机器人触发(AI相关)

AI 女仆聊天支持两种唤醒方式:

  • @机器人 + 内容:@机器人 今天天气怎么样

  • 前缀触发:#今天天气怎么样(默认前缀 #,可在分群配置改)

💡 图片识别 = 发图片 + @机器人(可带文字提问)

私聊支持

管理员/主人可以私聊机器人执行部分管理指令(如授权、续期群等敏感操作)。


🤐 五、未授权群例外

未授权群虽然完全静默,但以下指令仍会放行(否则你都没法给群授权):

  • 授权本群 / 授权本群+天数(仅主人)

  • 出租系统的授权类指令

其余一切功能(统计、监控、提示、AI、定时任务…)都不会在未授权群执行。


💾 六、配置存储

内容存储位置说明
全局/分群配置config.json控制台修改的内容
问答/违禁词/统计等SQLite 数据库结构化数据
配置生效保存后立即生效⚠️ 改完必须点「保存」

⚠️ 重要:控制台所有修改必须点保存按钮才生效!底部状态栏会显示未保存数量。


🔄 七、插件更新机制

检测更新

  • 自动:打开控制台时静默检查,有新版本只亮右上角 🔔 铃铛,不弹窗打扰

  • 手动:控制台点「检查更新」按钮,或群里发 检测更新

执行更新

  • 控制台内:检查更新弹窗 → 一键更新(带下载进度条)

  • 群内:主人发送 一键更新

更新流程:下载 → SHA256 校验 → 覆盖插件包 → 重载插件。

⚠️ 注意:更新后如果还是旧行为,需要关闭 UniQQ → 清理 Data\PluginRuntime 缓存 → 重新打开。


共 27 篇 ZL-综合插件知识库 / 基础概念与权限体系 0 字 0 行 zhangxiaolin
创建 2026-09-22T09:38:46.217499112Z 更新 2026-10-13T08:12:02.026764135Z