Mirai+Native搭建教程 + CQDLL插件使用教程


一些废话

这也算是比较老的一个教程了,但目前还有第三方维护
这里简单讲述一下,CQ(酷Q)是之前很火的一个QQ机器人框架,社区广大,开发者人数上万
但因为腾讯的严查,导致了CQ的消失,让这些开发者所编写的插件无从去处
此时Mirai框架站了出来,成为了主流的一个QQ机器人框架
但因为编写语言问题,Mirai只能加载Java编写的插件,而CQ是兼容大部分语言的DLL动态链接库
就诞生出了一个新的CQ兼容程序--Mirai-Native
此文章会讲述两个主流Native(一个Mirai原生插件,一个第三方HTTP程序)的使用教程,当然可能写的有点烂,但对于小白来说应该能看懂


第一步-搭建Mirai框架环境

从Github下载Mirai程序(如果无法访问需要进行科学上网)
MiraiGithub: https://github.com/mamoe/mirai
Mirai论坛: https://mirai.mamoe.net
官方论坛和Github也有提供相关使用教程,具体不会的可以去参考


Mirai分为两个启动版本:

控制台版本(纯命令行操作,同时兼容Linux和Windows等多个系统,官方源,稳定)
https://github.com/iTXTech/mirai-console-loader

GUI版本(图形化,利于小白使用,只兼容Windows系统,处于测试,不稳定)
https://github.com/sonder-joker/mirai-compose


这里只提供控制台版本使用说明:

注意!这一步将会考虑到后面Native的使用问题,因为CQ插件是32位,所以如果使用原生Native这里需要安装32位的Java
32位Java并不难找,这里我推荐到清华大学镜像站下载(版本为Java17_x86):
https://mirrors.tuna.tsinghua.edu.cn/Adoptium/17/jdk/x32/windows/OpenJDK17U-jdk_x86-32_windows_hotspot_17.0.5_8.zip

官方提供的一键安装程序:
https://github.com/iTXTech/mcl-installer
找到需要的版本,简单易用,可自动下载MCL(控制台程序)所有的依赖,Java等程序(推荐小白使用)
如果是新手,并且没有特殊需求,可以选择一路回车实现一键安装
但要注意的是,安装程序默认只提供64位Java安装,如果要用到原生Native则需要自行下载上方32位Java并替换

使用MCL自行配置Java等环境启动
https://github.com/iTXTech/mirai-console-loader
需要自行安装Java,注意Java版本必须 >= 11(这里推荐Java 17)上面有下载链接

使用教程:
https://github.com/iTXTech/mirai-console-loader/releases/
找到最新版本下载并解压,会有mcl.jar mcl.cmd mcl三个文件

Windows启动:
如果要用到native,则需要修改java启动目录
使用记事本等程序编辑 mcl.cmd 启动脚本
set JAVA_BINARY=java 这一行
java 替换成你的32位Java目录即可
双击 mcl.cmd 启动

Linux启动:
注意!Native不兼容Linux系统!
控制台输入 ./mcl 启动


第二步-安装Native(原生Native)

原生Native Github:
https://github.com/iTXTech/mirai-native

这里是官方的两条主要说明:
与大部分酷Q插件兼容,不支持CPK和解包的DLL,需获取DLL和JSON原文件,JSON文件不支持注释。
Mirai Native 仅支持 Windows 32位 Java

第一种方法(使用MCL自动安装Mirai Native)
在Mirai根目录 Shift+右键 (Windows),选择 在此处打开cmd窗口 ,输入以下命令

.\mcl --update-package org.itxtech:mirai-native --channel stable --type plugin

第二种方法(手动下载Mirai Native安装)
https://github.com/iTXTech/mirai-native/releases
下载最新版本,复制到 plugins 文件夹,启动即可


第二步-安装Native(第三方-AnotherMiraiNative)

AnotherMiraiNative Github:
https://github.com/debumori-osc/Another-Mirai-Native

AnotherMiraiNative简称AMN,通过Mirai-api-http进行传输,只有GUI版本,UI模仿CQ制作

使用教程:
安装Mirai-api-Http插件
https://github.com/project-mirai/mirai-api-http

第一种方法(使用MCL自动安装Mirai-api-Http)
在Mirai根目录 Shift+右键 (Windows),选择 在此处打开cmd窗口 ,输入以下命令

.\mcl --update-package net.mamoe:mirai-api-http --channel stable-v2 --type plugin

第二种方法(手动下载Mirai-api-Http安装)
https://github.com/project-mirai/mirai-api-http/releases
下载最新版本,复制到 plugins 文件夹,启动即可

编辑 config/net.mamoe.mirai-api-http/setting.yml 文件
复制以下模板粘贴即可

## 配置文件中的值,全为默认值

## 启用的 adapter, 内置有 http, ws, reverse-ws, webhook
adapters:
  - ws

## 是否开启认证流程, 若为 true 则建立连接时需要验证 verifyKey
## 建议公网连接时开启
enableVerify: true
verifyKey: 1234567890

## 开启一些调式信息
debug: false

## 是否开启单 session 模式, 若为 true,则自动创建 session 绑定 console 中登录的 bot
## 开启后,接口中任何 sessionKey 不需要传递参数
## 若 console 中有多个 bot 登录,则行为未定义
## 确保 console 中只有一个 bot 登陆时启用
singleMode: false

## 历史消息的缓存大小
## 同时,也是 http adapter 的消息队列容量
cacheSize: 4096

## adapter 的单独配置,键名与 adapters 项配置相同
adapterSettings:

  ## 详情看 websocket adapter 使用说明 配置
  ws:
    host: localhost
    port: 8080
    reservedSyncId: -1

配置文件里的verifyKey就是你的验证密钥,可自行修改

https://github.com/debumori-osc/Another-Mirai-Native/releases
下载最新版本的 AnotherMiraiNative.exeCQP.dll 文件
https://github.com/debumori-osc/Another-Mirai-Native/releases/download/1.5.0/Release.zip
下载 Release.zip 环境库

在Mirai根目录创建一个 AMN 的文件夹
把最新版本的 AnotherMiraiNative.exeCQP.dll 解压进去
环境库 Release.zip 里的 SQLite.Interop.dll;libiconv.dll;libcharset.dll 解压进去

解压后,在 AMN 文件夹里会有以下文件

SQLite.Interop.dll
libiconv.dll
libcharset.dll
CQP.dll
AnotherMiraiNative.exe

双击 AnotherMiraiNative.exe启动即可


第三步-Mirai登录QQ号

Mirai的一些主要命令

help    查看命令列表
login [QQ号] [密码] {协议}    登录QQ,协议为可选,默认为 ANDROID_PHONE
autologin add [QQ号] [密码] {密码加密方式}    添加自动登录QQ,加密方式可选 PLAIN(无加密) 或 MD5
logout [QQ号]    退出登录指定的QQ号
status    查看Mirai状态
stop    关闭Mirai<br>

支持的协议列表
"ANDROID_PHONE" - 安卓手机
"ANDROID_PAD" - 安卓平板
"ANDROID_WATCH" - 安卓手表
"MACOS" - MAC系统
"IPAD" - IPAD系统


登录后可能会提示进行新设备验证等,一般很简单就能操作通过,如果实在过不去可以去Mirai论坛找解决方法
有些会提示QQ版本过低等,请尝试更换协议和更换QQ密码

到这一步Mirai+Native基本上算是搭建完成了,下面讲如何加载插件


第四步-加载DLL插件(原生Native)

下载所需要加载的插件 DLLJSON 文件


下载后将两个文件放置在 data\org.itxtech.mirainative\plugins 目录里面
重启Mirai程序,输入以下命令即可(假设插件名为ATBot)

npm load ATBot.dll



原生Native命令列表

npm load <DLL文件名>   加载指定DLL文件
npm list    列出所有 Mirai Native 插件
npm disable <插件Id>   停用指定 Mirai Native 插件
npm enable <插件Id>   启用指定 Mirai Native 插件
npm reload <插件Id>   重新载入指定 Mirai Native 插件
npm unload <插件Id>   卸载指定 Mirai Native 插件

具体操作可以找到任务栏的猫猫头图标右键查看选项


第四步-加载DLL插件(第三方-AnotherMiraiNative)

双击 AnotherMiraiNative.exe 启动后会看到有三个待填框


QQ: 你Mirai所登录的QQ号
ws: Mirai-api-http里面所配置的WebSocket地址(默认填写 ws://localhost:8080 即可)
AuthKey: Mirai-api-http里面所配置的验证密钥


点击 连接
然后会有一个以QQ头像的悬浮窗,右键-插件管理-添加插件-选择你插件的DLL文件即可
第三方的UI操作更利于新人使用,后面基本上自己研究研究就知道了,这都研究不明白还开什么机器人(


完结

没什么可说的(,教程已经写的很详细了,自己不会请百度谷歌等操作,实在不行进群问或者去论坛问

声明:XiaoXian's Blog|版权所有,违者必究|如未注明,均为原创|本网站采用BY-NC-SA协议进行授权

转载:转载请注明原文链接 - Mirai+Native搭建教程 + CQDLL插件使用教程