使用Nonebot编写QQ机器人

使用 NoneBot 这个工具，来编写 QQ 机器人。

安装基础软件

一、安装 NoneBot 库

直接使用 pip 安装即可

pip install nonebot

二、安装酷Q 软件和 HTTP API 插件

酷Q 软件可以直接到官网下载，https://cqp.cc/b/news，或者可以到网盘下载，链接: https://pan.baidu.com/s/19l4IdTLi9__BhkboOcYP-g 提取码: b6er
HTTP API 插件，同样可以到官网下载，https://cqhttp.cc/docs/4.8/，如果下载有问题，可以到这个网盘下载，链接: https://pan.baidu.com/s/1h4oROjCu88HSbDloKSUGSw 提取码: cccf

下载好酷Q 软件后，解压缩，目录如下图：

首先将下载好的 HTTP API 插件放到 app 目录下，然后双击 CQA.exe 文件，输入机器人对应的 QQ 号和密码，登陆之后，在应用管理中，启动 HTTP API 插件。

三、配置 HTTP API 插件

进入酷Q 的 data/app/io.github.richardchien.coolqhttpapi/config/ 目录，有一个.json 的文件，user-id 为刚刚登陆的 QQ 号。修改这个文件的如下配置

{
    "ws_reverse_api_url": "ws://127.0.0.1:8080/ws/api/",
    "ws_reverse_event_url": "ws://127.0.0.1:8080/ws/event/",
    "use_ws_reverse": true
}

开始历史性的对话

先给出 nonebot 的官方文档地址：https://none.rclab.tk/guide/getting-started.html，感兴趣的同学也可以去官网查看。
下面我们先跑一下官网上的基础例子

import nonebot


if __name__ == "__main__":
    nonebot.init()
    nonebot.load_builtin_plugins()
    nonebot.run(host='127.0.0.1', port=8080)

运行该程序，我们可以在控制台看到如下日志：

[2019-04-05 19:31:18,281 nonebot] INFO: Succeeded to import "nonebot.plugins.base"
[2019-04-05 19:31:18,281 nonebot] INFO: Running on 127.0.0.1:8080
Running on https://127.0.0.1:8080 (CTRL + C to quit)
[2019-04-05 19:31:18,282] ASGI Framework Lifespan error, continuing without Lifespan support
[2019-04-05 19:31:18,283 nonebot] INFO: Scheduler started
[2019-04-05 19:31:20,490] 127.0.0.1:6568 GET /ws/api/ 1.1 101 - 2987
[2019-04-05 19:31:20,493] 127.0.0.1:6569 GET /ws/event/ 1.1 101 - 1154

可以看到现在程序运行在了本地的 8080 端口，而且本地的 6568 和 6569 端口也连接到了本服务，就是我们在 HTTP API 插件的配置文件中做的配置

  "ws_reverse_api_url": "ws://127.0.0.1:8080/ws/api/",
    "ws_reverse_event_url": "ws://127.0.0.1:8080/ws/event/",

现在我们向这个机器人账号发送下消息

/echo 你好

在控制台可以看到日志如下：

[2019-04-05 19:37:59,614 nonebot] INFO: Self: 3412355667, Message 56 from 736552883: /echo 你好
[2019-04-05 19:37:59,614 nonebot] DEBUG: Parsing command: /echo 你好
[2019-04-05 19:37:59,614 nonebot] DEBUG: Matched command start: /
[2019-04-05 19:37:59,614 nonebot] DEBUG: Split command name: ('echo',)
[2019-04-05 19:37:59,614 nonebot] DEBUG: Command ('echo',) found, function: 
[2019-04-05 19:37:59,614 nonebot] DEBUG: New session of command ('echo',) created
[2019-04-05 19:37:59,615 nonebot] DEBUG: Running command ('echo',)
[2019-04-05 19:37:59,738 nonebot] DEBUG: Session of command ('echo',) finished
[2019-04-05 19:37:59,739 nonebot] INFO: Message 56 is handled as a command

同时我们的机器人账号也自动回复了“你好”给我们。
真实“历史性”的时刻！！

增强机器人功能之配置文件

增加 config.py 文件，输入内容如下：

from nonebot.default_config import *


SUPERUSERS = {123456}
COMMAND_START = {'', '/', '!', '／', '！'}
HOST = '0.0.0.0'
PORT = 8080

SUPERUSERS：是配置一个超级 QQ 用户，我们可以为这个超级用户配置一些特殊的操作；

COMMAND_START：是配置命令起始字符，我们增加了空字符串，所以不需要任何起始字符也能调用命令；

另外就是配置了 host 和 端口 port。

然后我们就可以修改原来的文件为：

import nonebot
import config


if __name__ == "__main__":
    nonebot.init(config)
    nonebot.load_builtin_plugins()
    nonebot.run()

下面我们就可以编写自己的命令了。

增强机器人功能之编写命令

这里要注意的是，所有的语法都是 asyncio 异步编程，需要了解简介的，可以查看这里。

获取每日一句

我们使用金山词霸的 API 获取每日一句内容，http://open.iciba.com/dsapi/

def get_content():
    url = 'http://open.iciba.com/dsapi/'
    res = requests.get(url)
    content_e = res.json()['content']
    content_c = res.json()['note']
    return [content_c, content_e]

这样就获取到一个”每日一句“的列表了。

编写自己的插件

创建一个 plugins 文件夹，在里面创建 daily.py 文件，编写如下代码

 from nonebot import on_command, CommandSession
 from utils import getdata
 
 
 @on_command('daily', aliases=('每日一句',))
 async def daily(session: CommandSession):
     daily_send = await get_daily()
     await session.send(daily_send[0])
     await session.send(daily_send[1])


async def get_daily():
    daily_sentence = getdata.get_content()
    return daily_sentence

使用 on_command 装饰器声明一个命令处理器，声明两个命令，分别是 ”daily“ 和 ”每日一句“，当用户向本机器人发送这两个命令时，就会自动调用 daily 这个函数，并且发送对应的消息。

而 get_daily 函数，就是调用金山词霸的 API 函数，来获取内容。

最后修改主文件内容，加载自己编写的插件

import nonebot
import config
from os import path


if __name__ == "__main__":
    nonebot.init(config)
    nonebot.load_plugins(path.join(path.dirname(__file__), 'plugins'), 'plugins')
    nonebot.run()

接下来我们测试一下这个简单的机器人效果如何

看起来效果还不错，哈哈哈，以后再慢慢增加更加强大的功能吧。