Mirai

English

多平台 TIM PC 和 QQ Android 协议支持库.
纯 Kotlin 实现协议和支持框架，模块全部开源。
目前可运行在 JVM 或 Android。

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

加入 Gitter, 或加入 QQ 群: 655057127

CHANGELOG

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

Modules

mirai-core

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

mirai-core-timpc

TIM PC （2.3.2 版本，2019 年 8 月）协议的实现，相较于 core，仅新增少量 API. 详见 README.md
支持的功能：

• 消息收发：图片文字复合消息，图片消息
• 群管功能：群员列表，禁言

（目前不再更新此协议，请关注下文的安卓协议）

mirai-core-qqandroid

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

• 高兼容性：协议仅含极少部分为硬编码，其余全部随官方方式动态生成
• 高安全性：密匙随机，ECDH 动态计算

Use directly

直接使用 Mirai(终端环境/网页面板（将来））.
Mirai-Console 插件支持, 在终端中启动 Mirai 并获得机器人服务
本模块还未完善。

Use as a library

mirai-core 为独立设计, 可以作为库内置于任意 Java(JVM)/Android 项目中使用.

Gradle

Mirai 只发布在 jcenter, 因此请确保在 build.gradle 添加 jcenter() 仓库：

repositories{
  jcenter()
}

若您需要使用在跨平台项目, 则要对各个目标平台添加不同的依赖，这与 kotlin 相关跨平台库的依赖是类似的。
若您只需要使用在单一平台, 则只需要添加一项该平台的依赖. 如只在 JVM 运行则只需要-jvm的依赖

请将 VERSION 替换为最新的版本(如 0.10.6):
Mirai 目前还处于实验性阶段, 我们无法保证任何稳定性, API 也可能会随时修改.

注意： Mirai 核心由 API 模块（mirai-core）和协议模块组成。
只添加 API 模块将无法正常工作。
现在只推荐使用 TIMPC 协议，请参照下文选择对应目标平台的依赖添加。

common

implementation("net.mamoe:mirai-core-timpc-common:VERSION")

jvm

implementation("net.mamoe:mirai-core-timpc-jvm:VERSION")

android

implementation("net.mamoe:mirai-core-timpc-android:VERSION")

Performance

Android 上, Mirai 运行需使用 80M 内存.
JVM 上需 120M-150M 内存

Contribution

我们 (Mamoe, NaturalHG & Him188) 将会一直维护这个项目，除非遇到不可抗力因素。

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

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

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

Wiki

在 Wiki 中查看各类帮助，如 API 示例（可能过时，待 QQ Android 协议完成后会重写）。

Try

On JVM or Android

现在体验低付出高效率的 Mirai

val bot = TIMPC.Bot(qqId, password).alsoLogin()
bot.subscribeMessages {
  "你好" reply "你好!"
  "profile" reply { sender.queryProfile() }
  contains("图片"){ File(imagePath).send() }
}
bot.subscribeAlways<MemberPermissionChangedEvent> {
  if (it.kind == BECOME_OPERATOR)
    reply("${it.member.id} 成为了管理员")
}

我们也考虑到了 Java 兼容的问题，这正在计划中，但不是高优先的。

1. Clone
2. Import as Gradle project
3. 运行 Demo 程序: mirai-demo 示例和演示程序

Build Requirements

• Kotlin 1.3.61
• JDK 8 (required)
• JDK 11（for protocol tools, optional）
• Android SDK 29 (for Android target, optional)

Libraries used

感谢:

• kotlin-stdlib
• kotlinx-coroutines
• kotlinx-io
• kotlin-reflect
• pcap4j
• atomicfu
• ktor
• tornadofx
• javafx
• kotlinx-serialization
• bouncycastle

License

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

其中部分要求:

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

Acknowledgement

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