Python 开发 QQ 机器人实战：基于 Mirai 框架

3. 配置 mirai-api-http

为了实现 Python 调用，需启用 HTTP API。

1. 下载 mirai-api-http 的 jar 包。
2. 将其放入 plugin 文件夹下。
3. 重启 MCL。

注意：若遇到签名验证错误，可能是 JDK 版本问题。建议将 Oracle JDK 替换为 OpenJDK。

1. 下载并安装 OpenJDK。
2. 配置环境变量 JAVA_HOME 指向 OpenJDK 路径。
3. 配置 setting.yml 文件：

   # file: mcl-1.0.3/config/net.mamoe.mirai.api.http/setting.yml
   authKey: graia-mirai-api-http-authkey
   cacheSize: 4096
   enableWebsocket: true
   host: '0.0.0.0'
   port: 8080
   

4. 重启 MCL 使配置生效。

Python 开发实现

安装依赖

使用 Graia Application 库来操作 Mirai API：

pip install graia-application-mirai

基础代码示例

创建 bot.py 文件，填入以下代码：

from graia.broadcast import Broadcast
from graia.application import GraiaMiraiApplication, Session
from graia.application.message.chain import MessageChain
import asyncio

from graia.application.message.elements.internal import Plain
from graia.application.friend import Friend

loop = asyncio.get_event_loop()

bcc = Broadcast(loop=loop)
app = GraiaMiraiApplication(
    broadcast=bcc,
    connect_info=Session(
        host="http://localhost:8080",
        authKey="graia-mirai-api-http-authkey",
        account=5234120587,  # 你的机器人的 qq 号
        websocket=True
    )
)

@bcc.receiver("FriendMessage")
async def friend_message_listener(app: GraiaMiraiApplication, friend: Friend):
    await app.sendFriendMessage(friend, MessageChain.create([
        Plain("Hello, World!")
    ]))

app.launch_blocking()

运行后向机器人发送消息，若收到 "Hello, World!" 则表示成功。

进阶功能

1. 群消息处理

除了好友消息，机器人通常还需要处理群消息。可以通过监听 GroupMessage 事件实现。

from graia.application.group import Group

@bcc.receiver("GroupMessage")
async def group_message_listener(app: GraiaMiraiApplication, group: Group, sender):
    if "指令" in str(sender.message):
        await app.sendGroupMessage(group, MessageChain.create([Plain("收到群消息指令")]))

2. 命令解析

实现简单的命令解析功能，例如 /help 显示帮助信息。

@bcc.receiver("FriendMessage")
async def command_handler(app: GraiaMiraiApplication, friend: Friend, message: MessageChain):
    text = str(message).strip()
    if text == "/help":
        help_msg = "可用命令：\n/help - 查看帮助\n/ping - 测试连接"
        await app.sendFriendMessage(friend, MessageChain.create([Plain(help_msg)]))
    elif text == "/ping":
        await app.sendFriendMessage(friend, MessageChain.create([Plain("Pong!")]))

3. 撤回消息与引用回复

利用 GraiaMiraiApplication 提供的 API 可以轻松实现消息撤回和引用回复。

# 撤回指定消息
await app.recallMessage(friend, message_id)

# 引用回复
await app.sendFriendMessage(friend, MessageChain.create([
    Plain("这是回复内容"),
    At(friend.id)  # 可选：@对方
]))

结语

通过以上步骤，你可以快速搭建一个基于 Python 的 QQ 机器人。Mirai 框架提供了强大的扩展性，配合 Graia Application 库，能够轻松实现各种业务逻辑。在实际开发中，建议参考官方文档获取更多关于事件分发、中间件及高级特性的支持。

开发过程中遇到问题，可查阅 Mirai 官方文档或相关社区资源。祝开发顺利！