Skip to content

基础概念与权限体系 ​

动手配置之前,先弄清权限等级、授权机制、绑定机制与指令触发规则,后面所有操作都会顺理成章。

🔐 权限等级 ​

v2.2.11 起插件采用三层纯名单制,共 4 个等级,全部按名单判定——谁在名单里,谁就有权限:

等级名称是谁能干什么
🌟 3全局主人(Owner)机器人主人(全局名单)一切操作:授权 / 取消授权、添加 / 删除副主、一键更新、出租系统、清空统计
⭐ 2副主(SubOwner)出租模式下的租客负责人,仅主人可添加管理本群机器人:开关机、功能开关、问答、违禁词、名单、定时任务;没有授权 / 取消授权权限
👮 1群管(GroupAdmin)分群名单里的日常帮手,副主及以上可添加日常群管指令(仅本群生效)
👤 0普通成员(Member)群友菜单、点歌、签到、AI 聊天等娱乐功能

v2.2.11 权限变化(重要)

  • QQ 群主 / 群管理员不再自动获得权限:机器人被拉进群后,原群主、管理员不进插件名单就没有任何管理权限,需要主人添加副主或群管。
  • 「插件管理员」体系已下线:原全局插件管理员职能并入副主体系,群内发送相关指令会收到下线提示。
  • 副主与群管都只对本群生效,跨群互不影响;全局主人对所有群生效。

AI Agent 的权限注入 ​

AI Agent 内置 45 个工具(覆盖插件全部功能),按发言人身份动态注入,权限体系原样生效:

  • 普通成员:只能看到签到、点歌、查询等基础工具,管理类工具不会注入;
  • 群管 / 副主 / 主人:按等级额外获得问答、违禁词、黑白名单、禁言等管理类工具;
  • 危险工具二次确认:踢人、全员禁言、撤回机器人消息、同意 / 拒绝加群申请、设置 / 撤销管理员,执行前先发确认话术,回复「确认」才真正执行。

管理指令速览 ​

text
查看主人 / 主人列表                              查看全局主人
添加主人+QQ / 删除主人+QQ                        仅主人可用
添加副主#群号#QQ / 删除副主#群号#QQ               仅主人可用(出租模式)
添加群管理员+QQ / 删除群管理员+QQ                 副主及以上可用
管理员列表 / 群管理员列表                          查看名单

全局主人、各群副主与群管均可设置多个 QQ,控制台分群配置里用逗号分隔。

插件权限与 QQ 群身份完全独立 ​

目标指令实际作用
插件群管添加群管理员+QQ / 删除群管理员+QQ只修改插件内部权限名单,不改变 QQ 群身份
QQ 群管理员上管理员@某人 / 删除管理员@某人真正提升或取消 QQ 群管理员,需机器人本身是群主

QQ 群管理员指令兼容 设置管理员、取消管理员、上管理、下管理 等别名,推荐使用 上管理员 与 删除管理员。注意:成为 QQ 群主或群管理员不会自动获得插件权限。

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

授权是插件的生命线,全部修改操作锁死在主人级:

  • 群内 授权本群 / 取消授权本群 → 仅主人;
  • 私聊 授权群 / 续期群 / 关闭授权 / 授权列表 → 整个入口仅主人(非主人私聊只保留授权码兑换通道);
  • 出租系统 删除授权#群号 → 仅主人;
  • 添加副主#群号#QQ / 添加主人 → 仅主人。

副主唯一能执行的授权相关操作是只读的 查群授权#群号(查看本群剩余天数),无法授权、取消授权,也无法自我提权——添加副主 / 主人都要求主人级,给自己加授权的链条不存在。

🏠 授权机制 ​

核心规则:未授权的群 = 完全静默,不回复任何消息、不做任何统计和监控,等同于机器人不存在。

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

到期提醒与处置(出租场景利器)

在控制台「群授权到期提醒(出租模式)」弹窗中可配置:

  • 私聊提醒:启用到期私聊提醒、提前提醒天数(默认 3 天)、提醒消息模板(支持 [群名]、[群号]、[剩余天数]、[到期时间] 变量);
  • 通知对象:本群副主默认会收到;可再填「自定义通知QQ」(多个逗号分隔);「通知插件主人」全局开关关闭后仅通知副主和自定义 QQ;
  • 到期自动处置(全局):可选无操作(默认,只提醒)/ 退群(到期立即退或延迟 N 天再退)/ 关机静默(该群静默不响应,授权记录保留,续期后自动恢复开机)。

群内也可用指令 开到期提醒#群号、关到期退群#群号 等开关。

🎫 绑定与激活 ​

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

状态含义高级功能
🟡 试用中安装后 3 天内✅ 全部可用
🟢 已绑定输入过有效绑定码✅ 全部可用
🟠 宽限期机器人退出官方群未超 48 小时✅ 可用,请尽快回群
🔴 受限试用结束未绑定 / 宽限期超 48 小时❌ AI 聊天、点歌、问答、爬楼对普通群友静默;内容安全与提醒推送停摆;主人功能可用但回复附带绑定提醒

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

绑定流程:

  1. 用机器人以外的 QQ(或让群友)加入官方群 327942687;
  2. 在官方群内发送「绑定码」;
  3. 获得 8 位一次性绑定码(24 小时有效,同一 QQ 24 小时内重复请求返回同一个码);
  4. 打开控制台 → 右上角「设置」→「安全」→ 输入绑定码完成绑定。

心跳同步

绑定后每 6 小时自动心跳同步一次状态;机器人退出官方群进入 48 小时宽限期(私聊提醒主人),回群后自动恢复,无需重新绑定。打开控制台时会立即触发一次心跳刷新状态。

⌨️ 指令触发规则 ​

  • 群聊指令:大多数指令直接发文字即可触发,如 菜单、签到、运行状态。
  • 分隔符:指令与参数之间的 +、空格、#、:、| 均可互换,例如 禁言 123456 10 与 禁言+123456 10分钟 等效。
  • @机器人触发(AI 相关):聊天女仆、AI 技能、Agent 和图片识别都必须明确 @机器人;主动插话是唯一免 @ 例外,并且需要本群管理员单独开启。
  • 私聊支持:管理员 / 主人可私聊机器人执行部分管理指令(如授权、续期群等敏感操作)。

🤐 未授权群的例外 ​

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

  • 授权本群 / 授权本群+天数(仅主人);
  • 出租系统的授权类指令。

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

💾 配置存储与更新 ​

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

更新机制:

  • 自动检测:打开控制台时静默检查,有新版本只在右上角亮 🔔 铃铛提示,不弹窗打扰;
  • 手动检测:控制台点击「检查更新」按钮,或群内发送 检测更新;
  • 执行更新:控制台内一键更新(带下载进度条),或群内由主人发送 一键更新。流程为:下载 → SHA256 校验 → 覆盖插件包 → 重载插件。

更新后仍是旧行为

插件存在运行时缓存:彻底关闭 UniQQ,清理 Data\PluginRuntime 目录中的旧缓存,再重新启动即可。在插件管理中「停用再启用」无法完全重载插件包。


📚 下一节:控制台页面详解(上)

薇薇官机平台 · ZL 系列插件