Skip to content

权限管理(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 自身)批量操作

贡献者

The avatar of contributor named as micraft1024a micraft1024a

页面历史

Released under the GPL-3.0 License.