CQHTTP 协议适配器

安装

pip install alicebot-adapter-cqhttp

配置协议端

CQHTTP 协议适配器是 OneBot v11 协议 (原 CKYU 平台的 CQHTTP 协议) 的适配器，需要一个兼容 OneBot 协议的协议端进行通讯，你可以参考 OneBot 官网寻找支持 OneBot v11 协议的协议端。

以下以 go-cqhttp 为例：

下载 go-cqhttp 对应平台的发行版：Github Releases
运行 go-cqhttp 或 go-cqhttp.exe 生成默认配置文件
编辑配置文件 config.yml 并重启程序

目前 CQHTTP 适配器支持 WebSocket 连接和反向 WebSocket 连接，go-cqhttp 配置文件应该像下面所示：

yaml

account:
  uin: 机器人QQ号
  password: '机器人密码'

message:
  # 上报数据类型
  # 注意：此处必须是 array
  post-format: array

# 连接服务列表，下面的反向WS和正向WS请只选择一个
servers:
  # 反向WS设置
  - ws-reverse:
      # 反向WS Universal 地址
      universal: ws://127.0.0.1:8080/cqhttp/ws
      # 重连间隔 单位毫秒
      reconnect-interval: 3000
      middlewares:
        <<: *default # 引用默认中间件
  # 正向WS设置
  - ws:
      # 正向WS服务器监听地址
      host: 127.0.0.1
      # 正向WS服务器监听端口
      port: 6700
      middlewares:
        <<: *default # 引用默认中间件

其他条目保持默认即可。

配置 AliceBot

如果你安装上面配置 go-cqhttp 的话并且使用了反向 WebSocket 连接方式，将不需要对 AliceBot 进行配置。

如果你有其他特别的需求的话可以编辑 config.toml 来配置，参考基本配置和 CQHTTP 配置。

运行测试

如果你正确配置了协议端和 AliceBot，运行 AliceBot 后控制台将出现以下日志内容：

txt

2021-09-01 18:05:29.740 | INFO     | alicebot.adapter.cqhttp:handle_cqhttp_event:138 - WebSocket connection from CQHTTP Bot xxxxxx accepted!

发送富文本消息

在编写插件时，除了发送普通的文本消息外，也可以轻松地构造并发送富文本消息，请确保查看本节时你已经阅读了内置消息。

python

from alicebot import Plugin
from alicebot.adapter.cqhttp.message import CQHTTPMessageSegment


class HalloAlice(Plugin):
    async def handle(self) -> None:
        msg = CQHTTPMessageSegment.text("Hello, Alice!") + \
              CQHTTPMessageSegment.image("https://www.example.org/1.jpg")
        await self.event.reply(msg)

    async def rule(self) -> bool:
        if self.event.adapter.name != "cqhttp":
            return False
        if self.event.type != "message":
            return False
        return str(self.event.message).lower() == "hello"

更多使用方法请参考 OneBot 消息段类型和 CQHTTP 消息。

调用 OneBot API

你可以使用下面的方法调用 OneBot API：

python

from alicebot import Plugin


class TestPlugin(Plugin):
    async def handle(self) -> None:
        resp = await self.event.adapter.call_api("send_like", user_id=10001)
        # 等效于 resp = await self.event.adapter.send_like(user_id=10001)

    async def rule(self) -> bool:
        return self.event.adapter.name == "cqhttp"

更多使用方法请参考 OneBot 公开 API。

CQHTTP 协议适配器 ​

安装 ​

配置协议端 ​

配置 AliceBot ​

运行测试 ​

发送富文本消息 ​

调用 OneBot API ​