# QQ机器人使用方法

此篇文章介绍QQ机器人的使用方法，以下内容以Mirai插件为例

# 配置文件

配置文件使用Yaml格式，默认内容如下

expression: '^查云黑(.+)$'
response: "${target} 存在违规行为\n================\n玩家ID: ${player_name}\nUUID: ${uuid}\nXUID: ${xuid}\n库来源: ${black_id}\n记录原因: ${info}\n危险等级: ${level}\n玩家QQ: ${qq}\n详细信息：${detail_url}\n================\n"
token: ''

字段	类型	说明
expression	string	查询云黑指令，使用正则匹配
response	string	查询云黑返回信息，可用变量见response变量表
token	string	API Token，填写后查询会返回私有库条目

# response变量

变量	说明	示例
${target}	查询关键字	blackbetest
${player_name}	违规者游戏ID	blackbetest
${qq}	违规者QQ号	11030503
${xuid}	违规者XboxUID	2535424045177658
${uuid}	云黑条目UUID	323c1261-76b6-44c8-bdba-bfeab250fee4
${info}	违规原因	开发者测试账号
${level}	违规等级	1
${black_id}	云黑仓库来源	公开库
${detail_url}	条目详情链接	https://blackbe.work/detail/323c1261-76b6-44c8-bdba-bfeab250fee4

# 重载配置文件

在控制台输入以下指令可以重载配置文件

blackbe reload

# 查询云黑

以下按默认配置为例

向机器人发送查云黑 {查询关键字}即可
{查询关键字}既可以是玩家ID，也可以是玩家XUID，或者玩家QQ号

机器人会返回如下结果 QQBot Query

# 检查群成员

注意

因为此功能存在24小时的缓存，所以可能会具有滞后性，如果你需要提前清理缓存，可以重启机器人

每当有人在群内发言时，机器人都会自动检查发言的成员是否存在于黑名单内，如果存在则会发出警报，如同下图所示 QQBot Check