Skip to content

超级用户核心命令帮助

多羅狼 edited this page Nov 15, 2024 · 6 revisions

这些模块命令不会在机器人的模块帮助文档中显示,有需要的用户须自行查询。

abuse

  • 别名:ae

此模块用于管理滥用警告。

abuse check

  • 用法:~abuse check <用户 ID>

此命令可以检查用户的警告次数,以及是否被封禁。

abuse warn

  • 用法:~abuse warn <用户 ID> [<警告次数>]

此命令可以添加用户的滥用警告次数。

abuse revoke

  • 用法:~abuse revoke <用户 ID> [<警告次数>]

此命令可以移除用户的滥用警告次数。

abuse clear

  • 用法:~abuse clear <用户 ID>

此命令可以清除用户的滥用警告次数。

abuse untempban

  • 用法:~abuse untempban <用户 ID>

此命令可以解除用户的临时封禁。

abuse ban

  • 用法:~abuse ban <用户 ID>

此命令可以对用户进行封禁。

abuse unban

  • 用法:~abuse unban <用户 ID>

此命令可以解除用户的封禁。

abuse block

  • 仅 QQ
  • 用法:~abuse block <会话 ID>

此命令可以将 QQ 群聊加入黑名单。

机器人若检测到处于黑名单的群聊将会自动退出。

abuse unblock

  • 仅 QQ
  • 用法:~abuse unblock <会话 ID>

此命令可以将 QQ 群聊移除黑名单。

analytics

  • 别名:ana

此模块用于查看机器人已执行的命令次数。

可在配置文件中修改参数决定是否启用。

analytics

  • 用法:~analytics

此命令可以查看机器人已执行的命令次数。

analytics days

  • 用法:~analytics days [<模块>]

此命令可以查看机器人最近 30 天的模块命令调用次数统计,模块参数留空则统计所有模块。

analytics year

  • 用法:~analytics year [<模块>]

此命令可以查看机器人最近一年的模块命令调用次数统计,模块参数留空则统计所有模块。

analytics modules

  • 用法:~analytics modules [<模块数>]

此命令可以查看机器人所有模块的命令调用数量,并将其进行排序,模块数参数留空则统计前 30 个模块。

config

  • 别名:cfg

此模块可以操作机器人的配置文件。

config get

  • 用法:~config get <属性>

此命令可以查看配置信息。

config write

  • 用法:~config write <属性> <值> [-s]
  • 选项:
    • -s:将配置信息添加到 secret 类。

此命令可以添加配置信息。

config delete

  • 用法:~config delete <属性>

此命令可以移除配置信息。

echo

此模块可以重复消息。

echo

  • 用法:~echo <消息>

此命令可以重复消息。

say

  • 用法:~say <消息>

此命令可以重复消息,但不进行回复。

eval

此模块用于返回传入字符串的表达式的结果。相当于 eval() 函数。

可在配置文件中修改参数决定是否启用。

eval

  • 用法:~eval <字符串>

此命令可以把字符串当成有效表达式,并返回对应结果。

支持 MessageSession 类表达式方法,可使用 msg 实现。

Note

返回的结果示例:

>>> ~eval 2+2
<<< 4
>>> ~eval pow(2,3)
<<< 8
>>> ~eval sum([1,2,3])
<<< 6
>>> ~eval msg.locale.t(\'example\')
<<< 你好世界!

exit

此模块可以退出控制台。

exit

  • 仅控制台
  • 用法:~exit

此命令可以正常退出控制台。

forward_msg

此模块可以切换是否启用转发消息。

forward_msg

  • 仅 QQ
  • 用法:~forward_msg

此命令可以切换是否启用转发消息。

petal

  • 别名:petals

此模块可以获取用户的花瓣数量。

petal

  • 用法:~petal [<用户 ID>]

此命令可以获取用户的花瓣数量,用户 ID 为空则查看操作者自己的花瓣数量。

petal modify

  • 用法:~petal modify <数量> [<用户 ID>]

此命令可以修改用户的花瓣数量,用户 ID 为空则修改操作者自己的花瓣数量。

petal clear

  • 用法:~petal clear [<用户 ID>]

此命令可以清除用户的花瓣数量,用户 ID 为空则清除操作者自己的花瓣数量。

post

此模块可以推送客户端全局消息。

请勿频繁使用此命令,否则可能会导致用户造成困扰以及机器人被风控。

post

  • 用法:~post <会话 ID> <推送消息>

此命令可以向客户端内特定会话推送消息。

post global

  • 用法:~post global <推送消息>

此命令可以向客户端内所有会话推送消息。

post_whitelist

此模块可以设置 QQ 群聊的推送白名单。

post_whitelist

  • 仅 QQ
  • 用法:~post_whitelist <群聊 ID>

此命令可以设置 QQ 群聊的推送白名单。

推送白名单内的群聊将会更快地收到推送消息。

purge

此模块可以清除机器人缓存。

purge

  • 用法:~purge

此命令可以清除缓存目录下的所有缓存文件。

raise

此模块可以抛出测试异常用来测试。

raise

  • 用法:~raise

此命令可以抛出 TestException 异常。

restart

此模块可以更新或重启机器人。

restart

  • 用法:~restart

此命令可以重启机器人。

update

  • 用法:~update

此命令可以从 GitHub 拉取机器人新版本并更新。

update&restart

  • 别名:u&r
  • 用法:~update&restart

此命令可以从 GitHub 拉取机器人新版本并更新,之后重启机器人。

resume

  • 仅 QQ

此模块用于重发消息。

resume

  • 用法:~resume

此命令可以重发消息。

有时候,由于 QQ 的风控问题,导致机器人无法正常发送消息,使用此命令可以重发这些消息。

resume clear

  • 用法:~resume clear

此命令可以清除所有需要重发的消息。

resume continue

  • 用法:~resume continue

此命令可以重发所有需要重发的消息。

set

此模块可以查看并操作会话的模块与设置情况。

set module enable

  • 用法:~set module enable <会话 ID> <模块1> [<模块2>...]

此命令可以为会话开启模块。

set module disable

  • 用法:~set module disable <会话 ID> <模块1> [<模块2>...]

此命令可以为会话关闭模块。

set module list

  • 用法:~set module list <会话 ID>

此命令可以查看会话已开启的模块列表。

set option get

  • 用法:~set option get <会话 ID> [<键名>]

此命令可以查看会话的设置,键名为空则查看所有设置。

set option edit

  • 用法:~set option edit <会话 ID> <键名> <值>

此命令可以修改会话的设置。

set option delete

  • 用法:~set option delete <会话 ID> <键名>

此命令可以移除会话的设置。

superuser

  • 别名:su

此模块可以设置机器人超级用户。

superuser add

  • 用法:~superuser add <用户 ID>

此命令可以添加机器人超级用户。

superuser remove

  • 用法:~superuser remove <用户 ID>

此命令可以移除机器人超级用户。