酷q服务器未响应,酷Q [CQHTTP Python Async SDK] 入坑指南【已失效】

最新推荐文章于 2025-03-21 22:30:12 发布

刘兮mkq

最新推荐文章于 2025-03-21 22:30:12 发布

阅读量498

点赞数

文章标签：酷q服务器未响应

相关链接见文末

酷Q [CQHTTP Python Async SDK] 入坑指南

介绍和文档

CQHTTP Python Async SDK 是酷Q 的 CQHTTP 插件的异步 Python SDK 版本，采用异步 I/O，封装了 web 服务器相关的代码，支持 CQHTTP 的 HTTP 和反向 WebSocket 两种通信方式，让使用 Python 的开发者能方便地开发插件。

本 SDK 要求使用 Python 3.7 或更高版本、CQHTTP v4.8 或更高版本。

—-CQHTTP Python Async SDK

为什么用这个？

我之前写的 python 的机器人框架用的这个

基于 quart 框架写的采用了异步的方式，因此效率更高。(flask 和 quart 的对比)

保留了 quart 的功能，可以额外添加网页访问等功能。

采用 websocket 可以实现酷Q程序和机器人主要代码分离。

前置知识

flask

一个 flask 程序大概是这样的

code 1_flask.py

@app.route("xxx") 定义了一个路由，即一个特定的URL的位置。

之后当访问特定的URL时，会解析到该位置

例如

访问地址

路由

值

localhost:2333

Index Page

localhost:2333/hello

/hello

Hello World

异步程序

Python 3.4 引入了 asyncio 模块，增加了异步编程，跟 JavaScript 的async/await 极为类似，大大方便了异步任务的处理。它受到了开发者的欢迎，成为从 Python 2 升级到 Python 3 的主要理由之一。

asyncio 模块最大特点就是，只存在一个线程，跟 JavaScript 一样。

由于只有一个线程，就不可能多个任务同时运行。asyncio 是”多任务合作”模式(cooperative multitasking)，允许异步任务交出执行权给其他任务，等到其他任务完成，再收回执行权继续往下执行，这跟 JavaScript 也是一样的。

—-Python 异步编程入门@阮一峰的网络日志

简单来说

一个问题：

早晨起床家里就你一个人在家，要做下面的事情

烧水 20min

洗漱 10min

淘米 10min

煮饭 20min

整理房间 15min

你会怎么干？

你的任务

同时进行的

时长

洗漱

烧水

10min

淘米

烧水

10min

整理房间

煮饭

20min

简单来说，就是异步程序，一个时间还是只能执行一个程序，但是执行顺序并不是固定的，在等待的时候可以把控制权交出，执行别的程序，等到完成后再收回控制权。这样表现出来就是交叉运行了(但是实际上还是同一时刻只有一个进程在运行)

这里不过多展开，需要的话可以自行了解

quart

quart 是一个和 flask 非常类似的 web 框架，区别是底层采用了异步的架构，简单来说，从一个 flask 程序过渡到 quart，只需要改变全部的库(和 flask 有关的变成 quart 对应的模块)，然后对应的加上 await / async 即可。

code 2_quart.py

cqhttp

cqhttp 是酷Q端的插件。负责将酷Q的数据通过 websocket 发给后端。

配置

首先下载酷Q和cqhttp插件io.github.richardchien.coolqhttpapi.cpk

将插件放到酷Q下的app目录，之后打开酷Q

在 CQHTTP 配置文件 \data\app\io.github.richardchien.coolqhttpapi\config 中，填写 ws_reverse_url 值为 ws://127.0.0.1:8080/ws/ ，这里 127.0.0.1:8080 应根据情况改为 bot.py 中传给 bot.run 的 host 和 port 参数。

然后，如果有的话，删掉 ws_reverse_event_url 和 ws_reverse_api_url 这两个配置项。

接着设置 use_ws_reverse 为 true。

最后重启 CQHTTP。

python-aiocqhttp 介绍

模块内部内置了一个 quart 作为 web 服务器，因此语法和 quart/flask 非常类似。python-aiocqhttp 作为 web 服务器，与酷Q的插件 cqhttp 相结合进行通信。cqhttp 将酷Q的消息编码成 json 发送到 python-aiocqhttp，同时 python-aiocqhttp 对其进行解析和封装。

除了酷Q的各种事件注册成了路由，python-aiocqhttp 同时也支持添加 quart 的路由。详见 aicocqhttp 文档 #添加路由

实例

上手第一个程序

一个简单的人工

$gif.latex?%5Cxcancel%7B%E6%99%BA%E8%83%BD%7D$ ZZ

看一段对话

实现只有两行

展开来看核心代码

详见这段代码

code 3_aizz.py

QQ点歌系统

酷Q + python

之前试过了，QQ音乐的数据最好弄到。所以就用QQ音乐了

1. 抓包获取API

以勾指起誓为例，搜索勾指起誓，推测服务器端返回一个json信息，在F12中一条条找，找到这个链接

对这段代码URL反编码可以看到，如图，参数列表有这么多。如果不想折腾可以直接替换里面的勾指起誓这四个字。但是作为尝试，为什么不折腾呢？

放到postman里面，一个参数一个参数尝试，发现至少需要保留 w=歌名 format=json 这两个。(如果不带format，得到的是 callback( jsondata ) 的形式。之后别的就没有影响了。记下来得到的最简化的URL https://c.y.qq.com/soso/fcgi-bin/client_search_cp?format=json&w={0}

2. 测试 API

先写一个requests请求测试一下。没有问题，然后分析json

获取到的数据可以点这查看 json

第一首歌是泠鸢yousa 的，链接https://y.qq.com/n/yqq/song/001uRLnP2aCu1T.html

看起来这一串001uRLnP2aCu1T是歌曲的一个ID之类的。去 json 里面搜索这个应该是 .data.song.list[0].songmid

3. demo

结合上面获取到的API，可以写出下面的一个程序，获得搜索列表并且生成第一首歌的地址。

code 4_qqmusic.py

4. 酷Q

这个时候和酷Q结合一下就是这样了。(假设通过 #点歌指令响应)

code 5_qqmusic_2.py

这里的 auto_escape=False 是转义酷Q 码。比如这里面用到了 [CQ:at,qq={0}] 有的时候可能并不希望酷Q输出各种奇奇怪怪的信息(比如利用这个特性发送卡片消息，大量@等等，可以进行转义(即不会解析成特殊消息))