Skip to content

管理指令

TIP

DicerGirl的管理员权限所有体系与Nonebot2的管理员(SUPERUSER)不同,它独立于Nonebot2存在。我们将会在下个版本中对接 Infini 标准,当前仍然采用 DicerGirl 原生管理系统。

骰娘管理指令是用于处理骰娘与世界主或骰主之间业务的指令体系,包括鉴权系统、权限隔离等。

此文档中所提到的所有别名指令与原指令完全等效。

.sudo指令

别名: .su

该指令用于进行管理员鉴权,使得用户获得骰娘的管理员权限。

你可以简单的执行裸指令来发起一次管理员鉴权:

bash
.sudo

指令发送后,鉴权令牌会在Nonebot2的控制终端输出,输出模式为CRITICAL。鉴权令牌应当是类似这样的:

txt
7d571ca69a4711ee8c7b01ee66fa82b19312fb83fba049b39e351a51a5a01b98

将鉴权令牌完整复制之后,执行以下指令:

txt
.sudo 7d571ca69a4711ee8c7b01ee66fa82b19312fb83fba049b39e351a51a5a01b98

骰娘将会回复:

bash
[用户]你成功取得了管理员权限.

注意,如果多个鉴权请求同时被发起,那么将只有较晚的鉴权请求会被保留,其它的请求会话会被释放。DicerGirl 鉴权令牌使用uuid1uuid4算法生成,它可以保证不会出现令牌的唯一性和安全性。

.dismiss指令

用法

.dismiss

它是指令.bot exit的别名。

参考:.bot指令 > exit选项

.bot指令

用法

.bot <指令> [参数]

该指令用于执行与管理插件和机器人设置相关的各种任务。裸指令将会输出机器人相关信息。

version选项

别名

v, bot, 版本

显示机器人版本。

示例

bash
.bot version

exit选项

TIP

.bot exit为了兼容其它现有骰系,特别新增了.dismiss为其别名。.dismiss.bot exit是等效的。

别名:bye, leave, 离开

要求机器人退出群聊。为了适配 QQ 平台第三方协议时保证机器人的账号安全,.bot exit没有权限要求,任何用户均可以要求骰娘离开群聊。

WARNING

该指令在 QQ 适配器下无效。

on选项

别名:run, start, 启动

关闭指令限制状态并使得机器人进入活跃状态。

off选项

别名:down, shutdown, 关闭

WARNING

该指令对与DicerGirl同级安装的其它插件无效。

开启机器人指令限制,除管理指令外,机器人不再响应任何指令。

upgrade选项

别名:up, 更新

要求机器人自动升级。

downgrade选项

别名:降级

用法:.bot downgrade [版本号]

WARNING

强烈不建议使用!你的 DicerGirl 在版本回退后可能无法再次还原,甚至可能遇到不可挽回的问题!

我们强烈建议使你的 DicerGirl 保持最新的版本。

将机器人降级到特定版本。

name 选项

别名:命名

用法:.bot name [名称]

为你的骰娘命名。

status选项

别名:状态

显示机器人当前运行状态。

plgup选项

DEPRECATED

将在下一个版本被.dpm指令替代。

别名:pluginup, 升级

用法:.bot plgup <插件名>

升级特定插件。

install选项

DEPRECATED

将在下一个版本被.dpm指令替代。

别名:add, 安装

用法:.bot install <插件名>

安装新的插件。

remove选项

DEPRECATED

将在下一个版本被.dpm指令替代。

别名:del, rm, 删除, 卸载

用法:.bot install <插件名>

删除已安装的插件。

mode选项

别名:list, 已安装

列出已安装的插件。

store选项

DEPRECATED

将在下一个版本被.dpm指令替代。

别名:plugins, 商店

显示商店中可用的插件。