酷Q on 醉后的星星

利用QQ机器人发送时光机

Fri, 15 Nov 2019 12:38:00 +0000

现在handsome主题已经有了微信公众号和浏览器拓展两种方式向时光机发送消息，那么自然就想到QQ端是否也可以做到，所以我就通过对浏览器扩展发送时光机进行抓包，然后基于酷Q和nonebot，实现了通过向QQ小号发送消息的方式向时光机发送消息。 [scode type=“share”]代码见github[/scode]

使用方法

和微信公众号的用法大同小异，所有消息需要私聊机器人

发送帮助时光机查看帮助信息发送绑定然后根据提示输入绑定信息，发送解绑取消绑定发送时光鸡然后根据提示输入你要发送的消息（也可以一次性输入时光鸡你要发送的消息中间加空格即可）发送开始然后可以逐条发送消息，发送结束结束混合消息，发送取消取消发送发送的第一条消息如果以#开头即为私密消息发送博客获取博客地址发送图床更改图床

如有需要，可以直接加群体验我已经搭建好的QQ机器人 [button color=“success” icon=“fa fa-qq” url="//shang.qq.com/wpa/qunwpa?idkey=786f97195ca56ef0a1888eef7e803fabee0b70cb01d6dbf0c2295454797d803b"]QQ群 642739195[/button]

已知问题

由于QQ可以在一条消息里同时塞进文字和图片，所以发送单条消息也可以达到混合消息的效果，但经我测试在QQ手机客户端如果一条消息同时包含文字和图片，那么图片会无法解析，但是电脑的TIM客户端不存在这个问题。这个问题出在酷Q上，所以要同时发送文字和图片，在手机客户端最好采用逐条发送的模式。
由于handsome_6.0对上传的图片进行了压缩，所以上传gif图片会被压缩成jpg图片，因此图片增加图床功能并默认采用QQ图片的源地址，省去了下载和上传操作，速度更快，但QQ源图片腾讯可能采取限制而无法引用，而且目前已知腾讯对这些图片的缓存会过一段时间就清掉，所以QQ源图床慎用。最好的当然是接入自己的图床，暂时先懒得弄。

安装方法（Windows）

你可以先在自己的电脑上安装和熟悉使用

1. 准备

所有需要下载的东西已打包->点击下载因为是基于酷Q和Python运行的，所以需要先安装酷Q Air->下载地址，然后打开酷Q，登陆你的作为QQ机器人的QQ小号，熟悉酷Q的使用，尤其是插件的安装和启用，酷Q论坛里也有许多其他插件可供玩耍。然后下载安装python，建议下载安装Python 3.7.x 32位版本，因为我是基于这个版本开发的，别的版本尤其是最新的3.8版本可能会有未知的不兼容的bug。安装的时候记得勾选环境变量。

2. 安装插件

这里可以参考CoolQ HTTP API官方说明将io.github.richardchien.coolqhttpapi.cpk移动至酷Q的app文件下，然后重启酷Q或者在应用管理里重载应用，在应用管理里选中HTTP API插件，点击启用，接下来几个弹窗统统选是。启用成功后会弹出控制台窗口。 [scode type=“yellow”]如果弹窗提示应用加载失败，先安装[ Visual C++ 可再发行软件包]( Visual C++ 可再发行软件包)[/scode]

3.启用nonebot

这里可以参考Nonebot官方说明如果你之前成功开启了插件，那么酷Q的data/app/io.github.richardchien.coolqhttpapi/config/目录中应该已经有了一个名为 .json 的文件（为你登录的 QQ 账号），修改其中的内容如下： [collapse status=“false” title=“json文件内容”]

{
 "host": "[::]",
 "port": 5700,
 "use_http": true,
 "ws_host": "[::]",
 "ws_port": 6700,
 "use_ws": false,
 "ws_reverse_url": "",
 "ws_reverse_api_url": "ws://127.0.0.1:8080/ws/api/",
 "ws_reverse_event_url": "ws://127.0.0.1:8080/ws/event/",
 "ws_reverse_reconnect_interval": 3000,
 "ws_reverse_reconnect_on_code_1000": true,
 "use_ws_reverse": true,
 "post_url": "",
 "access_token": "",
 "secret": "",
 "post_message_format": "string",
 "serve_data_files": false,
 "update_source": "github",
 "update_channel": "stable",
 "auto_check_update": false,
 "auto_perform_update": false,
 "show_log_console": true,
 "log_level": "info"
}

[/collapse]

然后下载找到我写的coolq-cross-bot文件，用python运行该文件夹下的bot.py文件，运行前要先安装依赖库。

[tabs] [tab name=“运行方式” active=“true”] 打开命令提示符窗口，执行以下命令：

pip install nonebot
pip install aiohttp

然后在控制台进入coolq-cross-bot文件夹内，输入python bot.py运行该文件，当然也可以用IDE运行。 [/tab] [/tabs] [scode type=“yellow”]阿里云服务器如果一直卡在下载图片且ping不通c2cpicdw.qpic.cn可能是因为节点问题，需添加host记录113.96.232.144 c2cpicdw.qpic.cn [/scode] 最后重启酷Q软件或者重载插件，弹出来的控制台如下显示成功字样则代表配置成功，这时你就可以私聊机器人发送初始化创建一个数据库后就可以使用了（初始化命令只需执行一次，用于在文件目录下新建bind_info.sqlite文件用于记录绑定信息）,最后要注意两个控制台窗口都不能关闭，你可以选择新建一个桌面单独用于运行他们。

安装方法（Linux）

详细参考：CoolQ HTTP API官方说明 Linux系统需要在docker中运行酷Q，所以要先安装docker，安装教程请自行百度，以下仅供参考，以我的Ubuntu16.04 64位为例，ssh连上服务器后运行以下命令安装docker

$ curl -fsSL https://get.docker.com -o get-docker.sh
$ sudo sh get-docker.sh

然后安装酷Q和HTTP API插件（配置参数无所谓，后面手动替换）

$ docker pull richardchien/cqhttp:latest
$ mkdir coolq # 用于存储 酷Q 的程序文件
$ docker run -ti --rm --name cqhttp-test \
 -v $(pwd)/coolq:/home/user/coolq \  # 将宿主目录挂载到容器内用于持久化 酷Q 的程序文件
 -p 9000:9000 \  # noVNC 端口，用于从浏览器控制 酷Q
 -p 5700:5700 \  # HTTP API 插件开放的端口
 -e COOLQ_ACCOUNT=123456 \ # 要登录的 QQ 账号，可选但建议填
 -e CQHTTP_POST_URL=http://example.com:8080 \  # 事件上报地址
 -e CQHTTP_SERVE_DATA_FILES=yes \  # 允许通过 HTTP 接口访问 酷Q 数据文件
 richardchien/cqhttp:latest

然后访问 http://[你的服务器IP]:9000/ 进入 noVNC（默认密码 MAX8char），登录酷Q，即可开始使用（插件已自动启用，配置文件也根据启动命令的环境变量自动生成了） [scode type=“yellow”]如果阿里云主机注意要先开放相应的端口，默认是9000端口[/scode] 把coolq-cross-bot文件夹上传至服务器，将之前的json文件也上传至服务器并替换掉app/io.github.richardchien.coolqhttpapi/下的ini配置文件（注意将配置文件中127.0.0.1换成172.17.0.1），然后用python3命令运行文件下的bot.py，重启插件

进阶自定义修改（可选）

1. 自定义命令

其实时光机的触发命令不仅可以是‘时光机’，也可以是‘时光鸡’、‘时光姬’等，具体可以在 coolq-cross-bot/plugins/handsome/timeji.py 源码中找到类似下面的语句自行进行修改。 @on_command('timeji', aliases=('时光鸡', '时光机', '时光姬', '动态', '说说')) 其他命令类似。

2. 添加消息来源

如上图所示，在时光机消息的来源处，如果不对handsome的源码进行修改，就会显示来自未知浏览器，找到handsome/libs/UA.php文件，在文件的最后加入如下所示的QQ的来源，名称可以自定义。

public function returnTimeUa(){
 if ($this->ua == "weixin" || $this->ua == "weChat"){
 return array("title"=>_mt("微信公众号"),
 "icon"=>"compass");
 }elseif ($this->ua == "crx"){
 return array("title"=>_mt("Chrome扩展"),
 "icon"=>"chrome");
 }elseif ($this->ua == "qq"){
 return array("title"=>_mt("QQ时光姬"),
 "icon"=>"compass");
 }else{
 $ua = $this->returnOS();
 $ua["icon"] = "disc";
 return $ua;
 }
 }

3.添加消息来源前的图标（6.0主题不需要了）

主题默认呈现出来的都是清一色的小圆点图标，要更改消息来源前的小图标，首先要添加fontawesome图标，然后找到handsome/component/say.php，找到下面第一条语句，改成第二句。

# 找到下面这一句
<i class="glyphicon glyphicon-record m-l-sm"></i>&nbsp;
# 改成下面这样
<i class="<?php echo $ua->returnTimeUa()['icon'] ?> m-l-sm"></i>&nbsp;

Nonebot酷Q应用开发

Wed, 30 Oct 2019 13:49:00 +0000

前面已经研究过Python和C++的酷Q应用开发流程了，其中慕晓飞大大的SDK虽然前期配置需要一定经验，但配置好后上手很快很简单的，但这个SDK不支持并发是最大的硬伤，限制了其使用范围。而C++的SDK无疑写起来过于麻烦，好在该SDK的大神richardchien在C++ SDK的基础上开发出了基于HTTP的API接口，由此衍生出了基于该HTTP API的多种语言开发版本，其中就有同样是该作者基于Quart框架开发的Nonebot,支持异步处理是其最大的特点，但也由于对消息封装的过于深入，使得在入手使用Nonebot带来不小的挑战。

入门

要使用Nonebot得先从HTTP API开始，先根据这篇说明：https://cqhttp.cc/docs/4.12/#/ 完成对HTTP API的成功调用，然后再到我们的Nonebot出场，官方的入门文档写的已经很仔细了：https://nonebot.cqp.moe/guide/installation.html，走完这篇入门文档，应该很容易就实现了案例中的天气和图灵机器人案例。接下来来梳理以下Nonebot的编写逻辑，他将消息处理分为on_command，on_natural_language，on_request（其他的暂不清楚）几个类型，command用于处理命令，也是用的最多的类型，这里就不用我们手动检测消息里的命令关键字了，然后未被匹配的消息会送到natural_language中处理，如果没有natural_language消息就会被忽略。request用于处理加群请求等非消息类的任务。还有许多细节问题就需要慢慢研究了，比如想在群聊中也是用命令，可以加only_to_me=False参数。要主动调用HTTP API可以使用如下方式：

bot = session.bot
# bot = nonebot.get_bot()
await bot.send_private_msg(user_id=12345678, message='你好～')

要获得上报事件中的参数，需要访问session.ctx。然后下面这个例子是发送测试获得该消息的上报内容，发送其他消息则会复读。

from nonebot import on_command, CommandSession
from nonebot import on_natural_language, NLPSession, IntentCommand

__plugin_name__ = '测试'
__plugin_usage__ = '测试 命令'


@on_command('test', aliases=('测试',), only_to_me=False)
async def test(session: CommandSession):
 ctx = session.ctx
 await session.send(str(ctx))


@on_natural_language(only_to_me=False)
async def repeat(session: NLPSession):
 msg = session.ctx["message"]
 await session.send(msg)

还有更多应用后续再研究。。。

C++酷Q应用开发

Sat, 26 Oct 2019 09:31:00 +0000

以前自己的水平不够，这个项目一直搞不懂，现在起码能跑通了，其实也是比较简单的，项目地址：https://github.com/richardchien/coolq-cpp-sdk

步骤

在该装的东西都装了后，在cmd中依次执行以下命令即可。其中最后一个命令，可能需要先进powershell管理员模式运行Set-ExecutionPolicy并选择是来打开权限。另外由于网络原因，可能会在Unpacking objects这一步卡住，我是通过加速来解决的。

git clone https://github.com/richardchien/coolq-cpp-sdk.git my-awesome-app
cd my-awesome-app
git submodule init
git submodule update
powershell .\scripts\prepare_prebuilt.ps1

然后编译项目，把编译出来的相应文件丢进酷Q的dev文件夹里就行了。

powershell .\scripts\generate.ps1 Release
powershell .\scripts\build.ps1 Release

Python酷Q应用开发

Tue, 03 Sep 2019 16:59:00 +0000

前言

酷Q机器人应用一般都是用易语言开发的，但是一方面不想再多学一门易语言，另一方面开发脚本还是用Python比较舒服。关于Python的酷Q的SDK我在论坛找了一下，目前用的比较多的有两个（现在应该是三个了，见文末），一个是基于http的none-bot，功能更强大，但上手有一定难度，所以最简单的我觉得还是慕晓飞大大的 Python酷Q_SDK_X
本站更多关于酷Q的文章：点我

环境配置

首先需要按照文档的说明配置开发环境，这点文档讲的很详细，就不赘述了，需要注意的是：

酷Q本身是32位程序，开发时只支持32位的Python。
还有一点就是app_id应该按照官方规范来，否则可能会出问题，规范说明。
酷Q升级后开发环境的目录移动至酷Q的dev目录下，如果酷Q没有自动更正的话请手动更正。更正方法为，在dev目录下新建cn.muxiaofei.coolq_sdk_x文件夹，将原来的cn.muxiaofei.coolq_sdk_x.dll和cn.muxiaofei.coolq_sdk_x.json重命名为app.dll和app.json移动至新建的文件夹下，其他不变。

配置完环境，如果不出意外的话，应该就能在酷Q日志的DEBUG里看到输出的hello world。

编写程序

接下来就是敲自己的代码了，这个SDK的所有事件处理和API调用都在CQPlusHandler.py文件的?MainHandler类中进行编写，关于事件和参数的说明在开发文档中都有说明，API可以通过输入self.api的代码提示进行查看，也可以转到一个_api.py的文件中查看，至于这些API函数和参数的意义基本上看名字就能猜到八九分了，具体使用方法需要自己去尝试。
新手需要注意的是这个CQPlusHandler.py程序是由酷Q软件自动执行的，不需要在Python的IDE里点运行，当然你点了也没用，如果setting里的DEBUG参数你没改的话，只要修改代码并保存，修改的代码就会实时生效。
然后需要说明的就是@和表情，这个需要使用CQ码，CQ码详细介绍。但一般只需在QQ中发一条包含@或表情的消息，然后通过酷Q的日志就能直接进行右键复制了，复制后只需将相应的格式通过字符串的格式和普通消息一样输出就行了。
举个例子，在CQPlusHandler.py文件中写入以下代码就能实现在群聊里复读并@发言的人的功能：

# -*- coding:utf-8 -*-

import cqplus

class MainHandler(cqplus.CQPlusHandler):
 def handle_event(self, event, params):
 if event == "on_group_msg":
 msg = '[CQ:at,qq=' + str(params['from_qq']) + ']' + params['msg']
 self.api.send_group_msg(params['from_group'], msg)

案例

然后下面是我根据需求给群友写的一个自助Roll游戏的插件，和论坛上我能找到的抽奖插件相比，这个插件的特点在于完全由qq消息进行命令，可以直接丢到服务器上就不用管了，另一个特点是可以同时进行多个Roll游戏活动而互不干扰，以下是一个使用案例。这个应用其实还有一些功能我想过但还没加进去，以后根据需要有时间再看看吧，我把我写的垃圾代码放在了GitHub上，希望可以给有需要的人一点有价值的参考：Github链接

已知问题

打包

最后就是应用的打包，直接使用打包生成的cpk文件会报错，需要像开发应用一样配置好环境并把源程序也放进去，唯一的差别就在于可以不用进入酷Q的开发者模式，所以要丢到服务器上的话，还有一丢丢的麻烦。由于Python的SDK的特性，编写的插件就不能像论坛上别的插件一样只发布cpk文件即可，而且使用者还需配置环境，对于普通用户来说过于麻烦了，所以这个还是只适合开发者自己使用。

消息并发处理

由于Python的GLI锁机制，本插件不支持并发处理。表现为有事件发生时，比如各种消息和定时器事件，插件便会调用一次CQPlusHandler.py进行事件处理，所以当上一次事件还未处理完时，下一个事件又紧接着发，这时便会发生内存报错。虽然报错了程序并不会崩溃，不过如果程序要处理网络请求一类的耗时任务，这个缺陷是致命的。要想避免这种报错，只在CQPlusHandler.py文件里下功夫（比如用多线程）应该是不行的，估计得从源码上想想办法才行。不过我的机器人不需要处理大量消息，消息处理的也很快，所以凑合用用也还行。
后来有大神重新写了个支持并发的python SDK，现在也更推荐使用这个或者更高级的nonebot。