----

Mirai 是一个在全平台下运行，提供 QQ Android 和 TIM PC 协议支持的高效率机器人框架

这个项目的名字来源于

京都动画作品《境界的彼方》的栗山未来(Kuriyama Mirai)

CRYPTON以初音未来为代表的创作与活动(Magical Mirai)

图标以及形象由画师DazeCake绘制

Mirai

English

多平台 QQ Android 和 TimPC 协议支持库与高效率的机器人框架.
纯 Kotlin 实现协议和支持框架，模块全部免费开源。
目前可运行在 JVM 或 Android。 Mirai既可以作为你项目中的QQ协议支持Lib, 也可以作为单独的Application与插件承载QQ机器人

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

加入 Gitter, 或加入 QQ 群: 655057127

开始使用Mirai

Mirai支持以多种方式进行部署，但是目前，我们在集中对mirai-core，mirai-japt以及mirai-api-http等核心模块进行特性的开发，对于非开发者的使用暂时不做过多支持，仅展示开发计划。

开发者

• 假如你熟悉Kotlin及包管理工具，请参阅Mirai Guide - Quick Start
• 假如你不熟悉Kotlin，希望一份较详细的起步教程，请参阅Mitai Guide - Getting Started
• 假如你使用Java作为开发语言，请参阅mirai-japt
• 假如你是其他平台开发者，可以通过了解 mirai-api-http 进行接入，欢迎开发不同平台的mirai-sdk
• 此外，你还可以在 Wiki 中查看各类帮助，如 API 示例。

使用者

• mirai-console 支持插件, 在终端中启动 Mirai 并获得机器人服务，本模块还未完善，请耐心等待开发完成。
• Mirai-WebPenel 支持Web控制台，以网页形式管理机器人。本模块在计划中，在其他模块稳定后即将开启开发。

CHANGELOG

在 Project 查看已支持功能和计划 在 CHANGELOG 查看版本更新记录 (仅发布的版本)

Modules

mirai-core

通用 API 模块，一套 API 适配两套协议。
请参考此模块的 API

mirai-core-qqandroid

QQ for Android （8.2.0 版本，2019 年 12 月）协议的实现，目前完成大部分。

• 高兼容性：协议仅含极少部分为硬编码，其余全部随官方方式动态生成
• 高安全性：密匙随机，ECDH 动态计算
• 已支持大部分使用场景, 详情请在Project查看

mirai-core-timpc

TIM PC （2.3.2 版本，2019 年 8 月）协议的实现
支持的功能：

• 消息收发：图片文字复合消息，图片消息
• 群管功能：群员列表，禁言 （目前不再更新此协议，请关注上文的安卓协议）

Contribution

我们欢迎一切形式的贡献。
我们也期待有更多人能加入 Mirai 的开发。

若在使用过程中有任何疑问, 可提交 issue 或是邮件联系(support@mamoe.net). 我们希望 Mirai 变得更易用.

您的 star 是对我们最大的鼓励(点击项目右上角)

Libraries used

感谢:

• kotlin-stdlib
• kotlinx-coroutines
• kotlinx-io
• kotlin-reflect
• pcap4j
• atomicfu
• ktor
• tornadofx
• javafx
• kotlinx-serialization
• bouncycastle
• lanterna
• fastjson
• toml4j
• snakeyaml

License

协议原版权归属腾讯科技股份有限公司所有，本项目其他代码遵守：
GNU AFFERO GENERAL PUBLIC LICENSE version 3

其中部分要求:

• (见 LICENSE 第 13 节) 尽管本许可协议有其他规定，但如果您修改本程序，则修改后的版本必须显着地为所有通过计算机网络与它进行远程交互的用户（如果您的版本支持这种交互）提供从网络服务器通过一些标准或惯用的软件复制方法免费访问相应的源代码的机会
• (见 LICENSE 第 4 节) 您可以免费或收费地传递这个项目的源代码或目标代码(即编译结果), 但前提是提供明显的版权声明 (您需要标注本 GitHub 项目地址)

Acknowledgement

特别感谢 JetBrains 为开源项目提供免费的 IntelliJ IDEA 等 IDE 的授权