权限管理(perm_plugin)
让机器人主人(OWNER)直接在聊天框里管理用户权限,无需修改配置文件或重启。
命令触发词
/perm 和 /权限 效果完全相同,任选其一。
不知道从哪开始?
发送以下命令获取帮助或查看插件列表:
/权限 帮助
/权限 插件权限级别
| 级别 | 说明 |
|---|---|
owner | 主人,最高权限,可使用 /权限 命令 |
operator | 管理员,可使用大部分机器人功能 |
user | 普通用户(默认) |
guest | 访客,只能使用最基础的功能 |
前提条件
本命令仅限 OWNER 级别用户使用。在配置 Owner 用户前请勿尝试权限管理指令,否则只会收到「权限不足」提示。
Owner 用户在 config/core.toml 的 [permissions] owner_list 中配置,格式 ['qq:123456789']。
子命令一览
不知道插件名?先发
/权限 插件查看所有已注册插件及其命令名。
| 子命令(英文) | 子命令(中文) | 作用 |
|---|---|---|
status | 查看 | 查看某用户的权限状态 |
set | 设置 | 设置某用户的全局权限级别 |
reset | 重置 | 恢复某用户到默认权限 |
allow | 授权 | 为某用户开放某插件的所有命令 |
deny | 禁止 | 为某用户禁止某插件的所有命令 |
clear | 清除 | 移除对某用户的命令级别覆盖 |
list | 名单 | 查看哪些用户有某插件的权限 |
plugins | 插件 / 插件列表 | 列出所有插件及其命令名 |
help | 帮助 | 显示帮助信息 |
指定用户的两种方式
方式一:直接 @提及(推荐)
在支持 AT 消息的平台(如 QQ)中,直接 @ 对方即可,无需手动输入 ID。
/权限 设置 @张三 operator方式二:手动填写 platform:user_id
适用于无法 @ 到对方的情况:
/权限 设置 qq:1919810 operator使用示例
查看用户权限
/权限 查看 @张三
/perm status qq:1919810提升权限为管理员
/权限 设置 @张三 operator授权某插件
/权限 授权 @张三 greeting_plugin授权所有插件
/权限 授权 @张三 all禁止某插件
/权限 禁止 @张三 web_search_tool清除某插件的授权覆盖
恢复按全局权限判断:
/权限 清除 @张三 greeting_plugin重置全局权限到默认值
/权限 重置 @张三查看谁有某插件权限
/权限 名单 greeting_plugin注意事项
allow/deny是命令级别的强制覆盖,优先级高于全局权限clear只删除覆盖记录,不改变全局权限;reset只删除全局权限记录,不影响命令级覆盖- 使用
all时会对所有已注册命令(除 perm_plugin 自身)批量操作
