跨平台 Python 异步聊天机器人框架 / Asynchronous multi-platform chatbot framework written in Python
Go to file
2017-01-02 23:51:19 +08:00
commands Try to add the first natural language processor - 'translate' 2017-01-02 23:51:19 +08:00
docs Move out "split_at_xiaokai" filter 2016-12-31 21:29:55 +08:00
filters Try to add the first natural language processor - 'translate' 2017-01-02 23:51:19 +08:00
nl_processors Try to add the first natural language processor - 'translate' 2017-01-02 23:51:19 +08:00
.gitignore Add scheduler 2016-12-03 17:16:16 +08:00
apiclient.py Add some commands 2016-12-30 22:01:50 +08:00
app.py Add some commands 2016-12-30 22:01:50 +08:00
command.py Add weixin support and adapt to mojo-webqq 2.0 2016-12-29 23:45:34 +08:00
config.py Add voice recognition 2017-01-01 23:16:34 +08:00
docker-compose.yml Update name 2016-12-30 00:22:47 +08:00
Dockerfile Add voice recognition 2017-01-01 23:16:34 +08:00
filter.py Use decorator to add filters 2017-01-02 13:38:58 +08:00
interactive.py Initial commit 2016-12-02 22:24:19 +08:00
little_shit.py Try to add the first natural language processor - 'translate' 2017-01-02 23:51:19 +08:00
nl_processor.py Try to add the first natural language processor - 'translate' 2017-01-02 23:51:19 +08:00
README.md Add weixin support and adapt to mojo-webqq 2.0 2016-12-29 23:45:34 +08:00
requirements.txt Add voice recognition 2017-01-01 23:16:34 +08:00

XiaoKai Bot 小开机器人

基于 sjdy521/Mojo-Webqqsjdy521/Mojo-Weixin 实现的自动处理 QQ 和微信消息的机器人,支持自定义插件。

快速开始

部署

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

使用 Docker

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

手动运行

首先需要运行 sjdy521/Mojo-Webqq 或 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 命令。

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