Home

欢迎来到 Mirai Native 的 Wiki 页面。

Mirai Native Wiki, built by PeratX.
Copyright (C) 2020 iTX Technologies All Rights Reserved.

Mirai Native 开发文档

Mirai Native 酷Q 兼容性信息

致开发者

• 插件字符串编码采用 GB18030
• Mirai Native 内部使用了非阻塞，协程实现具体功能，调用所有API都立即返回，但是也有劣势，比如无法得知消息是否发送成功
• Mirai Native 正在建设插件中心，如果您的插件想要在上面列出，您的插件必须遵循AGPLv3协议开源
• Mirai Native支持运行时重新载入插件文件，要求插件文件名结尾为 .dev.dll

使用 Mirai Native

运行环境

• Java 8以上 32位，Windows环境，支持wine
• 可能需要管理员权限，因为需要在Java目录下创建数据文件夹，如果不想授权管理员权限，请将JRE移动到不需要管理员权限的目录下
• 待 Bot 上线后才会调用插件的 eventStartup 和 eventEnable 事件，托班菜单内才可以禁用插件

安装 Mirai Native

1. 从 Releases 获取 mirai-native-x.x.x.jar
2. 将其放置到 mirai console 运行目录的 plugins 目录下

Mirai Native 目录结构

└─MiraiNative
    │  config.json // Mirai Native 配置文件
    │  CQP.dll // Mirai Native Bridge
    │
    ├─data // 原生插件数据文件夹
    │  ├─io.github.richardchien.coolqhttpapi // CQHTTP数据文件夹
    │  └─net.peratx.tester // Mirai Native API Tester数据文件夹
    │
    ├─libraries // 原生插件依赖的dll文件，最先被 Mirai Native加载
    │      libiconv.dll // 被 CQHTTP 依赖
    │      sqlite3.dll // 被 CQHTTP 依赖
    │
    └─plugins // 插件文件夹
            http.dll // CQHTTP插件dll
            http.json // CQHTTP插件json
            test.dll // Tester dll
            test.json // Tester json

如何获取及安装CQHTTP

1. 从CQHTTP下载DLL和JSON文件
2. 将 libiconv.dll 和 sqlite3.dll 放入 MiraiConsole\plugins\MiraiNative\libraries 文件夹
3. 将 http.dll和http.json 放入 MiraiConsole\plugins\MiraiNative\plugins 文件夹
4. 启动 mirai console

重要：如果你正在使用控制台版Mirai-console(Pure)则需要进行以下步骤

1. 完成上述安装过程并登录账号，你将会看到，此时控制台大概率会卡死

12:45:02 [INFO] [MiraiNative] [CQHTTP 配置] 没有找到配置文件，写入默认配置
12:45:02 [INFO] [MiraiNative] [CQHTTP 配置] 已加载的配置：

2. 关闭软件
3. 在CQHTTP的配置文件内进行以下修改

"show_log_console": false,    //不弹出独立控制台
"disable_coolq_log": false    //取消禁言酷Q日志系统，此设置项目可能需要手动添加

除以上修改外请按照你的需求自行修改其他配置项目

4. 开启软件并完成登录，你会在mirai-console的控制台看到类似以下的内容

 12:51:08 [INFO] [MiraiNative] [CQHTTP 日志] 日志系统初始化完成
 12:51:08 [INFO] [MiraiNative] [CQHTTP 日志] 请在 酷Q 主目录的 MiraiNative\data\io.github.richardchien.coolqhttpapi\log\ 中查看日志文件
 12:51:08 [INFO] [MiraiNative] [CQHTTP HTTP] 开启 HTTP 服务器成功，开始监听 http://[::]:5700

5. 配置完成