---

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

这个项目的名字来源于

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

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

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

Mirai

English

QQ Android 协议支持库与高效率的机器人框架
纯 Kotlin 实现协议和支持框架
mirai 既可以作为项目中的 QQ 协议支持库, 也可以作为单独的应用程序与插件承载 QQ 机器人服务。

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

加入 , 或加入 QQ 群: ①群：655057127 (已满)； ②群：1101724738

协议支持

消息相关	支持
文字	群聊 | 好友 | 临时会话
原生表情	群聊 | 好友 | 临时会话
图片 上传 / 发送 / 解析 (最大 20M)	群聊 | 好友 | 临时会话
图片下载	群聊 | 好友 | 临时会话
XML, JSON 等富文本消息	群聊 | 好友 | 临时会话
长消息 (5000 字符 + 50 图片)	群聊
引用回复	群聊 | 好友 | 临时会话
撤回	群聊 | 好友 | 临时会话
At (含 At 全体成员)	群聊
撤回群员消息	群聊

群相关
完整群列表; 完整群成员列表
群员权限获取
禁言群员; 全员禁言; 禁言时间获取
群公告管理(获取, 发布, 删除)
群设置(自动审批, 入群公告, 坦白说, 成员邀请, 匿名聊天)
处理入群申请; 移除群员

好友相关
完整好友列表
处理新好友申请

不会支持的协议:

• 点赞
• 收付款
• 主动添加好友
• 主动加入群
• 主动邀请好友加群

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

开始

Mirai 目前为快速流转（Moving fast）状态, 增量版本之间可能不具有兼容性，任何功能都可能在没有警告的情况下添加、删除或者更改。

开发者

了解 mirai 架构： Wiki

使用 mirai 作为服务器，为 mirai 开发插件

• （官方）Java 或 Kotlin： 为 mirai-console 直接编写插件并与其他插件开发者合作共享
• （官方）C, C++ 等原生语言： mirai-native 支持酷Q插件在mirai上运行
• （社区）Python: python-mirai 基于 mirai-api-http 的机器人开发框架
• （社区）JavaScript(Node.js): node-mirai mirai 的 Node.js SDK
• （社区）Go: gomirai 基于 mirai-api-http 的 GoLang SDK
• （社区）Mozilla Rhino: mirai-rhinojs-sdk
• （社区）Lua: lua-mirai
• （官方）其他任意语言：使用由 mirai-api-http 提供的 http 接口进行接入

使用 mirai 为第三方依赖库引入项目

Demos: mirai-demos

• Kotlin 简略版： Mirai Guide - Quick Start
• Kotlin 新手版： Mirai Guide - Getting Started
• Java： 查看上述 Demos

使用者

• mirai-console 支持插件 本模块正在完善

其他平台的使用者

• 酷Q的插件可以在 mirai 中加载, 详见 Mirai-Native
• 使用 酷Q HTTP API 的插件将可以在 mirai 中加载，Mirai-CQ-Adapter 正在进行中

更新日志

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

贡献

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

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

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

鸣谢

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

许可证

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

其中部分要求:

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

---

Copyright (C) 2019-2020 mamoe and Mirai contributors

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.