基本框架 

(1) 酷Q：目前最常用的QQ机器人软件(尤其是在smartQQ失效以后)。

(2) 酷Q HTTP插件：通过HTTP对酷Q的事件进行上报以及接收HTTP请求来调用酷Q的DLL接口，从而可以使用其它语言编写酷Q插件。

(3) nonebot：基于酷Q的Python异步QQ机器人框架。

 

准备工作

1.安装酷Q

百度网盘https://pan.baidu.com/s/1W0sO610thTdQy48T4_qNKQ，提取码：fqc3

酷Q官网最近好像不能注册了，我在网上找了份资源，解压后打开CQA.exe，输入账号密码即可。注意：务必用小号作为机器人账号！

可以在应用-应用管理中查看并管理所有的机器人插件，在日志中查看机器人是否有正确做出回应。酷Q的这一部分是比较简单的，大家基本看看就知道了。

 

2.安装酷Q HTTP插件

百度网盘https://pan.baidu.com/s/1uSH1Ixsx1rBf00BjpgAzdw，提取码：yyjg

这里同样用的是网盘资源，github上的下载确实有点慢(https://github.com/richardchien/coolq-http-api/releases)，这里可能不是最新版（最新版请访问上述github链接），但是也无伤大雅。

你将会下载这样的文件io.github.richardchien.coolqhttpapi.cpk，将这个cpk文件放到酷Q的插件目录下，插件目录一般为“CQA.exe文件所在目录/app”，如果你不确定，也可以打开酷Q软件后右键悬浮窗：应用-应用目录。

在酷Q中点击重载应用，HTTP插件便会启动，会弹出下图这样的窗口

接下来要完成初始化设置，首次启用HTTP插件会生成一个默认配置文件，在“CQA.exe文件所在目/data/app/io.github.richardchien.coolqhttpapi/config”文件夹下会有这样一个json文件，名字是你登陆的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,

如果在这一块遇到问题，可以访问CQHTTP 插件的官方文档：https://cqhttp.cc/docs/4.15/

 

3.安装nonebot框架

这个是最好搞定的，你只需要在你的python环境中安装nonebot模块即可

pip install nonebot

nonebot官方文档：https://nonebot.cqp.moe/guide/

建议大家在动手实践之前一定要详细看一遍！

 

正式开始！

1.“Hello World”

我们先来看一个最最基础，也是官方文档中给出的最小实例。

首先创建一个myRobot文件夹，建议放在酷Q的工作路径下(其实放哪无所谓)。我们创建一个python文件‘bot.py’

#bot.py

import nonebot

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

运行之后我们在控制台可以看到这样的日志，表明已经设置成功

我们可以给这个机器人QQ账号发送一个基本的内置指令“echo”，这也是基础案例包含的唯一指令(其实还有say指令，但涉及到设置超级用户，具体可以参见说明文档)，意思是让机器人发送后面的文字，比如我们输入“/echo hello world”。

我们可以在控制台和酷Q的日志看到如下log

那么echo函数是怎样定义的呢？我们来看一下源码

@on_command('echo')
async def echo(session: CommandSession):
    await session.send(session.state.get('message') or session.current_arg)

@on_command()是一个命令识别的装饰器，其中的参数包括name(指令的名称)，aliases(指令的别名)，permission(用户权限设置)，only_to_me(在群聊中唤醒机器人是否需要@，默认为True)等等，这里只定义了指令的名称，当然我们也可以定义如下，这样我们可以使用“显示”或者“打印”命令来唤醒机器人，并且在群聊中不需要@机器人。

@on_command('echo', aliases=('显示','打印',), only_to_me = False)

装饰器下面是一个异步的echo函数(关于异步编程可以参见异步IO)，这个函数调用session.send()函数，直接把参数中的消息内容原样发送。

 

2.翻译功能

在上面我们学习了只包含基础echo指令的机器人，接下来我们给它添砖加瓦，添加一些新的功能。

首先我们在上述myRobot文件夹下创建配置文件‘config.py’，主要内容是SUPERUSERS和COMMAND_START，前者定义超级用户的QQ号，拥有更多权限；后者是设置指令的开头，这里设置了五个开头，拿之前的‘echo’指令为例，现在用户可以使用‘echo’，‘/echo’，‘！echo’，‘／echo’，‘!echo’来唤醒机器人(之前只能用‘/echo’)。

from nonebot.default_config import *


SUPERUSERS = {你想设置的超级用户QQ号}#1
COMMAND_START = {'', '/', '!', '／', '！'}
#HOST = '0.0.0.0'
#PORT = 8080

接着我们在myRobot文件夹新建文件夹‘plugins’，用来放置新的功能python文件，接着在‘plugins文件夹下新建‘translate.py’。

from nonebot import on_command, CommandSession

import  requests #爬虫库
import  re #正则表达式处理
@on_command('translate', aliases=('翻译','中译英')) #定义翻译指令及别名
async def translate(session: CommandSession):
    message = session.get('message', prompt='您想翻译成英文的语句是？') #获取待翻译的语句
    translate_send = await get_translate(message) #将待翻译的语句传给翻译函数
    await session.send(translate_send) #发送翻译后的语句

async def get_translate(message): #异步的翻译函数
	translate_sentence = get_content(message)
	return translate_sentence

def get_content(message): #翻译功能
	url = 'http://fanyi.youdao.com/translate?&doctype=json&type=AUTO&i='+message #有道的免费api
	res = requests.get(url) #爬取json格式的网页
	text = res.text 
	result = re.findall('"tgt":.*"',text)[0].split('"')[3] #用正则表达式提取翻译后的语句
	return result


@translate.args_parser #translate命令的参数解析器
async def _(session: CommandSession):
    stripped_arg = session.current_arg_text.strip() #去除首尾空白符
    if session.is_first_run: #如果是第一次运行
        if stripped_arg: #如果用户的待翻译语句跟在指令后面，则直接传参
            session.state['message'] = stripped_arg
        return
    if not stripped_arg: #如果用户的待翻译语句不在指令后面，则让他另行输入
        session.pause('要翻译的不能为空呢，请重新输入')
    #将参数放入会话状态中
    session.state[session.current_key] = stripped_arg 

这个翻译功能的实现明显要复杂一些了，还会涉及爬虫以及正则表达式知识，具体解释见注释部分。

本翻译功能基于有道的免费api，所以翻译效果不是很好(如果你是做着玩玩是无所谓，商业用途考虑购买专业的api，我不是在打广告！)。大部分这样的api功能都需要爬虫和正则表达式知识/json格式处理知识(大致了解即可)。

接下来我们将重写‘bot.py’，将新的翻译功能添加进去。

import nonebot
import config
from  os import path
if __name__ == '__main__':
    #加载配置文件
    nonebot.init(config)
    #加载功能插件(放在plugins文件夹中的python文件)
    nonebot.load_plugins(path.join(path.dirname(__file__), 'plugins'), 'plugins')
    #nonebot.run()
    nonebot.run(host='127.0.0.1', port=8080)

接着我们重新运行‘bot.py’,可以看到以下日志，可以看到plugins.translate已经成功加载(help和weather是我另写的其他插件)。

 

让我们来做个尝试吧！

 

3.天气功能

我们在plugins文件夹下接着新建‘weather.py’

from nonebot import on_command, CommandSession


# on_command 装饰器将函数声明为一个命令处理器
# 这里 weather 为命令的名字，同时允许使用别名「天气」「天气预报」「查天气」
@on_command('weather', aliases=('天气', '天气预报', '查天气'))
async def weather(session: CommandSession):
    # 从会话状态（session.state）中获取城市名称（city），如果当前不存在，则询问用户
    city = session.get('city', prompt='你想查询哪个城市的天气呢？')
    # 获取城市的天气预报
    weather_report = await get_weather_of_city(city)
    # 向用户发送天气预报
    await session.send(weather_report)


# weather.args_parser 装饰器将函数声明为 weather 命令的参数解析器
# 命令解析器用于将用户输入的参数解析成命令真正需要的数据
@weather.args_parser
async def _(session: CommandSession):
    # 去掉消息首尾的空白符
    stripped_arg = session.current_arg_text.strip()

    if session.is_first_run:
        # 该命令第一次运行（第一次进入命令会话）
        if stripped_arg:
            # 第一次运行参数不为空，意味着用户直接将城市名跟在命令名后面，作为参数传入
            # 例如用户可能发送了：天气 南京
            session.state['city'] = stripped_arg
        return

    if not stripped_arg:
        # 用户没有发送有效的城市名称（而是发送了空白字符），则提示重新输入
        # 这里 session.pause() 将会发送消息并暂停当前会话（该行后面的代码不会被运行）
        session.pause('要查询的城市名称不能为空呢，请重新输入')

    # 如果当前正在向用户询问更多信息（例如本例中的要查询的城市），且用户输入有效，则放入会话状态
    session.state[session.current_key] = stripped_arg


async def get_weather_of_city(city: str) -> str:

    return get_weather(city)

import  requests
def get_weather(city):
    #这里可以自行申请免费的天气api,将我的appid和密码换成自己的即可
    url = 'https://www.tianqiapi.com/free/day?appid=？？？？&appsecret=？？？？&city=' + city
    res = requests.get(url)
    if 'errcode' in res.json().keys():
        return '该城市不存在！' 
    else:
        result= '今日'+city+'的天气是'+res.json()['wea']+'，实时温度'+res.json()['tem']+'℃，'+res.json()['win']+res.json()['win_speed']+'，空气指数：'+res.json()['air']
        return result

这是官方文档的一个示例，不过官方文档中没有补充天气api部分，我申请了一个免费了api(https://www.tianqiapi.com/)

我们来看看效果

 

 

结语

这一阶段的学习就到这里啦，相信大家应该初步了解了如何制作简易的QQ机器人。后期的博客将会涉及接受更为复杂的指令的只能机器人。