mirai/docs

Mirai

欢迎来到 mirai 开发文档。

本文面向要进行开发的用户。对于只使用现成插件的用户，请阅读 用户手册。

Mirai 生态概览

社区 SDK

mirai 官方提供 Kotlin/Java 等 JVM 平台语言开发支持。如果不熟悉这些语言，请使用以下社区 SDK：

要使用这些社区 SDK 需要先配置 Mirai Console，可以使用 一键安装（32位，带 HTTP 插件），也可以阅读 用户手册 进行个性化安装。

你可以使用一个或多个语言来开发插件，而且在自己开发的同时也可以使用下载的插件。

原生接口

这些接口直接在 JVM 上实现，不需要中间件，拥有更佳的性能。

技术	维护者及项目地址
Kotlin Scripting	iTXTech/mirai-kts
C++	Nambers/MiraiCP
JavaScript	iTXTech/mirai-js
酷 Q DLL 插件	iTXTech/mirai-native

HTTP 接口

目前有两个 HTTP 协议插件。使用 HTTP 协议插件可以支持更多编程语言和技术。

• Mirai HTTP 由 Mirai 开发团队提供第一级支持，目前多数 SDK 都基于它；
• OneBot 标准则兼容原酷Q协议，可以让基于酷Q HTTP 插件的项目在 Mirai 平台运行。

名称	实现	维护者及项目地址
Mirai Http	Mirai 标准	mamoe/mirai-api-http
OneBot Http	OneBot 标准	yyuueexxiinngg/onebot-kotlin

下表列举基于 Mirai HTTP 插件实现对一些编程语言支持的项目列表。要使用它们，你需要在 Mirai Console 安装 mirai-api-http（如果使用上面的一键安装则不需要额外操作）。

语言和技术	维护者及项目地址
Python	Graia Framework
Python	NoneBot
Python	jerrita/saaya
C++	cyanray/mirai-cpp
C++	Chlorie/miraipp
C#	Executor-Cheng/mirai-CSharp
C#	Hyperai
C#	Coloryr/ColorMirai
Rust	HoshinoTented/mirai-rs
JavaScript / Node.js	RedBeanN/node-mirai
JavaScript / TypeScript	YunYouJun/mirai-ts
JavaScript / Node.js	drinkal/Mirai-js
Go	Logiase/gomirai
易语言	only52607/e-mirai

排名不分先后
想在这里添加你的项目？欢迎提交 PR。

特别地，有一些 SDK 直接基于 mirai-core 开发，不需要 mirai-console：

• Lua: lua-mirai

JVM 平台 Mirai 开发

本节介绍使用 Java、Kotlin 等 JVM 平台编程语言开发 Mirai 或 Mirai Console 插件。

为了避免遇到各种问题，请逐步仔细阅读。

1. JVM 环境和开发准备工作

2. 选择框架 建议先阅读 Mirai 生态概览。

   • 若要将 mirai 当做依赖库嵌入你的应用使用（你调用 mirai），则需要使用 mirai-core，请阅读 配置项目依赖。

   • 若要以插件模式开发（mirai 调用你），可以使用 mirai-console，请阅读 mirai-console 的配置插件项目。

3. 阅读 API 文档（见下文）

如果你希望先确认 mirai 能够正常运行才能安心阅读文档，可克隆 mirai-hello-world 并运行其中 Kotlin 或 Java 入口点 main。

之后...

• 让更多人看到你的项目 - 在论坛发布

mirai-core API 文档

请在 CoreAPI.md 阅读 JVM 平台的 mirai-core-api 使用文档。