基于go-cqhttp与Flask搭建定制机器人项目实战示例

下面我将详细讲解“基于go-cqhttp与Flask搭建定制机器人项目实战示例”的完整攻略，这个过程中包含两条示例的说明。

简介

本攻略将介绍使用go-cqhttp和Flask两个工具搭建一个定制的QQ机器人项目。其中第一条示例将展示如何使用go-cqhttp和Flask来实现一个抢购机器人，而第二条则将介绍如何使用这两个工具来实现一个天气查询机器人。

环境配置

在开始搭建机器人项目之前，我们需要进行一些环境配置。请确保您已经安装好了Python和go-cqhttp，并且拥有QQ机器人的基本配置信息。

安装Flask

在终端中输入以下命令来安装Flask:

pip install flask

配置go-cqhttp

请按照go-cqhttp官方文档进行配置，并确保go-cqhttp能够正确连接到您的QQ机器人账号。

抢购机器人示例

这个示例将展示如何使用go-cqhttp和Flask来实现一个抢购机器人。该机器人可以监听某个商品的抢购时间，并在开始时间的瞬间立即抢购。

实现

以下是实现抢购机器人的核心代码，请在Flask应用的路由函数中使用该代码：

import requests

# 商品id
item_id = 123456

# 抢购时间戳
buy_ts = 1632315600

# QQ号
qq = 123456

# go-cqhttp HTTP API地址
go_cqhttp_url = 'http://127.0.0.1:5700/send_private_msg'

@app.route('/buy_item')
def buy_item():
    # 获取当前时间戳
    now_ts = int(time.time())

    # 如果还没有到抢购时间，则直接返回
    if now_ts < buy_ts:
        return 'Not time yet'

    # 构造POST请求参数
    data = {
        'user_id': qq,
        'message': f'购买商品 {item_id}'
    }

    # 发送POST请求
    response = requests.post(go_cqhttp_url, data=data)

    # 返回响应结果
    return response.text

在上述代码中，我们首先定义了一个商品id和抢购时间戳，然后在Flask应用的路由函数中监听了一个URL，并在该URL被访问时进行抢购操作。如果当前的时间戳小于抢购时间戳，则直接返回“Not time yet”，否则向目标QQ用户发送一条“购买商品 {item_id}”的消息。

使用

使用该机器人示例非常简单，只需在go-cqhttp中定义一个访问URL，并将其转发到Flask应用的URL上即可。假设我们将该机器人的flask应用部署在本机的5000端口，那么可以在go-cqhttp中定义以下路由规则：

{
    "match": "exact",
    "regex": "^!buy$",
    "type": "private",
    "url": "http://127.0.0.1:5000/buy_item"
}

这样当用户发送了“!buy”这个指令时，go-cqhttp就会将请求转发到Flask应用的“/buy_item”路由上，并触发抢购流程。

天气查询机器人示例

这个示例将展示如何使用go-cqhttp和Flask来实现一个天气查询机器人。该机器人可以根据用户提供的城市名称查询当前城市的天气情况。

实现

以下是实现天气查询机器人的核心代码，请在Flask应用的路由函数中使用该代码：

import requests

# 高德地图Web服务URL
amap_url = 'https://restapi.amap.com/v3/weather/weatherInfo'

# 高德地图Web服务API密钥
amap_key = 'your_amap_key'

# go-cqhttp HTTP API地址
go_cqhttp_url = 'http://127.0.0.1:5700/send_private_msg'

@app.route('/query_weather')
def query_weather():
    # 获取用户提供的城市名称
    city = request.args.get('city')

    # 调用高德地图Web服务查询城市天气信息
    params = {
        'city': city,
        'key': amap_key
    }
    response = requests.get(amap_url, params=params)

    # 解析高德地图Web服务返回的结果
    result = response.json()
    today = result['forecasts'][0]['casts'][0]
    info = f'{today["date"]} {today["week"]} {today["dayweather"]}, 最高温度{today["daytemp"]}℃, 最低温度{today["nighttemp"]}℃'

    # 发送回复消息
    data = {
        'user_id': request.args.get('user_id'),
        'message': info
    }
    response = requests.post(go_cqhttp_url, data=data)

    # 返回响应结果
    return response.text

在上述代码中，我们首先定义了一个高德地图Web服务URL和API密钥。然后在Flask应用的路由函数中监听了一个URL，并根据请求参数查询指定城市的天气信息。完成查询之后再将结果发送给目标QQ用户。查询天气的关键步骤是使用高德地图Web服务查询城市天气，并解析返回的JSON结果。

使用

使用该机器人示例也非常简单，只需在go-cqhttp中定义一个访问URL，并将其转发到Flask应用的URL上即可。假设我们将该机器人的flask应用部署在本机的5000端口，那么可以在go-cqhttp中定义以下路由规则：

{
    "match": "startswith",
    "regex": "^!weather ",
    "type": "private",
    "url": "http://127.0.0.1:5000/query_weather"
}

这样当用户发送了“!weather 北京”这个指令时，go-cqhttp就会将请求转发到Flask应用的“/query_weather”路由上，并根据“city”参数查询北京的天气信息。然后将查询结果发送给目标QQ用户。