nonebot2/README.md

XiaoKai Bot 小开机器人

基于 sjdy521/Mojo-Webqq 实现的自动处理 QQ 消息的机器人，支持自定义插件。

快速开始

部署

推荐使用 Docker 部署，因为基本可以一键开启，如果你想手动运行，也可以参考第二个小标题「手动部署」。

使用 Docker

本仓库根目录下的 docker-compose.yml 即为 Docker Compose 的配置文件，直接跑就行。如果你想对镜像进行修改，可以自行更改 Dockerfile 来构建或者继承已经构建好的镜像。

手动运行

首先需要运行 sjdy521/Mojo-Webqq，具体见它的 GitHub 仓库的使用教程。然后运行：

pip install -r requirements.txt
python app.py

注意要求 Python 3.x。

使用

局限性

由于 QQ 的限制，现有下列问题：

• 可能无法连续在线较长时间，因此需要频繁重启服务（大约一到两天一次）
• 无法处理临时消息和讨论组消息
• 单条消息无法发送很长的内容
• 有时候群消息会被屏蔽，私聊消息则正常

插件

程序支持两种插件形式，一种是过滤器／Filter，一种是命令／Command。

收到消息后，依次运行所有过滤器，即按照优先级从大到小顺序运行 filters 目录中的 .py 文件中指定的过滤器函数，函数返回非 False 即表示不拦截消息，从而消息继续传给下一个过滤器，如果返回了 False，则消息不再进行后续处理，而直接抛弃。

命令分发器（filters/command_dispatcher.py)是一个预设的优先级为 0 的过滤器，它根据命令的开始标志判断消息中有没有指定命令，如果指定了，则执行指定的命令，如果没指定，则看当前用户有没有开启交互式会话，如果开启了会话，则执行会话指定的命令，否则，使用默认的 fallback 命令。

用户可以自行编写插件来扩展功能，具体请看 文档。