权限管理
这篇帮你做什么：讲清楚机器人怎么判断"某个成员是什么级别、能不能用某条指令、会不会被处罚跳过"，以及每一级在哪里配置。本页是概念说明，不对应单个菜单页面。高风险自动化（周期清退）还有一层单独的"持续授权"，本页一并说清它和等级的关系。
先分清五种"权限"
群管家里有五种容易混淆的授权， 各管一段，互相不能代替：
| 授权 | 管什么 | 从哪来 |
|---|---|---|
| 访问控制台 | 谁能打开管理页面改配置 | 当前控制台 没有应用层登录，能打开页面即可操作；请自行保证网络边界（不要直接暴露公网） |
| 聊天指令等级 | 群里 / 私聊发的指令谁能用 | 指令要求等级 ≤ 成员等级；高风险指令另有不可下调的底线 |
| 机器人平台权限 | 机器人能不能执行禁言、踢人、改名片等群操作 | 需要在 QQ 里把机器人设为该群 管理员；与控制台、等级无关 |
| 目标保护 | 处罚动作会不会跳过某个目标 | 白名单、代理管理员、群管理员、群主、高管、超级管理员受保护；查不清保护状态时同样不处罚 |
| 持续授权 | 周期清退（不活跃 / 人数控制 / 跨群独占）能否自动执行 | 由名单中的真实超级管理员与机器人 私聊批准，见踢人禁言的"批准周期清退" |
典型误区：把人加进白名单（目标保护）不会让他能用等级更高的指令；控制台能打开 不等于 机器人有平台管理员权限；配置好自动清退 不等于 已批准持续授权——未授权时零派发。
权限等级是什么
机器人把群成员的"身份"折算成一个 0–11 的权限等级，数字越大权限越高。同一人命中多级时取最高：
| 等级 | 名称 | 怎么获得 | 在哪里配置 |
|---|---|---|---|
| 11 | 超级管理员 | 名单 | 全局设置 → 超级管理员列表 |
| 10 | 高管 | 名单 | 全局设置 → 高管列表 |
| 9 | 群主 | 群内身份 | 由机器人从 QQ 群同步，无需配置 |
| 8 | 群管理员 | 群内身份 | 由机器人从 QQ 群同步，无需配置 |
| 7 | 代管 | 群级名单 | 群设置 → 基本设置 → 代理管理员 |
| 6 | 白名单 | 名单 | 全局黑白名单 或 群组黑白名单 |
| 0–5 | 普通成员等 | 预留的成员等级 | 当前控制台没有设置入口，普通成员按 0 级处理 |
指令设置的权限等级使用 0–11 的数字输入，不是等级名称下拉框。目前控制台没有给成员赋予 1–5 级的入口，普通成员按 0 级处理。
等级决定了什么
等级 6 及以上是"受保护用户"：机器人的踢出、禁言等处罚动作会自动跳过他们——包括超级管理员、高管、群主、群管理员、代管和白名单成员。这就是为什么把人加进白名单前要慎重（见全局黑白名单的说明）。警告动作及其处罚联动扣分也会跳过保护用户；但成员发言、入群等事件的计分不因此豁免，仍可能改变信用分，阈值处罚再单独检查目标保护。白名单不是“所有统计和计分都忽略此人”。
等级决定指令能不能用：每条指令都有一个"权限等级"要求（0 = 所有人可用，11 = 最高）。成员发送的指令关键词命中后，机器人会先比等级：不足则不执行。等级要求可在 指令设置 中逐条修改——指令本体（名称、动作、参数）是固定的，可改的只有权限等级、关键词、启停、冷却、优先级和描述这几项。部分高风险指令另有不可下调的权限底线：连接凭据读写及周期"移除授权"要求等级 11，"文本群发"和"未决核实"最低等级 6；调低输入值不能绕过这些限制，后端会按底线校验。满足等级也不等于已经确认操作、批准持续清退或取得机器人平台权限。
持续授权与等级的关系：周期清退的执行者（自动化调度）不看等级表，只看对应能力（inactive / population / exclusivity）的授权是否有效。批准入口要求操作者是名单中等级 11 的真实超级管理员，并走机器人私聊确认码流程；控制台里"确认模式选持续授权"只是配置意图，不是批准本身。详见踢人禁言。
改动什么时候生效
- 名单和指令的修改保存后即生效。系统对名单有几分钟的缓存兜底（时长在应用设置的缓存配置里，默认约 5 分钟）；极少数情况下可点高级设置页的 刷新所有缓存 立即清空。
- 群主/群管理员身份来自 QQ 群同步，成员在 QQ 里被任免后，要等机器人同步到变化才生效。
- 若查询状态时无法确认（比如服务异常），机器人按保守处理：处罚类动作不执行，指令按 0 级处理（大概率不满足要求等级）。
常见问题
- 刚加的白名单/高管没生效：确认点过保存；等缓存过期或手动刷新所有缓存。
- 想让某个成员能用某条指令：两条路——把该指令的权限等级要求降到对方等级（影响所有人），或把对方加进白名单（对方同时获得处罚豁免，注意副作用）。
- 群主为什么踢不掉：群主是等级 9，属于受保护用户，机器人不会处罚。
- 控制台要登录吗：当前控制台没有应用层登录保护，能打开页面即可操作；本手册以"超级管理员"称呼部署和维护应用的读者；群指令中的等级 11 另由名单确定，两者都不代表存在控制台登录账号。
- 指令被执行了但没反应：可能是权限不足被拒绝（会留下带原因的处理记录），到 指令设置 核对该指令的等级要求。
- 自动化清退没跑：先查对应能力的持续授权状态（
移除授权 status <能力>），再看功能开关和额度；配置齐全但从未私聊批准时零派发，属设计行为。
关闭或改回
- 取消某人的等级：从对应名单删除（全局设置、代管名单、黑白名单）。
- 恢复指令的等级要求：在 指令设置 改回原值；批量调整可用其导入/导出。
- 撤销持续授权：由批准者私聊发送
移除授权 disable <能力>，并在控制台关闭对应功能；该指令只撤销本人在该能力下的授权，见踢人禁言。