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 并执行上面的指令后, 其结果应该如 下图 所示。
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-jdkjava -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版本)上进行修改转载，在此感谢原作者
