> 规范网页：https://docs.tensuu.com/高级功能/权限管理.html ｜ Markdown：/高级功能/权限管理.md ｜ 文档修订：2026.10.26

# 权限管理

这篇帮你做什么：讲清楚机器人怎么判断"某个成员是什么级别、能不能用某条指令、会不会被处罚跳过"，以及每一级在哪里配置。本页是概念说明，不对应单个菜单页面。高风险自动化（周期清退）还有一层单独的"持续授权"，本页一并说清它和等级的关系。

## 先分清五种"权限"

群管家里有五种容易混淆的授权， **各管一段，互相不能代替**：

| 授权 | 管什么 | 从哪来 |
| --- | --- | --- |
| 访问控制台 | 谁能打开管理页面改配置 | 当前控制台 **没有应用层登录**，能打开页面即可操作；请自行保证网络边界（不要直接暴露公网） |
| 聊天指令等级 | 群里 / 私聊发的指令谁能用 | 指令要求等级 ≤ 成员等级；高风险指令另有不可下调的底线 |
| 机器人平台权限 | 机器人能不能执行禁言、踢人、改名片等群操作 | 需要在 QQ 里把机器人设为该群 **管理员**；与控制台、等级无关 |
| 目标保护 | 处罚动作会不会跳过某个目标 | 白名单、代理管理员、群管理员、群主、高管、超级管理员受保护；查不清保护状态时同样不处罚 |
| 持续授权 | 周期清退（不活跃 / 人数控制 / 跨群独占）能否自动执行 | 由名单中的真实超级管理员与机器人 **私聊批准**，见[踢人禁言](../功能模块详解/13_踢人禁言.md)的"批准周期清退" |

典型误区：把人加进白名单（目标保护）**不会**让他能用等级更高的指令；控制台能打开 **不等于** 机器人有平台管理员权限；配置好自动清退 **不等于** 已批准持续授权——未授权时零派发。

## 权限等级是什么

机器人把群成员的"身份"折算成一个 0–11 的权限等级，数字越大权限越高。同一人命中多级时**取最高**：

| 等级 | 名称 | 怎么获得 | 在哪里配置 |
| --- | --- | --- | --- |
| 11 | 超级管理员 | 名单 | [全局设置](../功能模块详解/01_全局设置.md) → 超级管理员列表 |
| 10 | 高管 | 名单 | [全局设置](../功能模块详解/01_全局设置.md) → 高管列表 |
| 9 | 群主 | 群内身份 | 由机器人从 QQ 群同步，无需配置 |
| 8 | 群管理员 | 群内身份 | 由机器人从 QQ 群同步，无需配置 |
| 7 | 代管 | 群级名单 | 群设置 → 基本设置 → 代理管理员 |
| 6 | 白名单 | 名单 | [全局黑白名单](../功能模块详解/06_全局黑白名单.md) 或 [群组黑白名单](../功能模块详解/14_黑白名单.md) |
| 0–5 | 普通成员等 | 预留的成员等级 | 当前控制台没有设置入口，普通成员按 0 级处理 |

指令设置的权限等级使用 **0–11 的数字输入**，不是等级名称下拉框。目前控制台没有给成员赋予 1–5 级的入口，普通成员按 0 级处理。

## 等级决定了什么

**等级 6 及以上是"受保护用户"**：机器人的踢出、禁言等处罚动作会自动跳过他们——包括超级管理员、高管、群主、群管理员、代管和白名单成员。这就是为什么把人加进白名单前要慎重（见[全局黑白名单](../功能模块详解/06_全局黑白名单.md)的说明）。警告动作及其处罚联动扣分也会跳过保护用户；但**成员发言、入群等事件的计分不因此豁免**，仍可能改变信用分，阈值处罚再单独检查目标保护。白名单不是“所有统计和计分都忽略此人”。

**等级决定指令能不能用**：每条指令都有一个"权限等级"要求（0 = 所有人可用，11 = 最高）。成员发送的指令关键词命中后，机器人会先比等级：不足则不执行。等级要求可在 [指令设置](../功能模块详解/04_指令设置.md) 中逐条修改——指令本体（名称、动作、参数）是固定的，可改的只有权限等级、关键词、启停、冷却、优先级和描述这几项。部分高风险指令另有不可下调的权限底线：连接凭据读写及周期"移除授权"要求等级 11，"文本群发"和"未决核实"最低等级 6；调低输入值不能绕过这些限制，后端会按底线校验。满足等级也不等于已经确认操作、批准持续清退或取得机器人平台权限。

**持续授权与等级的关系**：周期清退的执行者（自动化调度）不看等级表，只看对应能力（`inactive` / `population` / `exclusivity`）的授权是否有效。批准入口要求操作者是名单中等级 11 的真实超级管理员，并走机器人私聊确认码流程；控制台里"确认模式选持续授权"只是配置意图，不是批准本身。详见[踢人禁言](../功能模块详解/13_踢人禁言.md)。

## 改动什么时候生效

- 名单和指令的修改**保存后即生效**。系统对名单有几分钟的缓存兜底（时长在[应用设置](../功能模块详解/16_应用设置.md)的缓存配置里，默认约 5 分钟）；极少数情况下可点高级设置页的 **刷新所有缓存** 立即清空。
- 群主/群管理员身份来自 QQ 群同步，成员在 QQ 里被任免后，要等机器人同步到变化才生效。
- 若查询状态时无法确认（比如服务异常），机器人按保守处理：处罚类动作不执行，指令按 0 级处理（大概率不满足要求等级）。

## 常见问题

- **刚加的白名单/高管没生效**：确认点过保存；等缓存过期或手动刷新所有缓存。
- **想让某个成员能用某条指令**：两条路——把该指令的权限等级要求降到对方等级（影响所有人），或把对方加进白名单（对方同时获得处罚豁免，注意副作用）。
- **群主为什么踢不掉**：群主是等级 9，属于受保护用户，机器人不会处罚。
- **控制台要登录吗**：当前控制台没有应用层登录保护，能打开页面即可操作；本手册以"超级管理员"称呼部署和维护应用的读者；群指令中的等级 11 另由名单确定，两者都不代表存在控制台登录账号。
- **指令被执行了但没反应**：可能是权限不足被拒绝（会留下带原因的处理记录），到 [指令设置](../功能模块详解/04_指令设置.md) 核对该指令的等级要求。
- **自动化清退没跑**：先查对应能力的持续授权状态（`移除授权 status <能力>`），再看功能开关和额度；配置齐全但从未私聊批准时零派发，属设计行为。

## 关闭或改回

- 取消某人的等级：从对应名单删除（全局设置、代管名单、黑白名单）。
- 恢复指令的等级要求：在 [指令设置](../功能模块详解/04_指令设置.md) 改回原值；批量调整可用其导入/导出。
- 撤销持续授权：由批准者私聊发送 `移除授权 disable <能力>`，并在控制台关闭对应功能；该指令只撤销本人在该能力下的授权，见[踢人禁言](../功能模块详解/13_踢人禁言.md)。

## 和其他页面的关系

- 各指令的权限等级配置入口在[指令设置](../功能模块详解/04_指令设置.md)。
- 持续授权（周期清退）的批准、核对与撤销步骤在[踢人禁言](../功能模块详解/13_踢人禁言.md)。
- 目标保护的具体范围与"宁可放过"原则见[踢人禁言](../功能模块详解/13_踢人禁言.md)的"开始前确认"。