mirai 简介

Mirai 是一个在全平台下运行, 提供 QQ Android 和 TIM PC 协议支持的高效率机器人框架(官方定义)。实际上因为一些原因, TIM PC 协议停止更新了。目前功能最齐全, 运行最稳定的是 QQ Android 协议。(mirai 项目地址: Github )

  Mirai 是由 Kotlin 语言编写的协议库, 提供使用 QQ Android 协议的一些 API。但是 mirai 本身不是一个 “QQ机器人” 程序, 而是一个库。与机器人软件/框架 (例如酷Q) 对应的应该是 mirai 官方的衍生项目 mirai-console。(mirai-console 项目地址: Github )

mirai-console 提供了插件系统, 支持安装 由 Java/Kotlin 编写的 mirai-console 插件。如果安装了 mirai-native 插件, 还可以支持酷Q的插件。由于酷Q插件相关的机制没有开放,因此无法直接加载cpk类型的插件, 需要将酷Q的插件重新编译为 dll 才能给 mirai-native 使用。( mirai-native 项目地址: Github )。安装 mirai-api-http 插件, 则可以使用基于 mirai-api-http 开发的插件。( mirai-api-http 项目地址: Github )

想更详细的了解详见mirai开发文档

开始使用 mirai-console

使用前的注意事项

下面是使用之前必须阅读的声明(源自mirai的README.md):

一切开发旨在学习,请勿用于非法用途

  • mirai 是完全免费且开放源代码的软件,仅供学习和娱乐用途使用
  • mirai 不会通过任何方式强制收取费用,或对使用者提出物质条件
  • mirai 由整个开源社区维护,并不是属于某个个体的作品,所有贡献者都享有其作品的著作权。

如果你是开发者,你还需要了解 mirai 的开源协议。mirai 采用 AGPLv3协议开源。按照这个协议,任何与 mirai 有直接间接关系的程序,都应该采用相同的协议开源。比如,开发基于 mirai-console 的插件会直接引用 mirai 相关的库,因此这个插件需要采用 AGPLv3 协议开源。此外,开发基于 mirai-api-http 的插件会间接使用到 mirai,因此这个插件也需要采用 AGPLv3 协议开源

一、在 windows 上使用 mirai-console

1. 新建一个文件夹

在你想要安装的目录下新建一个文件夹名称随意;

在你新建的文件夹内再新建一个文件夹 libs

新建运行目录

2. 安装运行环境

运行 mirai-console 需要安装 Java 运行环境。安装 jre1.8 (或 jdk8) 以及更高版本都可以。(jdk8安装包下载地址: OneDrive ; jre1.8 安装包下载地址: OneDrive  )

安装完成后, 重启计算机。

在目录文件夹按住shift鼠标右键 在右键菜单里选择在此处打开 Powershell窗口, 输入 java -version 或者 java --version 然后回车, 查看是否正确安装 Java。正确安装 Java 并执行上面的指令后, 其结果应该如 下图 所示。

执行 java -version 截图

3. 下载 mirai-console&terminal&mirai-core

mirai-console 包含两个部分:前端和后端。后端是 mirai-console 的核心部分,包含插件系统、指令系统、配置系统等。前端则是和后端进行交互的部分。

下载mirai-console

向下划 建议选择最新版本后不带dev的版本

然后建议点击后带all.jar文件下载

下载mirai-console-terminal

下载规则建议同上

下载mirai-core

下载规则建议同上

4. 运行 mirai-console

将 mirai-console 的前端、后端以及 mirai-console-terminal 共三个文件都放在libs 同一个目录下

返回上级目录,然后在目录文件夹按住shift鼠标右键 在右键菜单里选择 在此处打开 Powershell窗口,后输入以下指令并回车启动 mirai-console

java -cp "./libs/*" net.mamoe.mirai.console.terminal.MiraiConsoleTerminalLoader
运行成功截图

二、在 Linux 上使用 mirai-console

1. 准备运行环境

更新软件包列表

#CentOS系统
yum update
#Debian/Ubuntu系统
sudo apt-get update

安装wget

#CentOS系统
yum install wget
#Debian/Ubuntu系统
apt-get install wget

安装 openjdk

#CentOS系统
yum install java-1.8.0-openjdk
yum install java-1.8.0-openjdk-devel
#Debian/Ubuntu系统
sudo apt-get install openjdk-8-jdk

java -version检查一下是否安装成功,能正常输出即可。

2. 新建运行目录

新建一个mirai目录然后在该目录下再创建libs目录

mkdir mirai
mkdir mirai/libs/ 
cd ./mirai/libs/

3. 下载 mirai-console&terminal&mirai-core

mirai-console 包含两个部分:前端和后端。后端是 mirai-console 的核心部分,包含插件系统、指令系统、配置系统等。前端则是和后端进行交互的部分。

下载mirai-console

向下划 建议选择最新版本后不带dev的版本

然后右键复制后带all.jar文件链接地址

然后返回控制台,输入wget 你刚刚复制的链接 如下

wget https://bintray.com/him188moe/mirai/download_file?file_path=net%2Fmamoe%2Fmirai-console%2F2.0-M2%2Fmirai-console-2.0-M2-all.jar

下载mirai-console-terminal

下载规则建议同上

下载mirai-core

下载规则建议同上

4. 运行 mirai-console

返回mirai目录

cd ./mirai/

输入下面代码开始运行

java -cp "./libs/*" net.mamoe.mirai.console.terminal.MiraiConsoleTerminalLoader $*

如下图则说明运行成功

运行成功截图

三、登录自己QQ的账号

成功运行后输入 login QQ账号 QQ密码

按照提示进行登录

如出现以下类似问题

Error(title=禁止登录, message=为了您的帐号安全,请使用QQ一键登录(通过手机QQ授权登录)。, errorInfo=)

Error(title=温馨提示, message=当前版本过低,请先升级到手机QQ最新版本。, errorInfo=)

解决方法

如果你的服务器是在外地甚至国外,请在本地常用登录地登录几天电脑QQ,然后在电脑上尝试登录,登录成功后将运行目录下生成的device.json上传至服务器替换再次尝试登录即可

文章在开源Android QQ协议库mirai使用教程(2020-08版本)上进行修改转载,在此感谢原作者


注意*这是一则由 Google AdSense 自动推荐的广告,不代表本站立场

寒蝉黎明之时,便是重生之日