基础概念与权限体系
动手配置之前,先弄清权限等级、授权机制、绑定机制与指令触发规则,后面所有操作都会顺理成章。
🔐 权限等级
v2.2.11 起插件采用三层纯名单制,共 4 个等级,全部按名单判定——谁在名单里,谁就有权限:
| 等级 | 名称 | 是谁 | 能干什么 |
|---|---|---|---|
| 🌟 3 | 全局主人(Owner) | 机器人主人(全局名单) | 一切操作:授权 / 取消授权、添加 / 删除副主、一键更新、出租系统、清空统计 |
| ⭐ 2 | 副主(SubOwner) | 出租模式下的租客负责人,仅主人可添加 | 管理本群机器人:开关机、功能开关、问答、违禁词、名单、定时任务;没有授权 / 取消授权权限 |
| 👮 1 | 群管(GroupAdmin) | 分群名单里的日常帮手,副主及以上可添加 | 日常群管指令(仅本群生效) |
| 👤 0 | 普通成员(Member) | 群友 | 菜单、点歌、签到、AI 聊天等娱乐功能 |
v2.2.11 权限变化(重要)
- QQ 群主 / 群管理员不再自动获得权限:机器人被拉进群后,原群主、管理员不进插件名单就没有任何管理权限,需要主人添加副主或群管。
- 「插件管理员」体系已下线:原全局插件管理员职能并入副主体系,群内发送相关指令会收到下线提示。
- 副主与群管都只对本群生效,跨群互不影响;全局主人对所有群生效。
AI Agent 的权限注入
AI Agent 内置 45 个工具(覆盖插件全部功能),按发言人身份动态注入,权限体系原样生效:
- 普通成员:只能看到签到、点歌、查询等基础工具,管理类工具不会注入;
- 群管 / 副主 / 主人:按等级额外获得问答、违禁词、黑白名单、禁言等管理类工具;
- 危险工具二次确认:踢人、全员禁言、撤回机器人消息、同意 / 拒绝加群申请、设置 / 撤销管理员,执行前先发确认话术,回复「
确认」才真正执行。
管理指令速览
查看主人 / 主人列表 查看全局主人
添加主人+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 聊天、点歌、问答、爬楼对普通群友静默;内容安全与提醒推送停摆;主人功能可用但回复附带绑定提醒 |
菜单、状态、更新等基础功能永远可用,受限不影响机器人基本运作。
绑定流程:
- 用机器人以外的 QQ(或让群友)加入官方群
327942687; - 在官方群内发送「
绑定码」; - 获得 8 位一次性绑定码(24 小时有效,同一 QQ 24 小时内重复请求返回同一个码);
- 打开控制台 → 右上角「设置」→「安全」→ 输入绑定码完成绑定。
心跳同步
绑定后每 6 小时自动心跳同步一次状态;机器人退出官方群进入 48 小时宽限期(私聊提醒主人),回群后自动恢复,无需重新绑定。打开控制台时会立即触发一次心跳刷新状态。
⌨️ 指令触发规则
- 群聊指令:大多数指令直接发文字即可触发,如
菜单、签到、运行状态。 - 分隔符:指令与参数之间的
+、空格、#、:、|均可互换,例如禁言 123456 10与禁言+123456 10分钟等效。 - @机器人触发(AI 相关):聊天女仆、AI 技能、Agent 和图片识别都必须明确
@机器人;主动插话是唯一免 @ 例外,并且需要本群管理员单独开启。 - 私聊支持:管理员 / 主人可私聊机器人执行部分管理指令(如授权、续期群等敏感操作)。
🤐 未授权群的例外
未授权群虽然完全静默,但以下指令仍会放行(否则无法完成授权):
授权本群/授权本群+天数(仅主人);- 出租系统的授权类指令。
其余一切功能(统计、监控、提示、AI、定时任务等)都不会在未授权群执行。
💾 配置存储与更新
| 内容 | 存储位置 | 说明 |
|---|---|---|
| 全局 / 分群配置 | config.json | 控制台修改的内容 |
| 问答 / 违禁词 / 统计等 | SQLite 数据库 | 结构化数据 |
| 配置生效 | 保存后立即生效 | 改完必须点「保存」 |
更新机制:
- 自动检测:打开控制台时静默检查,有新版本只在右上角亮 🔔 铃铛提示,不弹窗打扰;
- 手动检测:控制台点击「检查更新」按钮,或群内发送
检测更新; - 执行更新:控制台内一键更新(带下载进度条),或群内由主人发送
一键更新。流程为:下载 → SHA256 校验 → 覆盖插件包 → 重载插件。
更新后仍是旧行为
插件存在运行时缓存:彻底关闭 UniQQ,清理 Data\PluginRuntime 目录中的旧缓存,再重新启动即可。在插件管理中「停用再启用」无法完全重载插件包。
📚 下一节:控制台页面详解(上)
