Merge remote-tracking branch 'origin/master'

CHANGELOG.md

@@ -2,6 +2,53 @@
 
 开发版本. 频繁更新, 不保证高稳定性
 
+## `0.17.0` 2020/2/20
+
+### mirai-core
+- 支持原生表情 `Face`
+- 修正 `groupCardOrNick` 为 `nameCardOrNick`
+- 增加 `MessageChain.foreachContent(lambda)` 和 `Message.hasContent(): Boolean`
+
+### mirai-core-qqandroid
+- 提高重连速度
+- 修复重连后某些情况不会心跳
+- 修复收包时可能产生异常
+
+## `0.16.0` 2020/2/19
+
+### mirai-core
+- 添加 `Bot.subscribe` 等筛选 Bot 实例的监听方法
+- 其他一些小问题修复
+
+### mirai-core-qqandroid
+- 优化重连处理逻辑
+- 确保好友消息和历史事件在初始化结束前同步完成
+- 同步好友消息记录时不广播
+
+## `0.15.5` 2020/2/19
+
+### mirai-core
+- 为 `MiraiLogger` 添加 common property `val isEnabled: Boolean`
+- 修复 #62: 掉线重连后无 heartbeat
+- 修复 #65: `Bot` close 后仍会重连
+- 修复 #70: ECDH is not available on Android platform
+
+### mirai-core-qqandroid
+- 从服务器收到的事件将会额外使用 `bot.logger` 记录 (verbose).
+- 降低包记录的等级: `info` -> `verbose`
+- 改善 `Bot` 的 log 记录
+- 加载好友列表失败时会重试
+- 改善 `Bot` 或 `NetworkHandler` 关闭时取消 job 的逻辑
+- 修复初始化(init)时同步历史好友消息时出错的问题
+
+## `0.15.4` 2020/2/18
+
+- 放弃使用 `atomicfu` 以解决其编译错误的问题. (#60)
+
+## `0.15.3` 2020/2/18
+
+- 修复无法引入依赖的问题.
+
 ## `0.15.2` 2020/2/18
 
 ### mirai-core

README.md

 <div align="center">
- 
+
+
+
    <img width="160" src="http://img.mamoe.net/2020/02/16/a759783b42f72.png" alt="logo"></br>
+
    <img width="95" src="http://img.mamoe.net/2020/02/16/c4aece361224d.png" alt="title">
 ----
+
 [![Gitter](https://badges.gitter.im/mamoe/mirai.svg)](https://gitter.im/mamoe/mirai?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
 [![Actions Status](https://github.com/mamoe/mirai/workflows/CI/badge.svg)](https://github.com/mamoe/mirai/actions)
 [![Download](https://api.bintray.com/packages/him188moe/mirai/mirai-core/images/download.svg)](https://bintray.com/him188moe/mirai/mirai-core/)  
@@ -16,6 +20,7 @@ Mirai 是一个在全平台下运行，提供 QQ Android 和 TIM PC 协议支持
 </div>
 
 ## Mirai
+
 **[English](README-eng.md)**  
 
 多平台 **QQ Android 和 TimPC** 协议支持库与高效率的机器人框架.   
@@ -27,94 +32,59 @@ Mirai既可以作为你项目中的QQ协议支持Lib, 也可以作为单独的Ap
 
 加入 Gitter, 或加入 QQ 群: 655057127
 
+
+
+## 开始使用Mirai
+
+Mirai支持以多种方式进行部署，但是目前，我们在集中对mirai-core，mirai-japt以及mirai-api-http等核心模块进行特性的开发，对于非开发者的使用暂时不做过多支持，仅展示开发计划。
+
+### 开发者
+
+- 假如你熟悉Kotlin及包管理工具，请参阅[Mirai Guide - Quick Start](/docs/guide_quick_start.md)
+- 假如你不熟悉Kotlin，希望一份较详细的起步教程，请参阅[Mirai Guide - Getting Started](/docs/guide_getting_started.md)
+- 假如你使用Java作为开发语言，请参阅[mirai-japt](/mirai-japt/README.md)
+- 假如你是其他平台开发者，可以通过了解 [mirai-api-http](https://github.com/mamoe/mirai/tree/master/mirai-api-http) 进行接入，欢迎开发不同平台的mirai-sdk
+- 此外，你还可以在 [Wiki](https://github.com/mamoe/mirai/wiki/Home) 中查看各类帮助，**如 API 示例**。
+
+### 使用者
+
+- [mirai-console](https://github.com/mamoe/mirai/tree/master/mirai-console) 支持插件, 在终端中启动 Mirai 并获得机器人服务，**本模块还未完善**，请耐心等待开发完成。
+- mirai-webpanel Mirai的Web控制台，支持在网页中管理机器人与插件。本模块目前在计划中。在其他模块稳定后，将开始进行开发。
+
+
+
 ## CHANGELOG
+
 在 [Project](https://github.com/mamoe/mirai/projects/3) 查看已支持功能和计划
 在 [CHANGELOG](https://github.com/mamoe/mirai/blob/master/CHANGELOG.md) 查看版本更新记录 (仅发布的版本)
 
+
+
 ## Modules
+
 ### mirai-core
+
 通用 API 模块，一套 API 适配两套协议。  
 **请参考此模块的 API**  
-  
+
 ### mirai-core-qqandroid
+
   QQ for Android （8.2.0 版本，2019 年 12 月）协议的实现，目前完成大部分。   
+
   - 高兼容性：协议仅含极少部分为硬编码，其余全部随官方方式动态生成
   - 高安全性：密匙随机，ECDH 动态计算
   - 已支持大部分使用场景, 详情请在[Project](https://github.com/mamoe/mirai/projects/3)查看
 
 ### mirai-core-timpc
-TIM PC （2.3.2 版本，2019 年 8 月）协议的实现，相较于 core，仅新增少量 API. 详见 [README.md](mirai-core-timpc/)   
+
+TIM PC （2.3.2 版本，2019 年 8 月）协议的实现  
 支持的功能： 
+
 - 消息收发：图片文字复合消息，图片消息
 - 群管功能：群员列表，禁言
-（目前不再更新此协议，请关注上文的安卓协议）
+  （目前不再更新此协议，请关注上文的安卓协议）
 
-## Use directly
-**直接使用 Mirai(终端环境/网页面板（将来））.**  
-[Mirai-Console](https://github.com/mamoe/mirai/tree/master/mirai-console) 插件支持, 在终端中启动 Mirai 并获得机器人服务  
-本模块还未完善。
 
-## Use as a library
-**mirai-core 为独立设计, 可以作为库内置于任意 Java(JVM)/Android 项目中使用.**
-
-请将 `VERSION` 替换为最新的版本(如 `0.15.0`):
-[![Download](https://api.bintray.com/packages/him188moe/mirai/mirai-core/images/download.svg)](https://bintray.com/him188moe/mirai/mirai-core/)  
-**Mirai 目前还处于实验性阶段, 我们无法保证任何稳定性, API 也可能会随时修改.**
-
-### Maven
-Kotlin 在 Maven 上只支持 JVM 平台.
-```xml
-<repositories>
-    <repository>
-        <id>jcenter</id>
-        <url>https://jcenter.bintray.com/</url>
-    </repository>
-</repositories>
-```
-```xml
-<dependencies>
-    <dependency>
-        <groupId>net.mamoe</groupId>
-        <artifactId>mirai-core-qqandroid</artifactId>
-        <version>0.15.1</version> <!-- 替换版本为最新版本 -->
-    </dependency>
-</dependencies>
-```
-
-### Gradle
-Mirai 只发布在 `jcenter`, 因此请确保添加 `jcenter()` 仓库：
-```kotlin
-repositories{
-  jcenter()
-}
-```
-若您需要使用在跨平台项目, 则要对各个目标平台添加不同的依赖，这与 kotlin 相关多平台库的依赖是类似的。  
-**若您只需要使用在单一平台, 则只需要添加一项该平台的依赖.**
-
-**注意：**
-Mirai 核心由 API 模块（`mirai-core`）和协议模块组成。  
-只添加 API 模块将无法正常工作。  
-现在只推荐使用 QQAndroid 协议，请参照下文选择对应目标平台的依赖添加。
-
-**jvm** (JVM 平台)
-```kotlin
-implementation("net.mamoe:mirai-core-qqandroid:VERSION")
-```
-**common** (通用平台)
-```kotlin
-implementation("net.mamoe:mirai-core-qqandroid-common:VERSION")
-```
-**android** (Android 平台)
-```kotlin
-implementation("net.mamoe:mirai-core-qqandroid-android:VERSION")
-```
-
-## Java Compatibility
-**若你希望使用 Java 开发**, 请查看: [mirai-japt](mirai-japt/README.md)
-
-### Performance
-Android 上, Mirai 运行需使用 80M 内存.  
-JVM 上启动需 80M 内存, 每多一个机器人实例需要 30M 内存.
 
 ## Contribution
 
@@ -125,41 +95,12 @@ JVM 上启动需 80M 内存, 每多一个机器人实例需要 30M 内存.
 
 您的 star 是对我们最大的鼓励(点击项目右上角)
 
-## Wiki
-在 [Wiki](https://github.com/mamoe/mirai/wiki/Home) 中查看各类帮助，**如 API 示例**（可能过时，待 QQ Android 协议完成后会重写）。
-
-## Try
-
-### On JVM or Android
-现在体验低付出高效率的 Mirai
-
-```kotlin
-val bot = 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} 成为了管理员")
-}
-```
 
-1. Clone
-2. Import as Gradle project
-3. 运行 Demo 程序: [mirai-demo](#mirai-demo) 示例和演示程序
 
+## Libraries used
 
-## 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](https://github.com/JetBrains/kotlin)
 - [kotlinx-coroutines](https://github.com/Kotlin/kotlinx.coroutines)
 - [kotlinx-io](https://github.com/Kotlin/kotlinx-io)
@@ -176,15 +117,21 @@ bot.subscribeAlways<MemberPermissionChangedEvent> {
 - [toml4j](https://github.com/mwanji/toml4j)
 - [snakeyaml](https://mvnrepository.com/artifact/org.yaml/snakeyaml)
 
+
+
 ## License
+
 协议原版权归属腾讯科技股份有限公司所有，本项目其他代码遵守：  
 **GNU AFFERO GENERAL PUBLIC LICENSE version 3**  
 
 其中部分要求:  
+
 - (见 LICENSE 第 13 节) 尽管本许可协议有其他规定，但如果您修改本程序，则修改后的版本必须显着地为所有通过计算机网络与它进行远程交互的用户（如果您的版本支持这种交互）提供从网络服务器通过一些标准或惯用的软件复制方法**免费**访问相应的**源代码**的机会
 - (见 LICENSE 第 4 节) 您可以免费或收费地传递这个项目的源代码或目标代码(即编译结果), **但前提是提供明显的版权声明** (您需要标注本 `GitHub` 项目地址)
 
+
+
 ## Acknowledgement
+
 特别感谢 [JetBrains](https://www.jetbrains.com/?from=mirai) 为开源项目提供免费的 [IntelliJ IDEA](https://www.jetbrains.com/idea/?from=mirai) 等 IDE 的授权  
-[<img src=".github/jetbrains-variant-3.png" width="200"/>](https://www.jetbrains.com/?from=mirai)
- 
+[<img src=".github/jetbrains-variant-3.png" width="200"/>](https://www.jetbrains.com/?from=mirai)
\ No newline at end of file
\ No newline at end of file

docs/guide_getting_started.md

+# Mirai Guide - Getting Started
+
+由于Mirai项目在快速推进中，因此内容时有变动，本文档的最后更新日期为```2020-02-20```，对应版本```0.17.0```
+
+假如仅仅使用Mirai，不需要对整个项目进行Clone，只需在项目内添加Gradle Dependency或使用即可。
+
+下面介绍详细的入门步骤。
+
+本页采用Kotlin作为开发语言，**若你希望使用 Java 开发**, 请参阅: [mirai-japt](mirai-japt/README.md)
+
+## Use Console
+
+使用mirai-console，以插件形式对服务器功能进行管理，启动无需任何IDE。
+
+**由于mirai-console还没有开发完成，暂时不提供入门**
+
+## Use Loader
+
+通过编写Kotlin程序启动mirai-core，并定义你的Mirai Bot行为。
+
+假如已经对Gradle有一定了解，可跳过1，2
+
+### 1 安装IDEA与JDK
+
+JDK要求6以上
+
+### 2 新建Gradle项目
+
+- 在```File->new project```中选择```Gradle```
+- 在面板中的```Additional Libraries and Frameworks```中勾选```Java```以及```Kotlin/JVM```
+- 点击```next```，填入```GroupId```与```ArtifactId```(对于测试项目来说，可随意填写)
+- 点击```next```，点击```Use default gradle wrapper(recommended)```
+- 创建项目完成
+
+### 3 添加依赖
+
+- 打开项目的```Project```面板，点击编辑```build.gradle```
+
+- 首先添加repositories
+
+  ```groovy
+  //添加jcenter仓库
+  /*
+  repositories {
+      mavenCentral()
+  }
+  原文内容，更新为下文
+  */
+  
+  repositories {
+      mavenCentral()
+      jcenter()
+  }
+  ```
+
+- 添加依赖，将dependencies部分覆盖。 `mirai-core` 的最新版本为: [![Download](https://api.bintray.com/packages/him188moe/mirai/mirai-core/images/download.svg)](https://bintray.com/him188moe/mirai/mirai-core/)  
+
+  ```groovy
+  dependencies {
+      implementation 'net.mamoe:mirai-core-qqandroid-jvm:0.17.0'//此处版本应替换为当前最新
+      implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8"
+      testCompile group: 'junit', name: 'junit', version: '4.12'
+  }
+  ```
+
+- 打开右侧Gradle面板，点击刷新按钮
+- 至此，依赖添加完成
+
+### 4 Try Bot
+
+- 在src/main文件夹下新建文件夹，命名为```kotlin```
+- 在```kotlin```下新建包(在```kotlin```文件夹上右键-```New```-```Packages```) 包名为```net.mamoe.mirai.simpleloader```
+
+- 在包下新建kotlin文件```MyLoader.kt```
+
+```kotlin
+package net.mamoe.mirai.simpleloader
+
+import kotlinx.coroutines.*
+import net.mamoe.mirai.Bot
+import net.mamoe.mirai.alsoLogin
+import net.mamoe.mirai.event.subscribeMessages
+
+suspend fun main() {
+    val qqId = 10000L//Bot的QQ号，需为Long类型，在结尾处添加大写L
+    val password = "your_password"//Bot的密码
+    val miraiBot = Bot(qqId, password).alsoLogin()//新建Bot并登录
+    miraiBot.subscribeMessages {
+        "你好" reply "你好!"
+        case("at me") {
+            reply(sender.at() + " 给爷爬 ")
+        }
+
+        (contains("舔") or contains("刘老板")) {
+            "刘老板太强了".reply()
+        }
+    }
+    miraiBot.join() // 等待 Bot 离线, 避免主线程退出
+}
+```
+
+- 单击编辑器内第8行(```suspend fun main```)左侧的run按钮(绿色三角)，等待，MiraiBot成功登录。
+- 本例的功能中，在任意群内任意成员发送包含“舔”字或“刘老板”字样的消息，MiraiBot会回复“刘老板太强了”
+
+
+
+至此，简单的入门已经结束，下面可根据不同的需求参阅wiki进行功能的添加。
+
+
+### 此外，还可以使用Maven作为包管理工具
+本项目推荐使用gradle，因此不提供详细入门指导
+
+```xml
+<repositories>
+    <repository>
+        <id>jcenter</id>
+        <url>https://jcenter.bintray.com/</url>
+    </repository>
+</repositories>
+```
+```xml
+<dependencies>
+    <dependency>
+        <groupId>net.mamoe</groupId>
+        <artifactId>mirai-core-qqandroid-jvm</artifactId>
+        <version>0.17.0</version> <!-- 替换版本为最新版本 -->
+    </dependency>
+</dependencies>
+```

docs/guide_quick_start.md

+# Mirai Guide - Quick Start
+
+由于Mirai项目在快速推进中，因此内容时有变动，本文档的最后更新日期为```2020-02-20```，对应版本```0.17.0```
+
+本文适用于对kotlin较熟悉的开发者
+
+**若你希望一份更为基础且详细的guide**, 请参阅: [mirai-guide-getting-started](guide_getting_started.md)
+
+**若你希望使用 Java 开发**, 请参阅: [mirai-japt](/mirai-japt/README.md)
+
+## Build Requirements
+
+- Kotlin 1.3.61 
+- JDK 6 (required)
+- JDK 11（for protocol tools, optional）
+- Android SDK 29 (for Android target, optional)
+
+## Use directly
+
+**直接使用 Mirai(终端环境/网页面板（将来））.**  
+[Mirai-Console](https://github.com/mamoe/mirai/tree/master/mirai-console) 插件支持, 在终端中启动 Mirai 并获得机器人服务  
+本模块还未完善。
+
+## Use as a library
+
+**mirai-core 为独立设计, 可以作为库内置于任意 Java(JVM)/Android 项目中使用.**
+
+请将 `VERSION` 替换为最新的版本(如 `0.15.0`):
+[![Download](https://api.bintray.com/packages/him188moe/mirai/mirai-core/images/download.svg)](https://bintray.com/him188moe/mirai/mirai-core/)  
+**Mirai 目前还处于实验性阶段, 我们无法保证任何稳定性, API 也可能会随时修改.**
+
+### Maven
+
+Kotlin 在 Maven 上只支持 JVM 平台.
+
+```xml
+<repositories>
+    <repository>
+        <id>jcenter</id>
+        <url>https://jcenter.bintray.com/</url>
+    </repository>
+</repositories>
+```
+
+```xml
+<dependencies>
+    <dependency>
+        <groupId>net.mamoe</groupId>
+        <artifactId>mirai-core-qqandroid-jvm</artifactId>
+        <version>0.15.1</version> <!-- 替换版本为最新版本 -->
+    </dependency>
+</dependencies>
+```
+
+### Gradle
+
+Mirai 只发布在 `jcenter`, 因此请确保添加 `jcenter()` 仓库：
+
+```kotlin
+repositories{
+  jcenter()
+}
+```
+
+若您需要使用在跨平台项目, 则要对各个目标平台添加不同的依赖，这与 kotlin 相关多平台库的依赖是类似的。  
+**若您只需要使用在单一平台, 则只需要添加一项该平台的依赖.**
+
+**注意：**
+Mirai 核心由 API 模块（`mirai-core`）和协议模块组成。  
+只添加 API 模块将无法正常工作。  
+现在只推荐使用 QQAndroid 协议，请参照下文选择对应目标平台的依赖添加。
+
+**jvm** (JVM 平台)
+
+```kotlin
+implementation("net.mamoe:mirai-core-qqandroid-jvm:VERSION")
+```
+
+**common** (通用平台)
+
+```kotlin
+implementation("net.mamoe:mirai-core-qqandroid-common:VERSION")
+```
+
+**android** (Android 平台)
+
+```kotlin
+implementation("net.mamoe:mirai-core-qqandroid-android:VERSION")
+```
+
+## Try
+
+### On JVM or Android
+
+现在体验低付出高效率的 Mirai
+
+```kotlin
+val bot = 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} 成为了管理员")
+}
+```
+
+### Performance
+
+Android 上, Mirai 运行需使用 80M 内存.  
+JVM 上启动需 80M 内存, 每多一个机器人实例需要 30M 内存.
+

gradle.properties

 # style guide
 kotlin.code.style=official
 # config
-mirai_version=0.15.2
+mirai_version=0.17.0
 mirai_japt_version=1.0.1
 kotlin.incremental.multiplatform=true
 kotlin.parallel.tasks.in.project=true

gradle/publish.gradle

@@ -94,7 +94,7 @@ publishing {
                 it.artifactId = "$project.name-common"
                 break
             case 'jvm':
-                it.artifactId = "${project.name.replace("-jvm", "")}"
+                it.artifactId = "$project.name-jvm"
                 break
             case 'js':
             case 'native':

gradle/wrapper/gradle-wrapper.properties

 #Thu Feb 06 14:10:33 CST 2020
-distributionUrl=https\://services.gradle.org/distributions/gradle-6.1.1-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-6.2-all.zip
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 zipStorePath=wrapper/dists

mirai-api-http/README_CH.md

@@ -12,10 +12,12 @@ fun main() {
 
     MiraiHttpAPIServer.start()
     
-    bot.network.awaitDisconnection()
+    bot.join()
 }
 ```
 
+
+
 ## 认证相关
 
 ### 开始会话-认证(Authorize)
@@ -141,6 +143,8 @@ fun main() {
 > SessionKey与Bot 对应错误时将会返回状态码5：指定对象不存在
 
 
+
+
 ## 消息相关
 
 
@@ -261,10 +265,10 @@ fun main() {
 ### 发送图片消息（通过URL）
 
 ```
-[POST] /sendGroupMessage
+[POST] /sendImageMessage
 ```
 
-使用此方法向指定群发送消息
+使用此方法向指定对象（群或好友）发送图片消息
 
 #### 请求
 
@@ -303,7 +307,7 @@ fun main() {
 ### 图片文件上传
 
 ```
-[POST] /sendGroupMessage
+[POST] /uploadImage
 ```
 
 使用此方法上传图片文件至服务器并返回ImageId
@@ -414,10 +418,10 @@ Content-Type：multipart/form-data
 }
 ```
 
-| 名字    | 类型   | 说明                      |
-| ------- | ------ | ------------------------- |
-| target  | Long   | 群员QQ号                  |
-| display | String | @时显示的文本如："@Mirai" |
+| 名字    | 类型   | 说明                                           |
+| ------- | ------ | ---------------------------------------------- |
+| target  | Long   | 群员QQ号                                       |
+| dispaly | String | At时显示的文字，发送消息时无效，自动使用群名片 |
 
 #### AtAll
 
@@ -463,7 +467,7 @@ Content-Type：multipart/form-data
 {
     "type": "Image",
     "imageId": "{01E9451B-70ED-EAE3-B37C-101F1EEBF5B5}.png" //群图片格式
-    "imageId": "/f8f1ab55-bf8e-4236-b55e-955848d7069f"      //好友图片格式
+    //"imageId": "/f8f1ab55-bf8e-4236-b55e-955848d7069f"      //好友图片格式
 }
 ```
 
@@ -517,6 +521,7 @@ Content-Type：multipart/form-data
 ```
 
 
+
 ### 获取群列表
 
 使用此方法获取bot的群列表
@@ -786,6 +791,8 @@ Content-Type：multipart/form-data
 }
 ```
 
+
+
 ### 获取群设置
 
 使用此方法获取群设置
@@ -816,6 +823,7 @@ Content-Type：multipart/form-data
 ```
 
 
+
 ### 修改群员资料
 
 使用此方法修改群员资料（需要有相关限权）
@@ -856,6 +864,8 @@ Content-Type：multipart/form-data
 }
 ```
 
+
+
 ### 获取群员资料
 
 使用此方法获取群员资料

mirai-api-http/src/main/kotlin/net/mamoe/mirai/api/http/Session.kt

@@ -13,6 +13,8 @@ import kotlinx.coroutines.*
 import net.mamoe.mirai.Bot
 import net.mamoe.mirai.api.http.queue.MessageQueue
 import net.mamoe.mirai.event.Listener
+import net.mamoe.mirai.event.events.BotEvent
+import net.mamoe.mirai.event.subscribeAlways
 import net.mamoe.mirai.event.subscribeMessages
 import net.mamoe.mirai.message.MessagePacket
 import kotlin.coroutines.CoroutineContext
@@ -102,12 +104,10 @@ class TempSession internal constructor(coroutineContext: CoroutineContext) : Ses
 class AuthedSession internal constructor(val bot: Bot, coroutineContext: CoroutineContext) : Session(coroutineContext) {
 
     val messageQueue = MessageQueue()
-    private val _listener: Listener<MessagePacket<*, *>>
+    private val _listener: Listener<BotEvent>
 
     init {
-        bot.subscribeMessages {
-            _listener = always { this.run(messageQueue::add) } // this aka messagePacket
-        }
+        _listener = bot.subscribeAlways{ this.run(messageQueue::add) }
     }
 
     override fun close() {

mirai-api-http/src/main/kotlin/net/mamoe/mirai/api/http/data/common/BotEventDTO.kt

+package net.mamoe.mirai.api.http.data.common
+
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
+import net.mamoe.mirai.contact.MemberPermission
+import net.mamoe.mirai.event.events.BotEvent
+import net.mamoe.mirai.event.events.*
+import net.mamoe.mirai.message.MessagePacket
+import net.mamoe.mirai.utils.MiraiExperimentalAPI
+
+@Serializable
+sealed class BotEventDTO : EventDTO()
+
+@UseExperimental(MiraiExperimentalAPI::class)
+fun BotEvent.toDTO() = when(this) {
+    is MessagePacket<*, *> -> toDTO()
+    else -> when(this) {
+        is BotOnlineEvent -> BotOnlineEventDTO(bot.uin)
+        is BotOfflineEvent.Active -> BotOfflineEventActiveDTO(bot.uin)
+        is BotOfflineEvent.Force -> BotOfflineEventForceDTO(bot.uin, title, message)
+        is BotOfflineEvent.Dropped -> BotOfflineEventDroppedDTO(bot.uin)
+        is BotReloginEvent -> BotReloginEventDTO(bot.uin)
+//        is MessageSendEvent.GroupMessageSendEvent -> {}
+//        is MessageSendEvent.FriendMessageSendEvent -> {}
+//        is BeforeImageUploadEvent -> {}
+//        is ImageUploadEvent.Succeed -> {}
+        is BotGroupPermissionChangeEvent -> BotGroupPermissionChangeEventDTO(origin, new, GroupDTO(group))
+        is BotMuteEvent -> BotMuteEventDTO(durationSeconds, MemberDTO(operator))
+        is BotUnmuteEvent -> BotUnmuteEventDTO(MemberDTO(operator))
+        is BotJoinGroupEvent -> BotJoinGroupEventDTO(GroupDTO(group))
+//        is GroupSettingChangeEvent<*> -> {} // 不知道会改什么
+        is GroupNameChangeEvent -> GroupNameChangeEventDTO(origin, new, GroupDTO(group), isByBot)
+        is GroupEntranceAnnouncementChangeEvent -> GroupEntranceAnnouncementChangeEventDTO(origin, new, GroupDTO(group), operator?.let(::MemberDTO))
+        is GroupMuteAllEvent -> GroupMuteAllEventDTO(origin, new, GroupDTO(group), operator?.let(::MemberDTO))
+        is GroupAllowAnonymousChatEvent -> GroupAllowAnonymousChatEventDTO(origin, new, GroupDTO(group), operator?.let(::MemberDTO))
+        is GroupAllowConfessTalkEvent -> GroupAllowConfessTalkEventDTO(origin, new, GroupDTO(group), isByBot)
+        is GroupAllowMemberInviteEvent -> GroupAllowMemberInviteEventDTO(origin, new, GroupDTO(group), operator?.let(::MemberDTO))
+        is MemberJoinEvent -> MemberJoinEventDTO(MemberDTO(member))
+        is MemberLeaveEvent.Kick -> MemberLeaveEventKickDTO(MemberDTO(member), operator?.let(::MemberDTO))
+        is MemberLeaveEvent.Quit -> MemberLeaveEventQuitDTO(MemberDTO(member))
+        is MemberCardChangeEvent -> MemberCardChangeEventDTO(origin, new, GroupDTO(group), operator?.let(::MemberDTO))
+        is MemberSpecialTitleChangeEvent -> MemberSpecialTitleChangeEventDTO(origin, new, MemberDTO(member))
+        is MemberPermissionChangeEvent -> MemberPermissionChangeEventDTO(origin, new, MemberDTO(member))
+        is MemberMuteEvent -> MemberMuteEventDTO(durationSeconds, MemberDTO(member), operator?.let(::MemberDTO))
+        is MemberUnmuteEvent -> MemberUnmuteEventDTO(MemberDTO(member), operator?.let(::MemberDTO))
+        else -> IgnoreEventDTO
+    }
+}
+
+@Serializable
+@SerialName("BotOnlineEvent")
+data class BotOnlineEventDTO(val qq: Long) : BotEventDTO()
+@Serializable
+@SerialName("BotOfflineEventActive")
+data class BotOfflineEventActiveDTO(val qq: Long) : BotEventDTO()
+@Serializable
+@SerialName("BotOfflineEventForce")
+data class BotOfflineEventForceDTO(val qq: Long, val title: String, val message: String) : BotEventDTO()
+@Serializable
+@SerialName("BotOfflineEventDropped")
+data class BotOfflineEventDroppedDTO(val qq: Long) : BotEventDTO()
+@Serializable
+@SerialName("BotReloginEvent")
+data class BotReloginEventDTO(val qq: Long) : BotEventDTO()
+@Serializable
+@SerialName("BotGroupPermissionChangeEvent")
+data class BotGroupPermissionChangeEventDTO(val origin: MemberPermission, val new: MemberPermission, val group: GroupDTO) : BotEventDTO()
+@Serializable
+@SerialName("BotMuteEvent")
+data class BotMuteEventDTO(val durationSeconds: Int, val operator: MemberDTO) : BotEventDTO()
+@Serializable
+@SerialName("BotUnmuteEvent")
+data class BotUnmuteEventDTO(val operator: MemberDTO) : BotEventDTO()
+@Serializable
+@SerialName("BotJoinGroupEvent")
+data class BotJoinGroupEventDTO(val group: GroupDTO) : BotEventDTO()
+@Serializable
+@SerialName("GroupNameChangeEvent")
+data class GroupNameChangeEventDTO(val origin: String, val new: String, val group: GroupDTO, val isByBot: Boolean) : BotEventDTO()
+@Serializable
+@SerialName("GroupEntranceAnnouncementChangeEvent")
+data class GroupEntranceAnnouncementChangeEventDTO(val origin: String, val new: String, val group: GroupDTO, val operator: MemberDTO?) : BotEventDTO()
+@Serializable
+@SerialName("GroupMuteAllEvent")
+data class GroupMuteAllEventDTO(val origin: Boolean, val new: Boolean, val group: GroupDTO, val operator: MemberDTO?) : BotEventDTO()
+@Serializable
+@SerialName("GroupAllowAnonymousChatEvent")
+data class GroupAllowAnonymousChatEventDTO(val origin: Boolean, val new: Boolean, val group: GroupDTO, val operator: MemberDTO?) : BotEventDTO()
+@Serializable
+@SerialName("GroupAllowConfessTalkEvent")
+data class GroupAllowConfessTalkEventDTO(val origin: Boolean, val new: Boolean, val group: GroupDTO, val isByBot: Boolean) : BotEventDTO()
+@Serializable
+@SerialName("GroupAllowMemberInviteEvent")
+data class GroupAllowMemberInviteEventDTO(val origin: Boolean, val new: Boolean, val group: GroupDTO, val operator: MemberDTO?) : BotEventDTO()
+@Serializable
+@SerialName("MemberJoinEvent")
+data class MemberJoinEventDTO(val member: MemberDTO) : BotEventDTO()
+@Serializable
+@SerialName("MemberLeaveEventKick")
+data class MemberLeaveEventKickDTO(val member: MemberDTO, val operator: MemberDTO?) : BotEventDTO()
+@Serializable
+@SerialName("MemberLeaveEventQuit")
+data class MemberLeaveEventQuitDTO(val member: MemberDTO) : BotEventDTO()
+@Serializable
+@SerialName("MemberCardChangeEvent")
+data class MemberCardChangeEventDTO(val origin: String, val new: String, val group: GroupDTO, val operator: MemberDTO?) : BotEventDTO()
+@Serializable
+@SerialName("MemberSpecialTitleChangeEvent")
+data class MemberSpecialTitleChangeEventDTO(val origin: String, val new: String, val member: MemberDTO) : BotEventDTO()
+@Serializable
+@SerialName("MemberPermissionChangeEvent")
+data class MemberPermissionChangeEventDTO(val origin: MemberPermission, val new: MemberPermission, val member: MemberDTO) : BotEventDTO()
+@Serializable
+@SerialName("MemberMuteEvent")
+data class MemberMuteEventDTO(val durationSeconds: Int, val member: MemberDTO, val operator: MemberDTO?) : BotEventDTO()
+@Serializable
+@SerialName("MemberUnmuteEvent")
+data class MemberUnmuteEventDTO(val member: MemberDTO, val operator: MemberDTO?) : BotEventDTO()

mirai-api-http/src/main/kotlin/net/mamoe/mirai/api/http/data/common/ContactDTO.kt

@@ -37,7 +37,7 @@ data class MemberDTO(
     val group: GroupDTO
 ) : ContactDTO() {
     constructor(member: Member) : this(
-        member.id, member.groupCardOrNick, member.permission,
+        member.id, member.nameCardOrNick, member.permission,
         GroupDTO(member.group)
     )
 }

mirai-api-http/src/main/kotlin/net/mamoe/mirai/api/http/data/common/DTO.kt

 package net.mamoe.mirai.api.http.data.common
 
-import kotlinx.serialization.*
-import kotlinx.serialization.json.Json
-import kotlinx.serialization.modules.SerializersModule
+import kotlinx.serialization.Serializable
+import kotlinx.serialization.Transient
 import net.mamoe.mirai.api.http.AuthedSession
 
 interface DTO
@@ -16,3 +15,8 @@ abstract class VerifyDTO : DTO {
     @Transient
     lateinit var session: AuthedSession // 反序列化验证成功后传入
 }
+
+@Serializable
+abstract class EventDTO : DTO
+
+object IgnoreEventDTO : EventDTO()
\ No newline at end of file

mirai-api-http/src/main/kotlin/net/mamoe/mirai/api/http/data/common/MessageDTO.kt

@@ -11,6 +11,8 @@ package net.mamoe.mirai.api.http.data.common
 
 import kotlinx.serialization.SerialName
 import kotlinx.serialization.Serializable
+import net.mamoe.mirai.contact.Contact
+import net.mamoe.mirai.contact.Group
 import net.mamoe.mirai.message.FriendMessage
 import net.mamoe.mirai.message.GroupMessage
 import net.mamoe.mirai.message.MessagePacket
@@ -30,32 +32,36 @@ data class FriendMessagePacketDTO(val sender: QQDTO) : MessagePacketDTO()
 @SerialName("GroupMessage")
 data class GroupMessagePacketDTO(val sender: MemberDTO) : MessagePacketDTO()
 
-@Serializable
-@SerialName("UnKnownMessage")
-data class UnKnownMessagePacketDTO(val msg: String) : MessagePacketDTO()
 
 // Message
 @Serializable
 @SerialName("Source")
 data class MessageSourceDTO(val uid: Long) : MessageDTO()
+
 @Serializable
 @SerialName("At")
-data class AtDTO(val target: Long, val display: String) : MessageDTO()
+data class AtDTO(val target: Long, val display: String = "") : MessageDTO()
+
 @Serializable
 @SerialName("AtAll")
 data class AtAllDTO(val target: Long = 0) : MessageDTO() // target为保留字段
+
 @Serializable
 @SerialName("Face")
 data class FaceDTO(val faceId: Int) : MessageDTO()
+
 @Serializable
 @SerialName("Plain")
 data class PlainDTO(val text: String) : MessageDTO()
+
 @Serializable
 @SerialName("Image")
 data class ImageDTO(val imageId: String) : MessageDTO()
+
 @Serializable
 @SerialName("Xml")
 data class XmlDTO(val xml: String) : MessageDTO()
+
 @Serializable
 @SerialName("Unknown")
 data class UnknownMessageDTO(val text: String) : MessageDTO()
@@ -64,11 +70,11 @@ data class UnknownMessageDTO(val text: String) : MessageDTO()
 *   Abstract Class
 * */
 @Serializable
-sealed class MessagePacketDTO : DTO {
-    lateinit var messageChain : MessageChainDTO
+sealed class MessagePacketDTO : EventDTO() {
+    lateinit var messageChain: MessageChainDTO
 }
 
-typealias MessageChainDTO = Array<MessageDTO>
+typealias MessageChainDTO = List<MessageDTO>
 
 @Serializable
 sealed class MessageDTO : DTO
@@ -77,21 +83,25 @@ sealed class MessageDTO : DTO
 /*
     Extend function
  */
-suspend fun MessagePacket<*, *>.toDTO(): MessagePacketDTO = when (this) {
+fun MessagePacket<*, *>.toDTO() = when (this) {
     is FriendMessage -> FriendMessagePacketDTO(QQDTO(sender))
     is GroupMessage -> GroupMessagePacketDTO(MemberDTO(sender))
-    else -> UnKnownMessagePacketDTO("UnKnown Message Packet")
-}.apply { messageChain = Array(message.size){ message[it].toDTO() }}
+    else -> IgnoreEventDTO
+}.apply {
+    if (this is MessagePacketDTO) {
+        messageChain = mutableListOf<MessageDTO>().also { ls -> message.foreachContent { ls.add(it.toDTO()) } }
+    }
+}
 
-fun MessageChainDTO.toMessageChain() =
-    MessageChain().apply { this@toMessageChain.forEach { add(it.toMessage()) } }
+fun MessageChainDTO.toMessageChain(contact: Contact) =
+    MessageChain().apply { this@toMessageChain.forEach { add(it.toMessage(contact)) } }
 
 @UseExperimental(ExperimentalUnsignedTypes::class)
 fun Message.toDTO() = when (this) {
     is MessageSource -> MessageSourceDTO(messageUid)
     is At -> AtDTO(target, display)
     is AtAll -> AtAllDTO(0L)
-    is Face -> FaceDTO(id.value.toInt())
+    is Face -> FaceDTO(id)
     is PlainText -> PlainDTO(stringValue)
     is Image -> ImageDTO(imageId)
     is XMLMessage -> XmlDTO(stringValue)
@@ -99,15 +109,13 @@ fun Message.toDTO() = when (this) {
 }
 
 @UseExperimental(ExperimentalUnsignedTypes::class, MiraiInternalAPI::class)
-fun MessageDTO.toMessage() = when (this) {
-    is AtDTO -> At(target, display)
+fun MessageDTO.toMessage(contact: Contact) = when (this) {
+    is AtDTO -> At((contact as Group)[target])
     is AtAllDTO -> AtAll
-    is FaceDTO -> Face(FaceId(faceId.toUByte()))
+    is FaceDTO -> Face(faceId)
     is PlainDTO -> PlainText(text)
     is ImageDTO -> Image(imageId)
     is XmlDTO -> XMLMessage(xml)
     is MessageSourceDTO, is UnknownMessageDTO -> PlainText("assert cannot reach")
 }
 
-
-

mirai-api-http/src/main/kotlin/net/mamoe/mirai/api/http/queue/MessageQueue.kt

@@ -9,26 +9,35 @@
 
 package net.mamoe.mirai.api.http.queue
 
+import net.mamoe.mirai.api.http.data.common.EventDTO
+import net.mamoe.mirai.api.http.data.common.IgnoreEventDTO
+import net.mamoe.mirai.api.http.data.common.toDTO
+import net.mamoe.mirai.event.events.BotEvent
 import net.mamoe.mirai.message.GroupMessage
-import net.mamoe.mirai.message.MessagePacket
 import net.mamoe.mirai.message.data.MessageSource
 import java.util.concurrent.ConcurrentHashMap
 import java.util.concurrent.ConcurrentLinkedDeque
 
-class MessageQueue : ConcurrentLinkedDeque<MessagePacket<*, *>>() {
+class MessageQueue : ConcurrentLinkedDeque<BotEvent>() {
 
     val quoteCache = ConcurrentHashMap<Long, GroupMessage>()
 
-    fun fetch(size: Int): List<MessagePacket<*, *>> {
+    fun fetch(size: Int): List<EventDTO> {
         var count = size
         quoteCache.clear()
-        val ret = ArrayList<MessagePacket<*, *>>(count)
-        while (!this.isEmpty() && count-- > 0) {
-            val packet = pop()
-            ret.add(packet)
+        val ret = ArrayList<EventDTO>(count)
+        while (!this.isEmpty() && count > 0) {
+            val event = pop()
 
-            if (packet is GroupMessage) {
-                addCache(packet)
+            event.toDTO().also {
+                if (it != IgnoreEventDTO) {
+                    ret.add(it)
+                    count--
+                }
+            }
+
+            if (event is GroupMessage) {
+                addCache(event)
             }
         }
         return ret

mirai-api-http/src/main/kotlin/net/mamoe/mirai/api/http/route/AuthRouteModule.kt

@@ -18,6 +18,7 @@ import net.mamoe.mirai.api.http.AuthedSession
 import net.mamoe.mirai.api.http.SessionManager
 import net.mamoe.mirai.api.http.data.NoSuchBotException
 import net.mamoe.mirai.api.http.data.StateCode
+import net.mamoe.mirai.api.http.data.common.DTO
 import net.mamoe.mirai.api.http.data.common.VerifyDTO
 import kotlin.coroutines.EmptyCoroutineContext
 
@@ -28,7 +29,7 @@ fun Application.authModule() {
             if (it.authKey != SessionManager.authKey) {
                 call.respondStateCode(StateCode(1, "Auth Key错误"))
             } else {
-                call.respondStateCode(StateCode(0, SessionManager.createTempSession().key))
+                call.respondDTO(AuthRetDTO(0, SessionManager.createTempSession().key))
             }
         }
 
@@ -55,6 +56,9 @@ fun Application.authModule() {
     }
 }
 
+@Serializable
+private data class AuthRetDTO(val code: Int, val session: String) : DTO
+
 @Serializable
 private data class BindDTO(override val sessionKey: String, val qq: Long) : VerifyDTO()
 

mirai-api-http/src/main/kotlin/net/mamoe/mirai/api/http/route/SendMessageRouteModule.kt

@@ -37,24 +37,28 @@ fun Application.messageModule() {
         miraiGet("/fetchMessage") {
             val count: Int = paramOrNull("count")
             val fetch = it.messageQueue.fetch(count)
-            val ls = Array(fetch.size) { index -> fetch[index].toDTO() }
 
-            call.respondJson(ls.toList().toJson())
+            call.respondJson(fetch.toJson())
         }
 
         miraiVerify<SendDTO>("/sendFriendMessage") {
-            it.session.bot.getFriend(it.target).sendMessage(it.messageChain.toMessageChain())
+            it.session.bot.getFriend(it.target).apply {
+                sendMessage(it.messageChain.toMessageChain(this)) // this aka QQ
+            }
             call.respondStateCode(StateCode.Success)
         }
 
         miraiVerify<SendDTO>("/sendGroupMessage") {
-            it.session.bot.getGroup(it.target).sendMessage(it.messageChain.toMessageChain())
+            it.session.bot.getGroup(it.target).apply {
+                sendMessage(it.messageChain.toMessageChain(this)) // this aka Group
+            }
             call.respondStateCode(StateCode.Success)
         }
 
         miraiVerify<SendDTO>("/quoteMessage") {
-            it.session.messageQueue.quoteCache[it.target]?.quoteReply(it.messageChain.toMessageChain())
-                ?: throw NoSuchElementException()
+            it.session.messageQueue.quoteCache[it.target]?.apply {
+                quoteReply(it.messageChain.toMessageChain(group))
+            } ?: throw NoSuchElementException()
             call.respondStateCode(StateCode.Success)
         }
 

mirai-api-http/src/main/kotlin/net/mamoe/mirai/api/http/util/Json.kt

@@ -13,7 +13,6 @@ import kotlinx.serialization.*
 import kotlinx.serialization.json.Json
 import kotlinx.serialization.modules.SerializersModule
 import net.mamoe.mirai.api.http.data.common.*
-import net.mamoe.mirai.message.data.MessageSource
 
 // 解析失败时直接返回null，由路由判断响应400状态
 @UseExperimental(ImplicitReflectionSerializer::class)
@@ -45,20 +44,46 @@ else MiraiJson.json.stringify(serializer, this)
  */
 object MiraiJson {
     val json = Json(context = SerializersModule {
-        polymorphic(MessagePacketDTO.serializer()) {
+
+        polymorphic(EventDTO.serializer()) {
             GroupMessagePacketDTO::class with GroupMessagePacketDTO.serializer()
             FriendMessagePacketDTO::class with FriendMessagePacketDTO.serializer()
-            UnKnownMessagePacketDTO::class with UnKnownMessagePacketDTO.serializer()
-        }
-        polymorphic(MessageDTO.serializer()) {
-            MessageSourceDTO::class with MessageSourceDTO.serializer()
-            AtDTO::class with AtDTO.serializer()
-            AtAllDTO::class with AtAllDTO.serializer()
-            FaceDTO::class with FaceDTO.serializer()
-            PlainDTO::class with PlainDTO.serializer()
-            ImageDTO::class with ImageDTO.serializer()
-            XmlDTO::class with XmlDTO.serializer()
-            UnknownMessageDTO::class with UnknownMessageDTO.serializer()
+
+            BotOnlineEventDTO::class with BotOnlineEventDTO.serializer()
+            BotOfflineEventActiveDTO::class with BotOfflineEventActiveDTO.serializer()
+            BotOfflineEventForceDTO::class with BotOfflineEventForceDTO.serializer()
+            BotOfflineEventDroppedDTO::class with BotOfflineEventDroppedDTO.serializer()
+            BotReloginEventDTO::class with BotReloginEventDTO.serializer()
+            BotGroupPermissionChangeEventDTO::class with BotGroupPermissionChangeEventDTO.serializer()
+            BotMuteEventDTO::class with BotMuteEventDTO.serializer()
+            BotUnmuteEventDTO::class with BotUnmuteEventDTO.serializer()
+            BotJoinGroupEventDTO::class with BotJoinGroupEventDTO.serializer()
+            GroupNameChangeEventDTO::class with GroupNameChangeEventDTO.serializer()
+            GroupEntranceAnnouncementChangeEventDTO::class with GroupEntranceAnnouncementChangeEventDTO.serializer()
+            GroupMuteAllEventDTO::class with GroupMuteAllEventDTO.serializer()
+            GroupAllowAnonymousChatEventDTO::class with GroupAllowAnonymousChatEventDTO.serializer()
+            GroupAllowConfessTalkEventDTO::class with GroupAllowConfessTalkEventDTO.serializer()
+            GroupAllowMemberInviteEventDTO::class with GroupAllowMemberInviteEventDTO.serializer()
+            MemberJoinEventDTO::class with MemberJoinEventDTO.serializer()
+            MemberLeaveEventKickDTO::class with MemberLeaveEventKickDTO.serializer()
+            MemberLeaveEventQuitDTO::class with MemberLeaveEventQuitDTO.serializer()
+            MemberCardChangeEventDTO::class with MemberCardChangeEventDTO.serializer()
+            MemberSpecialTitleChangeEventDTO::class with MemberSpecialTitleChangeEventDTO.serializer()
+            MemberPermissionChangeEventDTO::class with MemberPermissionChangeEventDTO.serializer()
+            MemberMuteEventDTO::class with MemberMuteEventDTO.serializer()
+            MemberUnmuteEventDTO::class with MemberUnmuteEventDTO.serializer()
         }
+
+        // Message Polymorphic
+//        polymorphic(MessageDTO.serializer()) {
+//            MessageSourceDTO::class with MessageSourceDTO.serializer()
+//            AtDTO::class with AtDTO.serializer()
+//            AtAllDTO::class with AtAllDTO.serializer()
+//            FaceDTO::class with FaceDTO.serializer()
+//            PlainDTO::class with PlainDTO.serializer()
+//            ImageDTO::class with ImageDTO.serializer()
+//            XmlDTO::class with XmlDTO.serializer()
+//            UnknownMessageDTO::class with UnknownMessageDTO.serializer()
+//        }
     })
 }
\ No newline at end of file

mirai-console-graphical/src/main/kotlin/net/mamoe/mirai/console/graphical/MiraiGraphical.kt

@@ -2,7 +2,8 @@ package net.mamoe.mirai.console.graphical
 
 import net.mamoe.mirai.console.MiraiConsole
 import net.mamoe.mirai.console.graphical.controller.MiraiGraphicalUIController
-import net.mamoe.mirai.console.graphical.view.PrimaryView
+import net.mamoe.mirai.console.graphical.styleSheet.PrimaryStyleSheet
+import net.mamoe.mirai.console.graphical.view.Decorator
 import tornadofx.App
 import tornadofx.find
 import tornadofx.launch
@@ -11,7 +12,7 @@ fun main(args: Array<String>) {
     launch<MiraiGraphicalUI>(args)
 }
 
-class MiraiGraphicalUI: App(PrimaryView::class) {
+class MiraiGraphicalUI : App(Decorator::class, PrimaryStyleSheet::class) {
 
     override fun init() {
         super.init()
@@ -23,4 +24,4 @@ class MiraiGraphicalUI: App(PrimaryView::class) {
         super.stop()
         MiraiConsole.stop()
     }
-}
+}
\ No newline at end of file

mirai-console-graphical/src/main/kotlin/net/mamoe/mirai/console/graphical/model/BotModel.kt

@@ -11,3 +11,9 @@ class BotModel(val uin: Long) {
     val logHistory = observableListOf<String>()
     val admins = observableListOf<Long>()
 }
+
+class BotViewModel(botModel: BotModel? = null) : ItemViewModel<BotModel>(botModel) {
+    val bot = bind(BotModel::botProperty)
+    val logHistory = bind(BotModel::logHistory)
+    val admins = bind(BotModel::admins)
+}
\ No newline at end of file

mirai-console-graphical/src/main/kotlin/net/mamoe/mirai/console/graphical/styleSheet/LoginViewStyleSheet.kt

+package net.mamoe.mirai.console.graphical.styleSheet
+
+import javafx.scene.Cursor
+import javafx.scene.effect.BlurType
+import javafx.scene.effect.DropShadow
+import javafx.scene.paint.Color
+import javafx.scene.text.FontWeight
+import tornadofx.*
+
+class LoginViewStyleSheet : Stylesheet() {
+
+    companion object {
+        val vBox by csselement("VBox")
+    }
+
+    init {
+
+        vBox {
+            maxWidth = 500.px
+            maxHeight = 500.px
+
+            backgroundColor += c("39c5BB", 0.3)
+            backgroundRadius += box(15.px)
+
+            padding = box(50.px, 100.px)
+            spacing = 25.px
+
+            borderRadius += box(15.px)
+            effect = DropShadow(BlurType.THREE_PASS_BOX, Color.GRAY, 10.0, 0.0, 15.0, 15.0)
+        }
+
+        textField {
+            prefHeight = 30.px
+            textFill = Color.BLACK
+            fontWeight = FontWeight.BOLD
+        }
+
+        button {
+            backgroundColor += c("00BCD4", 0.8)
+            padding = box(10.px, 0.px)
+            prefWidth = 500.px
+            textFill = Color.WHITE
+            fontWeight = FontWeight.BOLD
+            cursor = Cursor.HAND
+        }
+    }
+}
\ No newline at end of file

mirai-console-graphical/src/main/kotlin/net/mamoe/mirai/console/graphical/styleSheet/PrimaryStyleSheet.kt

+package net.mamoe.mirai.console.graphical.styleSheet
+
+import tornadofx.*
+
+class PrimaryStyleSheet : Stylesheet() {
+    companion object {
+        val jfxTitle by cssclass("jfx-decorator-buttons-container")
+        val container by cssclass("jfx-decorator-content-container")
+    }
+
+    init {
+        jfxTitle {
+            backgroundColor += c("00BCD4")
+        }
+
+        container {
+            borderColor += box(c("00BCD4"))
+            borderWidth += box(0.px, 4.px, 4.px, 4.px)
+        }
+    }
+}
\ No newline at end of file

mirai-console-graphical/src/main/kotlin/net/mamoe/mirai/console/graphical/util/JFoenixAdaptor.kt

@@ -17,20 +17,20 @@ internal fun EventTarget.jfxButton(text: String = "", graphic: Node? = null, op:
         if (graphic != null) it.graphic = graphic
     }
 
-fun EventTarget.jfxTextfield(value: String? = null, op: TextField.() -> Unit = {}) = JFXTextField().attachTo(this, op) {
+fun EventTarget.jfxTextfield(value: String? = null, op: JFXTextField.() -> Unit = {}) = JFXTextField().attachTo(this, op) {
     if (value != null) it.text = value
 }
 
-fun EventTarget.jfxTextfield(property: ObservableValue<String>, op: TextField.() -> Unit = {}) = jfxTextfield().apply {
+fun EventTarget.jfxTextfield(property: ObservableValue<String>, op: JFXTextField.() -> Unit = {}) = jfxTextfield().apply {
     bind(property)
     op(this)
 }
 
-fun EventTarget.jfxPasswordfield(value: String? = null, op: TextField.() -> Unit = {}) = JFXPasswordField().attachTo(this, op) {
+fun EventTarget.jfxPasswordfield(value: String? = null, op: JFXPasswordField.() -> Unit = {}) = JFXPasswordField().attachTo(this, op) {
     if (value != null) it.text = value
 }
 
-fun EventTarget.jfxPasswordfield(property: ObservableValue<String>, op: TextField.() -> Unit = {}) = jfxPasswordfield().apply {
+fun EventTarget.jfxPasswordfield(property: ObservableValue<String>, op: JFXPasswordField.() -> Unit = {}) = jfxPasswordfield().apply {
     bind(property)
     op(this)
 }

mirai-console-graphical/src/main/kotlin/net/mamoe/mirai/console/graphical/view/Decorator.kt

+package net.mamoe.mirai.console.graphical.view
+
+import com.jfoenix.controls.JFXDecorator
+import tornadofx.View
+
+class Decorator: View() {
+
+    override val root = JFXDecorator(primaryStage, find<PrimaryView>().root)
+}
\ No newline at end of file

mirai-console-graphical/src/main/kotlin/net/mamoe/mirai/console/graphical/view/LoginFragment.kt → mirai-console-graphical/src/main/kotlin/net/mamoe/mirai/console/graphical/view/LoginView.kt

 package net.mamoe.mirai.console.graphical.view
 
 import javafx.beans.property.SimpleStringProperty
+import javafx.geometry.Pos
+import javafx.scene.image.Image
 import kotlinx.coroutines.runBlocking
 import net.mamoe.mirai.console.graphical.controller.MiraiGraphicalUIController
+import net.mamoe.mirai.console.graphical.styleSheet.LoginViewStyleSheet
 import net.mamoe.mirai.console.graphical.util.jfxButton
 import net.mamoe.mirai.console.graphical.util.jfxPasswordfield
 import net.mamoe.mirai.console.graphical.util.jfxTextfield
 import tornadofx.*
 
-class LoginFragment : Fragment() {
+class LoginView : View("CNM") {
 
-    private val controller = find<MiraiGraphicalUIController>(FX.defaultScope)
-    private val qq = SimpleStringProperty("0")
+    private val controller = find<MiraiGraphicalUIController>()
+    private val qq = SimpleStringProperty("")
     private val psd = SimpleStringProperty("")
 
-    override val root = form {
-        fieldset("登录") {
-            field("QQ") {
-                jfxTextfield(qq)
+    override val root = borderpane {
+
+        addStylesheet(LoginViewStyleSheet::class)
+
+        center = vbox {
+
+            imageview(Image(LoginView::class.java.classLoader.getResourceAsStream("character.png"))) {
+                alignment = Pos.CENTER
+            }
+
+            jfxTextfield(qq) {
+                promptText = "QQ"
+                isLabelFloat = true
             }
-            field("密码") {
-                jfxPasswordfield(psd)
+
+            jfxPasswordfield(psd) {
+                promptText = "Password"
+                isLabelFloat = true
             }
-        }
-        jfxButton("登录").action {
-            runBlocking {
-                controller.login(qq.value, psd.value)
+
+            jfxButton("Login").action {
+                runAsync {
+                    runBlocking { controller.login(qq.value, psd.value) }
+                }.ui {
+                    qq.value = ""
+                    psd.value = ""
+                }
             }
-            close()
         }
     }
 }
\ No newline at end of file

mirai-console-graphical/src/main/kotlin/net/mamoe/mirai/console/graphical/view/PrimaryView.kt

 package net.mamoe.mirai.console.graphical.view
 
-import com.jfoenix.controls.JFXListCell
-import javafx.geometry.Insets
-import javafx.geometry.Pos
+import com.jfoenix.controls.*
+import javafx.collections.ObservableList
 import javafx.scene.control.Tab
 import javafx.scene.control.TabPane
 import javafx.scene.image.Image
-import javafx.scene.paint.Color
-import javafx.scene.text.FontWeight
 import net.mamoe.mirai.console.graphical.controller.MiraiGraphicalUIController
 import net.mamoe.mirai.console.graphical.model.BotModel
-import net.mamoe.mirai.console.graphical.util.jfxButton
 import net.mamoe.mirai.console.graphical.util.jfxListView
 import net.mamoe.mirai.console.graphical.util.jfxTabPane
 import tornadofx.*
-import java.io.FileInputStream
 
 class PrimaryView : View() {
 
@@ -35,20 +30,12 @@ class PrimaryView : View() {
 
                 setCellFactory {
                     object : JFXListCell<BotModel>() {
-                        var tab: Tab? = null
-
                         init {
                             onDoubleClick {
-                                if (tab == null) {
-                                    (center as TabPane).tab(item.uin.toString()) {
-                                        listview(item.logHistory)
-                                        onDoubleClick { close() }
-                                        tab = this
-                                    }
-                                } else {
-                                    (center as TabPane).tabs.add(tab)
-                                }
-                                tab?.select()
+                                (center as TabPane).logTab(
+                                    text = item.uin.toString(),
+                                    logs = item.logHistory
+                                ).select()
                             }
                         }
 
@@ -65,44 +52,37 @@ class PrimaryView : View() {
                     }
                 }
             }
+        }
 
-            hbox {
-                padding = Insets(10.0)
-                spacing = 10.0
-                alignment = Pos.CENTER
+        center = jfxTabPane {
 
-                jfxButton("L").action {
-                    find<LoginFragment>().openModal()
-                }
-                jfxButton("P")
-                jfxButton("S")
-
-
-                style { backgroundColor += c("00BCD4") }
-                children.style(true) {
-                    backgroundColor += c("00BCD4")
-                    fontSize = 15.px
-                    fontWeight = FontWeight.BOLD
-                    textFill = Color.WHITE
-                    borderRadius += box(25.px)
-                    backgroundRadius += box(25.px)
-                }
+            tab("Login") {
+                this += find<LoginView>().root
             }
+
+            tab("Plugin")
+
+            tab("Settings")
+
+            logTab("Main", controller.mainLog)
         }
+    }
+}
 
-        center = jfxTabPane {
-            tab("Main") {
-                listview(controller.mainLog) {
-
-                    fitToParentSize()
-                    cellFormat {
-                        graphic = label(it) {
-                            maxWidthProperty().bind(this@listview.widthProperty())
-                            isWrapText = true
-                        }
-                    }
-                }
+private fun TabPane.logTab(
+    text: String? = null,
+    logs: ObservableList<String>,
+    op: Tab.() -> Unit = {}
+)= tab(text) {
+    listview(logs) {
+
+        fitToParentSize()
+        cellFormat {
+            graphic = label(it) {
+                maxWidthProperty().bind(this@listview.widthProperty())
+                isWrapText = true
             }
         }
     }
-}
+    also(op)
+}
\ No newline at end of file

mirai-console-terminal/src/main/kotlin/net/mamoe/mirai/console/MiraiConsoleTerminalUI.kt

@@ -187,8 +187,8 @@ object MiraiConsoleTerminalUI : MiraiConsoleUI {
 
             override suspend fun onSolveUnsafeDeviceLoginVerify(bot: Bot, url: String): String? {
                 pushLog(0, "[Login Solver]需要进行账户安全认证")
-                pushLog(0, "[Login Solver]该账户有[设备锁]/[不常用登陆地点]/[不常用设备登陆]的问题")
-                pushLog(0, "[Login Solver]完成以下账号认证即可成功登陆|理论本认证在mirai每个账户中最多出现1次")
+                pushLog(0, "[Login Solver]该账户有[设备锁]/[不常用登录地点]/[不常用设备登录]的问题")
+                pushLog(0, "[Login Solver]完成以下账号认证即可成功登录|理论本认证在mirai每个账户中最多出现1次")
                 pushLog(0, "[Login Solver]请将该链接在QQ浏览器中打开并完成认证, 成功后输入任意字符")
                 pushLog(0, "[Login Solver]这步操作将在后续的版本中优化")
                 pushLog(0, url)

mirai-console/src/main/kotlin/net/mamoe/mirai/console/MiraiConsole.kt

@@ -77,7 +77,7 @@ object MiraiConsole {
 
         logger("Mirai-console 启动完成")
         logger("\"/login qqnumber qqpassword \" to login a bot")
-        logger("\"/login qq号 qq密码 \" 来登陆一个BOT")
+        logger("\"/login qq号 qq密码 \" 来登录一个BOT")
     }
 
     fun stop() {
@@ -208,7 +208,7 @@ object MiraiConsole {
                     }
                     val bot: Bot? = if (it.size == 2) {
                         if (bots.size == 0) {
-                            logger("还没有BOT登陆")
+                            logger("还没有BOT登录")
                             return@onCommand false
                         }
                         bots[0].get()

mirai-core-qqandroid/src/commonMain/kotlin/net/mamoe/mirai/qqandroid/ContactImpl.kt

@@ -162,16 +162,11 @@ internal class QQImpl(
         TODO("not implemented")
     }
 
-    override fun equals(other: Any?): Boolean {
-        if (this === other) return true
-        return other is QQ && other.id == this.id
-    }
-
-    override fun hashCode(): Int = super.hashCode()
+    override fun toString(): String = "QQ($id)"
 }
 
 
-@Suppress("MemberVisibilityCanBePrivate")
+@Suppress("MemberVisibilityCanBePrivate", "DELEGATED_MEMBER_HIDES_SUPERTYPE_OVERRIDE")
 internal class MemberImpl(
     qq: QQImpl,
     group: GroupImpl,
@@ -182,9 +177,21 @@ internal class MemberImpl(
     val qq: QQImpl by qq.unsafeWeakRef()
 
     override var permission: MemberPermission = memberInfo.permission
+    @Suppress("PropertyName")
     internal var _nameCard: String = memberInfo.nameCard
+    @Suppress("PropertyName")
     internal var _specialTitle: String = memberInfo.specialTitle
 
+    @Suppress("PropertyName")
+    var _muteTimestamp: Int = memberInfo.muteTimestamp
+
+    override val muteTimeRemaining: Int =
+        if (_muteTimestamp == 0 || _muteTimestamp == 0xFFFFFFFF.toInt()) {
+            0
+        } else {
+            _muteTimestamp - currentTimeSeconds.toInt() - bot.client.timeDifference.toInt()
+        }
+
     override var nameCard: String
         get() = _nameCard
         set(newValue) {
@@ -220,7 +227,7 @@ internal class MemberImpl(
                             newValue
                         ).sendWithoutExpect()
                     }
-                    MemberSpecialTitleChangeEvent(oldValue, newValue, this@MemberImpl).broadcast()
+                    MemberSpecialTitleChangeEvent(oldValue, newValue, this@MemberImpl, null).broadcast()
                 }
             }
         }
@@ -279,12 +286,9 @@ internal class MemberImpl(
         }
     }
 
-    override fun equals(other: Any?): Boolean {
-        if (this === other) return true
-        return other is Member && other.id == this.id
+    override fun toString(): String {
+        return "Member($id)"
     }
-
-    override fun hashCode(): Int = super.hashCode()
 }
 
 internal class MemberInfoImpl(
@@ -301,6 +305,7 @@ internal class MemberInfoImpl(
             else -> MemberPermission.MEMBER
         }
     override val specialTitle: String get() = jceInfo.sSpecialTitle ?: ""
+    override val muteTimestamp: Int get() = jceInfo.dwShutupTimestap?.toInt() ?: 0
 }
 
 /**
@@ -323,13 +328,13 @@ internal class GroupImpl(
     @UseExperimental(MiraiExperimentalAPI::class)
     override lateinit var botPermission: MemberPermission
 
-    var _botMuteRemaining: Int = groupInfo.botMuteRemaining
+    var _botMuteTimestamp: Int = groupInfo.botMuteRemaining
 
     override val botMuteRemaining: Int =
-        if (_botMuteRemaining == 0 || _botMuteRemaining == 0xFFFFFFFF.toInt()) {
+        if (_botMuteTimestamp == 0 || _botMuteTimestamp == 0xFFFFFFFF.toInt()) {
             0
         } else {
-            _botMuteRemaining - currentTimeSeconds.toInt() - bot.client.timeDifference.toInt()
+            _botMuteTimestamp - currentTimeSeconds.toInt() - bot.client.timeDifference.toInt()
         }
 
     override val members: ContactList<Member> = ContactList(members.mapNotNull {
@@ -600,10 +605,7 @@ internal class GroupImpl(
         image.input.close()
     }
 
-    override fun equals(other: Any?): Boolean {
-        if (this === other) return true
-        return other is Group && other.id == this.id
+    override fun toString(): String {
+        return "Group($id)"
     }
-
-    override fun hashCode(): Int = super.hashCode()
 }
\ No newline at end of file

mirai-core-qqandroid/src/commonMain/kotlin/net/mamoe/mirai/qqandroid/QQAndroidBot.kt

@@ -20,7 +20,6 @@ import net.mamoe.mirai.data.AddFriendResult
 import net.mamoe.mirai.data.FriendInfo
 import net.mamoe.mirai.data.GroupInfo
 import net.mamoe.mirai.data.MemberInfo
-import net.mamoe.mirai.event.events.BotEvent
 import net.mamoe.mirai.message.data.Image
 import net.mamoe.mirai.qqandroid.network.QQAndroidBotNetworkHandler
 import net.mamoe.mirai.qqandroid.network.QQAndroidClient
@@ -116,10 +115,6 @@ internal abstract class QQAndroidBotBase constructor(
         return sequence
     }
 
-    override fun onEvent(event: BotEvent): Boolean {
-        return firstLoginSucceed
-    }
-
     override suspend fun addFriend(id: Long, message: String?, remark: String?): AddFriendResult {
         TODO("not implemented")
     }

mirai-core-qqandroid/src/commonMain/kotlin/net/mamoe/mirai/qqandroid/io/serialization/SerializationUtils.kt → mirai-core-qqandroid/src/commonMain/kotlin/net/mamoe/mirai/qqandroid/io/serialization/utils.kt

@@ -7,6 +7,9 @@
  * https://github.com/mamoe/mirai/blob/master/LICENSE
  */
 
+@file:JvmName("SerializationUtils")
+@file:JvmMultifileClass
+
 package net.mamoe.mirai.qqandroid.io.serialization
 
 import kotlinx.io.core.*
@@ -20,7 +23,8 @@ import net.mamoe.mirai.qqandroid.network.protocol.data.jce.RequestDataVersion3
 import net.mamoe.mirai.qqandroid.network.protocol.data.jce.RequestPacket
 import net.mamoe.mirai.utils.firstValue
 import net.mamoe.mirai.utils.io.read
-import net.mamoe.mirai.utils.io.toUHexString
+import kotlin.jvm.JvmMultifileClass
+import kotlin.jvm.JvmName
 
 
 fun <T : JceStruct> ByteArray.loadAs(deserializer: DeserializationStrategy<T>, c: JceCharset = JceCharset.UTF8): T {

mirai-core-qqandroid/src/commonMain/kotlin/net/mamoe/mirai/qqandroid/message/MessageSourceFromMsg.kt

@@ -21,6 +21,7 @@ import net.mamoe.mirai.qqandroid.network.protocol.data.proto.SourceMsg
 internal inline class MessageSourceFromServer(
     val delegate: ImMsgBody.SourceMsg
 ) : MessageSource {
+    override val time: Long get() = delegate.time.toLong() and 0xFFFFFFFF
     override val messageUid: Long get() = delegate.pbReserve.loadAs(SourceMsg.ResvAttr.serializer()).origUids!!
     override val sourceMessage: MessageChain get() = delegate.toMessageChain()
     override val senderId: Long get() = delegate.senderUin
@@ -32,6 +33,7 @@ internal inline class MessageSourceFromServer(
 internal inline class MessageSourceFromMsg(
     val delegate: MsgComm.Msg
 ) : MessageSource {
+    override val time: Long get() = delegate.msgHead.msgTime.toLong() and 0xFFFFFFFF
     override val messageUid: Long get() = delegate.msgBody.richText.attr!!.random.toLong()
     override val sourceMessage: MessageChain get() = delegate.toMessageChain()
     override val senderId: Long get() = delegate.msgHead.fromUin

mirai-core-qqandroid/src/commonMain/kotlin/net/mamoe/mirai/qqandroid/message/MessageQQA.kt → mirai-core-qqandroid/src/commonMain/kotlin/net/mamoe/mirai/qqandroid/message/messages.kt

@@ -9,6 +9,8 @@
 
 package net.mamoe.mirai.qqandroid.message
 
+import kotlinx.io.core.buildPacket
+import kotlinx.io.core.readBytes
 import kotlinx.io.core.readUInt
 import net.mamoe.mirai.message.data.*
 import net.mamoe.mirai.qqandroid.network.protocol.data.proto.ImMsgBody
@@ -20,13 +22,18 @@ import net.mamoe.mirai.utils.io.hexToBytes
 import net.mamoe.mirai.utils.io.read
 import net.mamoe.mirai.utils.io.toByteArray
 
-private val AT_BUF_1 = byteArrayOf(0x00, 0x01, 0x00, 0x00, 0x00, 0x0A, 0x00)
-private val AT_BUF_2 = ByteArray(2)
-
 internal fun At.toJceData(): ImMsgBody.Text {
+    val text = this.toString()
     return ImMsgBody.Text(
-        str = this.toString(),
-        attr6Buf = AT_BUF_1 + this.target.toInt().toByteArray() + AT_BUF_2
+        str = text,
+        attr6Buf = buildPacket {
+            writeShort(1)
+            writeShort(0)
+            writeShort(text.length.toShort())
+            writeByte(1)
+            writeInt(target.toInt())
+            writeShort(0)
+        }.readBytes()
     )
 }
 
@@ -86,6 +93,16 @@ _400Height=0x000000EB(235)
 pbReserve=<Empty ByteArray>
 }
  */
+val FACE_BUF = "00 01 00 04 52 CC F5 D0".hexToBytes()
+
+internal fun Face.toJceData(): ImMsgBody.Face {
+    return ImMsgBody.Face(
+        index = this.id,
+        old = (0x1445 - 4 + this.id).toShort().toByteArray(),
+        buf = FACE_BUF
+    )
+}
+
 internal fun CustomFaceFromFile.toJceData(): ImMsgBody.CustomFace {
     return ImMsgBody.CustomFace(
         filePath = this.filepath,
@@ -213,6 +230,7 @@ internal fun MessageChain.toRichTextElems(): MutableList<ImMsgBody.Elem> {
             is NotOnlineImageFromServer -> elements.add(ImMsgBody.Elem(notOnlineImage = it.delegate))
             is NotOnlineImageFromFile -> elements.add(ImMsgBody.Elem(notOnlineImage = it.toJceData()))
             is AtAll -> elements.add(atAllData)
+            is Face -> elements.add(ImMsgBody.Elem(face = it.toJceData()))
             is QuoteReply,
             is MessageSource -> {
 
@@ -312,18 +330,20 @@ internal fun List<ImMsgBody.Elem>.joinToMessageChain(message: MessageChain) {
             it.srcMsg != null -> message.add(QuoteReply(MessageSourceFromServer(it.srcMsg)))
             it.notOnlineImage != null -> message.add(NotOnlineImageFromServer(it.notOnlineImage))
             it.customFace != null -> message.add(CustomFaceFromServer(it.customFace))
+            it.face != null -> message.add(Face(it.face.index))
             it.text != null -> {
                 if (it.text.attr6Buf.isEmpty()) {
                     message.add(it.text.str.toMessage())
                 } else {
-                    //00 01 00 00 00 05 01 00 00 00 00 00 00 all
-                    //00 01 00 00 00 0A 00 3E 03 3F A2 00 00 one
+                    // 00 01 00 00 00 05 01 00 00 00 00 00 00 all
+                    // 00 01 00 00 00 0A 00 3E 03 3F A2 00 00 one/nick
+                    // 00 01 00 00 00 07 00 44 71 47 90 00 00 one/groupCard
                     val id: Long
                     it.text.attr6Buf.read {
                         discardExact(7)
                         id = readUInt().toLong()
                     }
-                    if (id == 0L){
+                    if (id == 0L) {
                         message.add(AtAll)
                     } else {
                         message.add(At(id, it.text.str))

mirai-core-qqandroid/src/commonMain/kotlin/net/mamoe/mirai/qqandroid/network/protocol/packet/EncryptMethod.kt

@@ -15,12 +15,10 @@ import kotlinx.io.core.buildPacket
 import kotlinx.io.core.writeFully
 import net.mamoe.mirai.qqandroid.network.QQAndroidClient
 import net.mamoe.mirai.utils.cryptor.ECDH
+import net.mamoe.mirai.utils.cryptor.ECDHKeyPair
 import net.mamoe.mirai.utils.io.encryptAndWrite
 import net.mamoe.mirai.utils.io.writeShortLVByteArray
 
-/**
- * Encryption method to be used for packet body.
- */
 @UseExperimental(ExperimentalUnsignedTypes::class)
 internal interface EncryptMethod {
     val id: Int
@@ -33,16 +31,6 @@ internal interface EncryptMethodSessionKey : EncryptMethod {
     val currentLoginState: Int
     val sessionKey: ByteArray
 
-    /**
-     * buildPacket{
-     *     byte 1
-     *     byte if (currentLoginState == 2) 3 else 2
-     *     fully key
-     *     short 258
-     *     short 0
-     *     fully encrypted
-     * }
-     */
     override fun makeBody(client: QQAndroidClient, body: BytePacketBuilder.() -> Unit): ByteReadPacket =
         buildPacket {
             require(currentLoginState == 2 || currentLoginState == 3) { "currentLoginState must be either 2 or 3" }
@@ -65,29 +53,27 @@ inline class EncryptMethodSessionKeyLoginState3(override val sessionKey: ByteArr
     override val currentLoginState: Int get() = 3
 }
 
-inline class EncryptMethodECDH135(override val ecdh: ECDH) :
+internal inline class EncryptMethodECDH135(override val ecdh: ECDH) :
     EncryptMethodECDH {
     override val id: Int get() = 135
 }
 
-inline class EncryptMethodECDH7(override val ecdh: ECDH) :
+internal inline class EncryptMethodECDH7(override val ecdh: ECDH) :
     EncryptMethodECDH {
     override val id: Int get() = 7
 }
 
 internal interface EncryptMethodECDH : EncryptMethod {
+    companion object {
+        operator fun invoke(ecdh: ECDH): EncryptMethodECDH {
+            return if (ecdh.keyPair === ECDHKeyPair.DefaultStub) {
+                EncryptMethodECDH135(ecdh)
+            } else EncryptMethodECDH7(ecdh)
+        }
+    }
+
     val ecdh: ECDH
 
-    /**
-     * **Packet Structure**
-     * byte     1
-     * byte     1
-     * byte[]   [ECDH.privateKey]
-     * short    258
-     * short    [ECDH.publicKey].size
-     * byte[]   [ECDH.publicKey]
-     * byte[]   encrypted `body()` by [ECDH.shareKey]
-     */
     override fun makeBody(client: QQAndroidClient, body: BytePacketBuilder.() -> Unit): ByteReadPacket =
         buildPacket {
             writeByte(1) // const
@@ -95,15 +81,15 @@ internal interface EncryptMethodECDH : EncryptMethod {
             writeFully(client.randomKey)
             writeShort(258) // const
 
-            // writeShortLVByteArray("04 CB 36 66 98 56 1E 93 6E 80 C1 57 E0 74 CA B1 3B 0B B6 8D DE B2 82 45 48 A1 B1 8D D4 FB 61 22 AF E1 2F E4 8C 52 66 D8 D7 26 9D 76 51 A8 EB 6F E7".hexToBytes())
-
-            writeShortLVByteArray(ecdh.keyPair.publicKey.getEncoded().drop(23).take(49).toByteArray().also {
-                // it.toUHexString().debugPrint("PUBLIC KEY")
-                check(it[0].toInt() == 0x04) { "Bad publicKey generated. Expected first element=0x04, got${it[0]}" }
-                //check(ecdh.calculateShareKeyByPeerPublicKey(it.adjustToPublicKey()).contentEquals(ecdh.keyPair.shareKey)) { "PublicKey Validation failed" }
-            })
+            if (ecdh.keyPair === ECDHKeyPair.DefaultStub) {
+                writeShortLVByteArray(ECDHKeyPair.DefaultStub.defaultPublicKey)
+                encryptAndWrite(ECDHKeyPair.DefaultStub.defaultShareKey, body)
+            } else {
+                writeShortLVByteArray(ecdh.keyPair.publicKey.getEncoded().drop(23).take(49).toByteArray().also {
+                    check(it[0].toInt() == 0x04) { "Bad publicKey generated. Expected first element=0x04, got${it[0]}" }
+                })
 
-            // encryptAndWrite("26 33 BA EC 86 EB 79 E6 BC E0 20 06 5E A9 56 6C".hexToBytes(), body)
-            encryptAndWrite(ecdh.keyPair.initialShareKey, body)
+                encryptAndWrite(ecdh.keyPair.initialShareKey, body)
+            }
         }
 }
\ No newline at end of file

mirai-core-qqandroid/src/commonMain/kotlin/net/mamoe/mirai/qqandroid/network/protocol/packet/PacketFactory.kt

@@ -33,7 +33,7 @@ import kotlin.contracts.contract
 import kotlin.jvm.JvmName
 
 
-internal sealed class PacketFactory<TPacket : Packet> {
+internal sealed class PacketFactory<TPacket : Packet?> {
     /**
      * 筛选从服务器接收到的包时的 commandName
      */
@@ -49,7 +49,7 @@ internal sealed class PacketFactory<TPacket : Packet> {
  * @param TPacket 服务器回复包解析结果
  */
 @UseExperimental(ExperimentalUnsignedTypes::class)
-internal abstract class OutgoingPacketFactory<TPacket : Packet>(
+internal abstract class OutgoingPacketFactory<TPacket : Packet?>(
     /**
      * 命令名. 如 `wtlogin.login`, `ConfigPushSvc.PushDomain`
      */
@@ -73,7 +73,7 @@ internal abstract class OutgoingPacketFactory<TPacket : Packet>(
  * 这个工厂可以在 [handle] 时回复一个 commandId 为 [responseCommandName] 的包, 也可以不回复.
  * 必须先到 [KnownPacketFactories] 中注册工厂, 否则不能处理.
  */
-internal abstract class IncomingPacketFactory<TPacket : Packet>(
+internal abstract class IncomingPacketFactory<TPacket : Packet?>(
     /**
      * 接收自服务器的包的 commandName
      */
@@ -97,10 +97,10 @@ internal abstract class IncomingPacketFactory<TPacket : Packet>(
 }
 
 @JvmName("decode0")
-private suspend inline fun <P : Packet> OutgoingPacketFactory<P>.decode(bot: QQAndroidBot, packet: ByteReadPacket): P = packet.decode(bot)
+private suspend inline fun <P : Packet?> OutgoingPacketFactory<P>.decode(bot: QQAndroidBot, packet: ByteReadPacket): P = packet.decode(bot)
 
 @JvmName("decode1")
-private suspend inline fun <P : Packet> IncomingPacketFactory<P>.decode(bot: QQAndroidBot, packet: ByteReadPacket, sequenceId: Int): P =
+private suspend inline fun <P : Packet?> IncomingPacketFactory<P>.decode(bot: QQAndroidBot, packet: ByteReadPacket, sequenceId: Int): P =
     packet.decode(bot, sequenceId)
 
 internal val DECRYPTER_16_ZERO = ByteArray(16)
@@ -169,7 +169,7 @@ internal object KnownPacketFactories {
     // do not inline. Exceptions thrown will not be reported correctly
     @UseExperimental(MiraiInternalAPI::class)
     @Suppress("UNCHECKED_CAST")
-    suspend fun <T : Packet> parseIncomingPacket(bot: QQAndroidBot, rawInput: Input, consumer: PacketConsumer<T>) = with(rawInput) {
+    suspend fun <T : Packet?> parseIncomingPacket(bot: QQAndroidBot, rawInput: Input, consumer: PacketConsumer<T>) = with(rawInput) {
         // login
         val flag1 = readInt()
 
@@ -229,7 +229,7 @@ internal object KnownPacketFactories {
     }
 
     @UseExperimental(MiraiInternalAPI::class)
-    internal suspend fun <T : Packet> handleIncomingPacket(it: IncomingPacket<T>, bot: QQAndroidBot, flag2: Int, consumer: PacketConsumer<T>) {
+    internal suspend fun <T : Packet?> handleIncomingPacket(it: IncomingPacket<T>, bot: QQAndroidBot, flag2: Int, consumer: PacketConsumer<T>) {
         if (it.packetFactory == null) {
             bot.network.logger.debug("Received commandName: ${it.commandName}")
             PacketLogger.warning { "找不到 PacketFactory" }
@@ -263,7 +263,7 @@ internal object KnownPacketFactories {
 
     private inline fun <R> inline(block: () -> R): R = block()
 
-    class IncomingPacket<T : Packet>(
+    class IncomingPacket<T : Packet?>(
         val packetFactory: PacketFactory<T>?,
         val sequenceId: Int,
         val data: ByteReadPacket,
@@ -337,7 +337,7 @@ internal object KnownPacketFactories {
         return IncomingPacket(packetFactory, ssoSequenceId, packet, commandName)
     }
 
-    private suspend fun <T : Packet> ByteReadPacket.parseOicqResponse(
+    private suspend fun <T : Packet?> ByteReadPacket.parseOicqResponse(
         bot: QQAndroidBot,
         packetFactory: OutgoingPacketFactory<T>,
         ssoSequenceId: Int,

mirai-core-qqandroid/src/commonMain/kotlin/net/mamoe/mirai/qqandroid/network/protocol/packet/chat/receive/MessageSvc.kt

@@ -16,7 +16,6 @@ import net.mamoe.mirai.contact.MemberPermission
 import net.mamoe.mirai.data.MemberInfo
 import net.mamoe.mirai.data.MultiPacket
 import net.mamoe.mirai.data.Packet
-import net.mamoe.mirai.event.BroadcastControllable
 import net.mamoe.mirai.event.events.BotJoinGroupEvent
 import net.mamoe.mirai.event.events.BotOfflineEvent
 import net.mamoe.mirai.event.events.MemberJoinEvent
@@ -103,23 +102,23 @@ internal class MessageSvc {
         }
 
         @UseExperimental(MiraiInternalAPI::class)
-        internal class GetMsgSuccess(delegate: List<Packet>) : Response(MsgSvc.SyncFlag.STOP, delegate)
+        open class GetMsgSuccess(delegate: List<Packet>) : Response(MsgSvc.SyncFlag.STOP, delegate) {
+            override fun toString(): String {
+                return "MessageSvc.PbGetMsg.GetMsgSuccess(messages=List(size=${this.size}))"
+            }
+        }
 
         /**
-         * 不要直接 expect 这个 class. 它可能
+         * 不要直接 expect 这个 class. 它可能还没同步完成
          */
         @MiraiInternalAPI
-        open class Response(internal val syncFlagFromServer: MsgSvc.SyncFlag, delegate: List<Packet>) : MultiPacket<Packet>(delegate),
-            BroadcastControllable {
-            override val shouldBroadcast: Boolean
-                get() = syncFlagFromServer == MsgSvc.SyncFlag.STOP
-
+        open class Response(internal val syncFlagFromServer: MsgSvc.SyncFlag, delegate: List<Packet>) : MultiPacket<Packet>(delegate) {
             override fun toString(): String {
                 return "MessageSvc.PbGetMsg.Response($syncFlagFromServer=$syncFlagFromServer, messages=List(size=${this.size}))"
             }
         }
 
-        object EmptyResponse : Response(MsgSvc.SyncFlag.STOP, emptyList())
+        object EmptyResponse : GetMsgSuccess(emptyList())
 
         @UseExperimental(MiraiInternalAPI::class, MiraiExperimentalAPI::class)
         override suspend fun ByteReadPacket.decode(bot: QQAndroidBot): Response {
@@ -127,8 +126,8 @@ internal class MessageSvc {
             val resp = readProtoBuf(MsgSvc.PbGetMsgResp.serializer())
 
             if (resp.result != 0) {
-                //  println("!!! Result=${resp.result} !!!: " + resp.contentToString())
-                return GetMsgSuccess(mutableListOf())
+                bot.network.logger.warning("MessageSvc.PushNotify: result != 0, result = ${resp.result}, errorMsg=${resp.errmsg}")
+                return EmptyResponse
             }
 
             bot.client.c2cMessageSync.syncCookie = resp.syncCookie
@@ -149,7 +148,7 @@ internal class MessageSvc {
                             val group = bot.getGroupByUinOrNull(msg.msgHead.fromUin)
                             if (msg.msgHead.authUin == bot.uin) {
                                 if (group != null) {
-                                    error("group is not null while bot is invited to the group")
+                                    return@mapNotNull null
                                 }
                                 // 新群
 
@@ -159,6 +158,7 @@ internal class MessageSvc {
                                 }.groups.first { it.groupUin == msg.msgHead.fromUin }
 
 
+                                @Suppress("DuplicatedCode")
                                 val newGroup = GroupImpl(
                                     bot = bot,
                                     coroutineContext = bot.coroutineContext,
@@ -194,6 +194,7 @@ internal class MessageSvc {
                                         override val nameCard: String get() = ""
                                         override val permission: MemberPermission get() = MemberPermission.MEMBER
                                         override val specialTitle: String get() = ""
+                                        override val muteTimestamp: Int get() = 0
                                         override val uin: Long get() = msg.msgHead.authUin
                                         override val nick: String get() = msg.msgHead.authNick.takeIf { it.isNotEmpty() } ?: msg.msgHead.fromNick
                                     }).also { group.members.delegate.addLast(it) })
@@ -264,6 +265,7 @@ internal class MessageSvc {
         /**
          * 发送好友消息
          */
+        @Suppress("FunctionName")
         fun ToFriend(
             client: QQAndroidClient,
             toUin: Long,
@@ -293,6 +295,7 @@ internal class MessageSvc {
         /**
          * 发送群消息
          */
+        @Suppress("FunctionName")
         fun ToGroup(
             client: QQAndroidClient,
             groupCode: Long,

mirai-core-qqandroid/src/commonMain/kotlin/net/mamoe/mirai/qqandroid/network/protocol/packet/login/WtLogin.kt

@@ -47,7 +47,7 @@ internal class WtLogin {
                 ticket: String
             ): OutgoingPacket = buildLoginOutgoingPacket(client, bodyType = 2) { sequenceId ->
                 writeSsoPacket(client, subAppId, commandName, sequenceId = sequenceId) {
-                    writeOicqRequestPacket(client, EncryptMethodECDH7(client.ecdh), 0x0810) {
+                    writeOicqRequestPacket(client, EncryptMethodECDH(client.ecdh), 0x0810) {
                         writeShort(2) // subCommand
                         writeShort(4) // count of TLVs
                         t193(ticket)
@@ -64,7 +64,7 @@ internal class WtLogin {
                 captchaAnswer: String
             ): OutgoingPacket = buildLoginOutgoingPacket(client, bodyType = 2) { sequenceId ->
                 writeSsoPacket(client, subAppId, commandName, sequenceId = sequenceId) {
-                    writeOicqRequestPacket(client, EncryptMethodECDH7(client.ecdh), 0x0810) {
+                    writeOicqRequestPacket(client, EncryptMethodECDH(client.ecdh), 0x0810) {
                         writeShort(2) // subCommand
                         writeShort(4) // count of TLVs
                         t2(captchaAnswer, captchaSign, 0)
@@ -83,7 +83,7 @@ internal class WtLogin {
                 t402: ByteArray
             ): OutgoingPacket = buildLoginOutgoingPacket(client, bodyType = 2) { sequenceId ->
                 writeSsoPacket(client, subAppId, commandName, sequenceId = sequenceId) {
-                    writeOicqRequestPacket(client, EncryptMethodECDH7(client.ecdh), 0x0810) {
+                    writeOicqRequestPacket(client, EncryptMethodECDH(client.ecdh), 0x0810) {
                         writeShort(20) // subCommand
                         writeShort(4) // count of TLVs, probably ignored by server?
                         t8(2052)
@@ -103,7 +103,7 @@ internal class WtLogin {
                 client: QQAndroidClient
             ): OutgoingPacket = buildLoginOutgoingPacket(client, bodyType = 2) { sequenceId ->
                 writeSsoPacket(client, subAppId, commandName, sequenceId = sequenceId, unknownHex = "01 00 00 00 00 00 00 00 00 00 01 00") {
-                    writeOicqRequestPacket(client, EncryptMethodECDH7(client.ecdh), 0x0810) {
+                    writeOicqRequestPacket(client, EncryptMethodECDH(client.ecdh), 0x0810) {
                         writeShort(8) // subCommand
                         writeShort(6) // count of TLVs, probably ignored by server?TODO
                         t8(2052)
@@ -131,7 +131,7 @@ internal class WtLogin {
                 client: QQAndroidClient
             ): OutgoingPacket = buildLoginOutgoingPacket(client, bodyType = 2) { sequenceId ->
                 writeSsoPacket(client, subAppId, commandName, sequenceId = sequenceId) {
-                    writeOicqRequestPacket(client, EncryptMethodECDH7(client.ecdh), 0x0810) {
+                    writeOicqRequestPacket(client, EncryptMethodECDH(client.ecdh), 0x0810) {
                         writeShort(9) // subCommand
                         writeShort(17) // count of TLVs, probably ignored by server?
                         //writeShort(LoginType.PASSWORD.value.toShort())
@@ -325,7 +325,7 @@ internal class WtLogin {
                 2 -> onSolveLoginCaptcha(tlvMap, bot)
                 160 /*-96*/ -> onUnsafeDeviceLogin(tlvMap)
                 204 /*-52*/ -> onSMSVerifyNeeded(tlvMap, bot)
-                else -> tlvMap[0x149]?.let { analysisTlv149(it) } ?: error("unknown login result type: $type")
+                else -> tlvMap[0x149]?.let { analysisTlv149(it) } ?: error("unknown login result type: $type, TLVMap = ${tlvMap.contentToString()}")
             }
         }
 

mirai-core-qqandroid/src/commonMain/kotlin/net/mamoe/mirai/qqandroid/utils/Guid.kt → mirai-core-qqandroid/src/commonMain/kotlin/net/mamoe/mirai/qqandroid/utils/GuidSource.kt

@@ -7,9 +7,13 @@
  * https://github.com/mamoe/mirai/blob/master/LICENSE
  */
 
+@file:JvmName("Utils")
+@file:JvmMultifileClass
+
 package net.mamoe.mirai.qqandroid.utils
 
-import net.mamoe.mirai.utils.md5
+import kotlin.jvm.JvmMultifileClass
+import kotlin.jvm.JvmName
 import kotlin.jvm.JvmStatic
 
 /**

mirai-core-qqandroid/src/commonMain/kotlin/net/mamoe/mirai/qqandroid/utils/Flags.kt → mirai-core-qqandroid/src/commonMain/kotlin/net/mamoe/mirai/qqandroid/utils/flags.kt

@@ -7,8 +7,14 @@
  * https://github.com/mamoe/mirai/blob/master/LICENSE
  */
 
+@file:JvmName("Utils")
+@file:JvmMultifileClass
+
 package net.mamoe.mirai.qqandroid.utils
 
+import kotlin.jvm.JvmMultifileClass
+import kotlin.jvm.JvmName
+
 inline class MacOrAndroidIdChangeFlag(val value: Long = 0) {
     fun macChanged(): MacOrAndroidIdChangeFlag =
         MacOrAndroidIdChangeFlag(this.value or 0x1)

mirai-core-qqandroid/src/commonMain/kotlin/net/mamoe/mirai/qqandroid/utils/inline.kt

@@ -7,11 +7,16 @@
  * https://github.com/mamoe/mirai/blob/master/LICENSE
  */
 
+@file:JvmName("Utils")
+@file:JvmMultifileClass
+
 package net.mamoe.mirai.qqandroid.utils
 
 import kotlin.contracts.ExperimentalContracts
 import kotlin.contracts.InvocationKind
 import kotlin.contracts.contract
+import kotlin.jvm.JvmMultifileClass
+import kotlin.jvm.JvmName
 
 /**
  * Inline the block

mirai-core-qqandroid/src/commonMain/kotlin/net/mamoe/mirai/qqandroid/utils/type.kt

@@ -7,10 +7,16 @@
  * https://github.com/mamoe/mirai/blob/master/LICENSE
  */
 
+@file:JvmName("Utils")
+@file:JvmMultifileClass
+
 package net.mamoe.mirai.qqandroid.utils
 
+import kotlin.jvm.JvmMultifileClass
+import kotlin.jvm.JvmName
+
 
-fun Int.toIpV4AddressString(): String {
+internal fun Int.toIpV4AddressString(): String {
     @Suppress("NAME_SHADOWING")
     var var0 = this.toLong() and 0xFFFFFFFF
     return buildString {

mirai-core/build.gradle.kts

@@ -8,8 +8,6 @@ plugins {
     id("com.jfrog.bintray") version "1.8.4-jetbrains-3"
 }
 
-apply(from = rootProject.file("gradle/publish.gradle"))
-
 val kotlinVersion: String by rootProject.ext
 val atomicFuVersion: String by rootProject.ext
 val coroutinesVersion: String by rootProject.ext

mirai-core/src/androidMain/kotlin/net/mamoe/mirai/MiraiEnvironment.kt

-/*
- * Copyright 2020 Mamoe Technologies and contributors.
- *
- * 此源代码的使用受 GNU AFFERO GENERAL PUBLIC LICENSE version 3 许可证的约束, 可以在以下链接找到该许可证.
- * Use of this source code is governed by the GNU AGPLv3 license that can be found through the following link.
- *
- * https://github.com/mamoe/mirai/blob/master/LICENSE
- */
-
-package net.mamoe.mirai
-
-actual object MiraiEnvironment {
-    actual val platform: Platform get() = Platform.ANDROID
-}
\ No newline at end of file

mirai-core/src/androidMain/kotlin/net/mamoe/mirai/event/internal/MiraiAtomicBoolean.kt

+package net.mamoe.mirai.event.internal
+
+import java.util.concurrent.atomic.AtomicBoolean
+
+internal actual class MiraiAtomicBoolean actual constructor(initial: Boolean) {
+    private val delegate: AtomicBoolean = AtomicBoolean(initial)
+
+    actual fun compareAndSet(expect: Boolean, update: Boolean): Boolean {
+        return delegate.compareAndSet(expect, update)
+    }
+
+    actual var value: Boolean
+        get() = delegate.get()
+        set(value) {
+            delegate.set(value)
+        }
+}
\ No newline at end of file

mirai-core/src/androidMain/kotlin/net/mamoe/mirai/utils/BotConfigurationAndroid.kt

@@ -68,11 +68,11 @@ actual open class BotConfiguration actual constructor() {
     /**
      * 重连失败后, 继续尝试的每次等待时间
      */
-    actual var reconnectPeriodMillis: Long = 60.secondsToMillis
+    actual var reconnectPeriodMillis: Long = 5.secondsToMillis
     /**
      * 最多尝试多少次重连
      */
-    actual var reconnectionRetryTimes: Int = 3
+    actual var reconnectionRetryTimes: Int = Int.MAX_VALUE
     /**
      * 验证码处理器
      */

mirai-core/src/androidMain/kotlin/net/mamoe/mirai/utils/cryptor/ECDHAndroid.kt

@@ -9,8 +9,10 @@
 
 package net.mamoe.mirai.utils.cryptor
 
+import android.annotation.SuppressLint
 import net.mamoe.mirai.utils.md5
 import java.security.*
+import java.security.spec.ECGenParameterSpec
 import java.security.spec.X509EncodedKeySpec
 import javax.crypto.KeyAgreement
 
@@ -18,13 +20,13 @@ import javax.crypto.KeyAgreement
 actual typealias ECDHPrivateKey = PrivateKey
 actual typealias ECDHPublicKey = PublicKey
 
-actual class ECDHKeyPair(
+internal actual class ECDHKeyPairImpl(
     private val delegate: KeyPair
-) {
-    actual val privateKey: ECDHPrivateKey get() = delegate.private
-    actual val publicKey: ECDHPublicKey get() = delegate.public
+) : ECDHKeyPair {
+    override val privateKey: ECDHPrivateKey get() = delegate.private
+    override val publicKey: ECDHPublicKey get() = delegate.public
 
-    actual val initialShareKey: ByteArray = ECDH.calculateShareKey(privateKey, initialPublicKey)
+    override val initialShareKey: ByteArray = ECDH.calculateShareKey(privateKey, initialPublicKey)
 }
 
 @Suppress("FunctionName")
@@ -32,8 +34,41 @@ actual fun ECDH() = ECDH(ECDH.generateKeyPair())
 
 actual class ECDH actual constructor(actual val keyPair: ECDHKeyPair) {
     actual companion object {
+        @Suppress("ObjectPropertyName")
+        private var _isECDHAvailable: Boolean = false // because `runCatching` has no contract.
+        actual val isECDHAvailable: Boolean get() = _isECDHAvailable
+
+        init {
+            kotlin.runCatching {
+                @SuppressLint("PrivateApi")
+                val clazz = Class.forName(
+                    "com.android.org.bouncycastle.jce.provider.BouncyCastleProvider",
+                    true,
+                    ClassLoader.getSystemClassLoader()
+                )
+
+                val providerName = clazz.getDeclaredField("PROVIDER_NAME").get(null) as String
+
+                if (Security.getProvider(providerName) != null) {
+                    Security.removeProvider(providerName)
+                }
+                Security.addProvider(clazz.newInstance() as Provider)
+                generateKeyPair()
+                _isECDHAvailable = true
+            }.exceptionOrNull()?.let {
+                throw IllegalStateException("cannot init BouncyCastle", it)
+            }
+            _isECDHAvailable = false
+        }
+
+
         actual fun generateKeyPair(): ECDHKeyPair {
-            return ECDHKeyPair(KeyPairGenerator.getInstance("ECDH").genKeyPair())
+            if (!isECDHAvailable) {
+                return ECDHKeyPair.DefaultStub
+            }
+            return ECDHKeyPairImpl(KeyPairGenerator.getInstance("ECDH")
+                .also { it.initialize(ECGenParameterSpec("secp192k1")) }
+                .genKeyPair())
         }
 
         actual fun calculateShareKey(

mirai-core/src/androidMain/kotlin/net/mamoe/mirai/utils/io/PlatformSocket.kt

@@ -30,9 +30,16 @@ actual class PlatformSocket : Closeable {
     private lateinit var socket: Socket
 
     actual val isOpen: Boolean
-        get() = socket.isConnected
+        get() =
+            if (::socket.isInitialized)
+                socket.isConnected
+            else false
 
-    actual override fun close() = socket.close()
+    actual override fun close() {
+        if (::socket.isInitialized) {
+            socket.close()
+        }
+    }
 
     @PublishedApi
     internal lateinit var writeChannel: BufferedOutputStream

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/Bot.kt

@@ -7,7 +7,7 @@
  * https://github.com/mamoe/mirai/blob/master/LICENSE
  */
 
-@file:Suppress("EXPERIMENTAL_API_USAGE", "unused", "FunctionName", "NOTHING_TO_INLINE")
+@file:Suppress("EXPERIMENTAL_API_USAGE", "unused", "FunctionName", "NOTHING_TO_INLINE", "UnusedImport")
 
 package net.mamoe.mirai
 
@@ -35,7 +35,8 @@ import kotlin.jvm.JvmStatic
  *
  * 注: Bot 为全协程实现, 没有其他任务时若不使用 [join], 主线程将会退出.
  *
- * @see Contact
+ * @see Contact 联系人
+ * @see kotlinx.coroutines.isActive 判断 [Bot] 是否正常运行中. (在线, 且没有被 [close])
  */
 @UseExperimental(MiraiInternalAPI::class)
 abstract class Bot : CoroutineScope {
@@ -195,7 +196,9 @@ abstract class Bot : CoroutineScope {
 
     /**
      * 登录, 或重新登录.
-     * 重新登录时不会再次拉取联系人列表.
+     * 这个函数总是关闭一切现有网路任务, 然后重新登录并重新缓存好友列表和群列表.
+     *
+     * 一般情况下不需要重新登录. Mirai 能够自动处理掉线情况.
      *
      * 最终调用 [net.mamoe.mirai.network.BotNetworkHandler.relogin]
      *
@@ -231,24 +234,19 @@ abstract class Bot : CoroutineScope {
     // endregion
 
     /**
-     * 关闭这个 [Bot], 停止一切相关活动. 所有引用都会被释放.
+     * 关闭这个 [Bot], 立即取消 [Bot] 的 [kotlinx.coroutines.SupervisorJob].
+     * 之后 [kotlinx.coroutines.isActive] 将会返回 `false`.
      *
-     * 注: 不可重新登录. 必须重新实例化一个 [Bot].
+     * **注意:** 不可重新登录. 必须重新实例化一个 [Bot].
      *
      * @param cause 原因. 为 null 时视为正常关闭, 非 null 时视为异常关闭
      *
-     * @see closeAndJoin
+     * @see closeAndJoin 取消并 [Bot.join], 以确保 [Bot] 相关的活动被完全关闭
      */
     abstract fun close(cause: Throwable? = null)
 
     // region extensions
 
-    @Deprecated(message = "这个函数有歧义, 将在不久后删除", replaceWith = ReplaceWith("getFriend(this.toLong())"))
-    fun Int.qq(): QQ = getFriend(this.toLong())
-
-    @Deprecated(message = "这个函数有歧义, 将在不久后删除", replaceWith = ReplaceWith("getFriend(this)"))
-    fun Long.qq(): QQ = getFriend(this)
-
     final override fun toString(): String {
         return "Bot(${uin})"
     }

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/BotImpl.kt

@@ -14,7 +14,6 @@ package net.mamoe.mirai
 import kotlinx.coroutines.*
 import net.mamoe.mirai.event.Listener
 import net.mamoe.mirai.event.broadcast
-import net.mamoe.mirai.event.events.BotEvent
 import net.mamoe.mirai.event.events.BotOfflineEvent
 import net.mamoe.mirai.event.events.BotReloginEvent
 import net.mamoe.mirai.event.subscribeAlways
@@ -73,11 +72,6 @@ abstract class BotImpl<N : BotNetworkHandler> constructor(
         }
     }
 
-    /**
-     * 可阻止事件广播
-     */
-    abstract fun onEvent(event: BotEvent): Boolean
-
     // region network
 
     final override val network: N get() = _network
@@ -89,21 +83,22 @@ abstract class BotImpl<N : BotNetworkHandler> constructor(
     private val offlineListener: Listener<BotOfflineEvent> = this.subscribeAlways { event ->
         when (event) {
             is BotOfflineEvent.Dropped -> {
-                bot.logger.info("Connection dropped or lost by server, retrying login")
-
-                var lastFailedException: Throwable? = null
-                repeat(configuration.reconnectionRetryTimes) {
-                    try {
-                        network.relogin()
-                        logger.info("Reconnected successfully")
-                        return@subscribeAlways
-                    } catch (e: Throwable) {
-                        lastFailedException = e
+                if (!_network.isActive) {
+                    return@subscribeAlways
+                }
+                bot.logger.info("Connection dropped by server or lost, retrying login")
+
+                tryNTimesOrException(configuration.reconnectionRetryTimes) { tryCount ->
+                    if (tryCount != 0) {
                         delay(configuration.reconnectPeriodMillis)
                     }
-                }
-                if (lastFailedException != null) {
-                    throw lastFailedException!!
+                    network.relogin(event.cause)
+                    logger.info("Reconnected successfully")
+                    BotReloginEvent(bot, event.cause).broadcast()
+                    return@subscribeAlways
+                }?.let {
+                    logger.info("Cannot reconnect")
+                    throw it
                 }
             }
             is BotOfflineEvent.Active -> {
@@ -112,17 +107,21 @@ abstract class BotImpl<N : BotNetworkHandler> constructor(
                 } else {
                     " with exception: " + event.cause.message
                 }
-                bot.logger.info("Bot is closed manually$msg")
-                close(CancellationException(event.toString()))
+                bot.logger.info { "Bot is closed manually$msg" }
+                closeAndJoin(CancellationException(event.toString()))
             }
             is BotOfflineEvent.Force -> {
-                bot.logger.info("Connection occupied by another android device: ${event.message}")
-                close(ForceOfflineException(event.toString()))
+                bot.logger.info { "Connection occupied by another android device: ${event.message}" }
+                closeAndJoin(ForceOfflineException(event.toString()))
             }
         }
     }
 
-    final override suspend fun login() = reinitializeNetworkHandler(null)
+    final override suspend fun login() {
+        logger.info("Logging in...")
+        reinitializeNetworkHandler(null)
+        logger.info("Login successful")
+    }
 
     private suspend fun reinitializeNetworkHandler(
         cause: Throwable?
@@ -176,15 +175,19 @@ abstract class BotImpl<N : BotNetworkHandler> constructor(
 
     @UseExperimental(MiraiInternalAPI::class)
     override fun close(cause: Throwable?) {
+        if (!this.botJob.isActive) {
+            // already cancelled
+            return
+        }
         kotlin.runCatching {
             if (cause == null) {
+                this.botJob.cancel()
                 network.close()
-                this.botJob.complete()
-                offlineListener.complete()
+                offlineListener.cancel()
             } else {
+                this.botJob.cancel(CancellationException("bot cancelled", cause))
                 network.close(cause)
-                this.botJob.completeExceptionally(cause)
-                offlineListener.completeExceptionally(cause)
+                offlineListener.cancel(CancellationException("bot cancelled", cause))
             }
         }
         groups.delegate.clear()

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/MiraiEnvironment.kt

-/*
- * Copyright 2020 Mamoe Technologies and contributors.
- *
- * 此源代码的使用受 GNU AFFERO GENERAL PUBLIC LICENSE version 3 许可证的约束, 可以在以下链接找到该许可证.
- * Use of this source code is governed by the GNU AGPLv3 license that can be found through the following link.
- *
- * https://github.com/mamoe/mirai/blob/master/LICENSE
- */
-
-package net.mamoe.mirai
-
-/**
- * 平台相关环境属性
- */
-expect object MiraiEnvironment {
-    val platform: Platform
-}
-
-/**
- * 可用平台列表
- */
-enum class Platform {
-    ANDROID,
-    JVM
-}
\ No newline at end of file

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/contact/Contact.kt

@@ -74,6 +74,16 @@ interface Contact : CoroutineScope {
      * 而 [QQ] 含义为一个独立的人, 可以是好友, 也可以是陌生人.
      */
     override fun equals(other: Any?): Boolean
+
+    /**
+     * @return `bot.hashCode() * 31 + id.hashCode()`
+     */
+    override fun hashCode(): Int
+
+    /**
+     * @return "QQ($id)" or "Group($id)" or "Member($id)"
+     */
+    override fun toString(): String
 }
 
 suspend inline fun Contact.sendMessage(message: Message) = sendMessage(message.toChain())

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/contact/Group.kt

@@ -12,6 +12,7 @@
 package net.mamoe.mirai.contact
 
 import kotlinx.coroutines.CoroutineScope
+import net.mamoe.mirai.Bot
 import net.mamoe.mirai.data.MemberInfo
 import net.mamoe.mirai.event.events.*
 import net.mamoe.mirai.utils.MiraiExperimentalAPI
@@ -89,19 +90,19 @@ interface Group : Contact, CoroutineScope {
     /**
      * 机器人被禁言还剩余多少秒
      *
-     * @see BotMuteEvent
-     * @see isBotMuted
+     * @see BotMuteEvent 机器人被禁言事件
+     * @see isBotMuted 判断机器人是否正在被禁言
      */
     val botMuteRemaining: Int
 
     /**
      * 机器人在这个群里的权限
      *
-     * **MiraiExperimentalAPI**: 在未来可能会被修改
+     * @see Group.checkBotPermission 检查 [Bot] 在这个群里的权限
+     * @see Group.checkBotPermissionOperator 要求 [Bot] 在这个群里的权限为 [管理员或群主][MemberPermission.isOperator]
      *
-     * @see BotGroupPermissionChangeEvent
+     * @see BotGroupPermissionChangeEvent 机器人群员修改
      */
-    @MiraiExperimentalAPI
     val botPermission: MemberPermission
 
 
@@ -129,6 +130,7 @@ interface Group : Contact, CoroutineScope {
     /**
      * 让机器人退出这个群. 机器人必须为非群主才能退出. 否则将会失败
      */
+    @MiraiExperimentalAPI("还未支持")
     suspend fun quit(): Boolean
 
     /**

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/contact/Member.kt

 /*
  * Copyright 2020 Mamoe Technologies and contributors.
  *
- * 此源代码的使用受 GNU AFFERO GENERAL PUBLIC LICENSE version 3 许可证的约束, 可以在以下链接找到该许可证.
+ * 此源代码的使用受 GNU AFFERO GENERAL PUBLIC LICENSE version 3 许可证的约束, 可在以下链接找到该许可证.
  * Use of this source code is governed by the GNU AGPLv3 license that can be found through the following link.
  *
  * https://github.com/mamoe/mirai/blob/master/LICENSE
@@ -29,33 +29,50 @@ interface Member : QQ, Contact {
 
     /**
      * 成员的权限, 动态更新.
+     *
+     * @see MemberPermissionChangeEvent 权限变更事件. 由群主或机器人的操作触发.
      */
     val permission: MemberPermission
 
     /**
-     * 群名片. 可能为空. 修改时将会触发事件
+     * 群名片. 可能为空.
+     *
+     * 管理员和群主都可修改任何人（包括群主）的群名片.
      *
      * 在修改时将会异步上传至服务器.
      *
-     * @see [groupCardOrNick] 获取非空群名片或昵称
+     * @see [nameCardOrNick] 获取非空群名片或昵称
      *
-     * @see MemberCardChangeEvent 群名片被管理员, 自己或 [Bot] 改动事件
+     * @see MemberCardChangeEvent 群名片被管理员, 自己或 [Bot] 改动事件. 修改时也会触发此事件.
      * @throws PermissionDeniedException 无权限修改时
      */
     var nameCard: String
 
     /**
-     * 群头衔
+     * 群头衔.
+     *
+     * 仅群主可以修改群头衔.
      *
      * 在修改时将会异步上传至服务器.
      *
-     * @see MemberSpecialTitleChangeEvent 群名片被管理员, 自己或 [Bot] 改动事件
+     * @see MemberSpecialTitleChangeEvent 群名片被管理员, 自己或 [Bot] 改动事件. 修改时也会触发此事件.
      * @throws PermissionDeniedException 无权限修改时
      */
     var specialTitle: String
 
     /**
-     * 禁言
+     * 被禁言剩余时长. 单位为秒.
+     *
+     * @see isMuted 判断改成员是否处于禁言状态
+     * @see mute 设置禁言
+     * @see unmute 取消禁言
+     */
+    val muteTimeRemaining: Int
+
+    /**
+     * 禁言.
+     *
+     * 管理员可禁言成员, 群主可禁言管理员和群员.
      *
      * @param durationSeconds 持续时间. 精确到秒. 范围区间表示为 `(0s, 30days]`. 超过范围则会抛出异常.
      * @return 机器人无权限时返回 `false`
@@ -72,6 +89,8 @@ interface Member : QQ, Contact {
     /**
      * 解除禁言.
      *
+     * 管理员可解除成员的禁言, 群主可解除管理员和群员的禁言.
+     *
      * @see MemberUnmuteEvent 成员被取消禁言事件.
      * @throws PermissionDeniedException 无权限修改时
      */
@@ -80,6 +99,8 @@ interface Member : QQ, Contact {
     /**
      * 踢出该成员.
      *
+     * 管理员可踢出成员, 群主可踢出管理员和群员.
+     *
      * @see MemberLeaveEvent.Kick 成员被踢出事件.
      * @throws PermissionDeniedException 无权限修改时
      */
@@ -96,7 +117,14 @@ interface Member : QQ, Contact {
  *
  * 若 [群名片][Member.nameCard] 不为空则返回群名片, 为空则返回 [QQ.nick]
  */
-val Member.groupCardOrNick: String get() = this.nameCard.takeIf { it.isNotEmpty() } ?: this.nick
+val Member.nameCardOrNick: String get() = this.nameCard.takeIf { it.isNotEmpty() } ?: this.nick
+
+/**
+ * 判断改成员是否处于禁言状态.
+ */
+fun Member.isMuted(): Boolean {
+    return muteTimeRemaining != 0 && muteTimeRemaining != 0xFFFFFFFF.toInt()
+}
 
 @ExperimentalTime
 suspend inline fun Member.mute(duration: Duration) {

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/contact/Permission.kt

@@ -9,6 +9,7 @@
 
 package net.mamoe.mirai.contact
 
+import net.mamoe.mirai.Bot
 import net.mamoe.mirai.utils.MiraiExperimentalAPI
 
 
@@ -68,7 +69,6 @@ inline fun Member.isAdministrator(): Boolean = this.permission.isAdministrator()
 inline fun Member.isOperator(): Boolean = this.permission.isOperator()
 
 
-
 /**
  * 权限不足
  */
@@ -77,6 +77,11 @@ expect class PermissionDeniedException : IllegalStateException {
     constructor(message: String?)
 }
 
+/**
+ * 要求 [Bot] 在这个群里的权限为 [required], 否则抛出异常 [PermissionDeniedException]
+ *
+ * @throws PermissionDeniedException
+ */
 @UseExperimental(MiraiExperimentalAPI::class)
 inline fun Group.checkBotPermission(
     required: MemberPermission,
@@ -89,6 +94,11 @@ inline fun Group.checkBotPermission(
     }
 }
 
+/**
+ * 要求 [Bot] 在这个群里的权限为 [管理员或群主][MemberPermission.isOperator], 否则抛出异常 [PermissionDeniedException]
+ *
+ * @throws PermissionDeniedException
+ */
 @UseExperimental(MiraiExperimentalAPI::class)
 inline fun Group.checkBotPermissionOperator(
     lazyMessage: () -> String = {

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/data/EventPacket.kt

-/*
- * Copyright 2020 Mamoe Technologies and contributors.
- *
- * 此源代码的使用受 GNU AFFERO GENERAL PUBLIC LICENSE version 3 许可证的约束, 可以在以下链接找到该许可证.
- * Use of this source code is governed by the GNU AGPLv3 license that can be found through the following link.
- *
- * https://github.com/mamoe/mirai/blob/master/LICENSE
- */
-
-package net.mamoe.mirai.data
-
-import net.mamoe.mirai.event.Event
-
-/**
- * 事件包. 可被监听.
- *
- * @see Event
- */
-interface EventPacket : Event, Packet
\ No newline at end of file

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/data/MemberInfo.kt

@@ -17,4 +17,6 @@ interface MemberInfo : FriendInfo {
     val permission: MemberPermission
 
     val specialTitle: String
+
+    val muteTimestamp: Int
 }
\ No newline at end of file

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/event/MessageSubscribers.kt

@@ -25,6 +25,8 @@ import net.mamoe.mirai.message.data.Message
 import kotlin.contracts.ExperimentalContracts
 import kotlin.contracts.InvocationKind
 import kotlin.contracts.contract
+import kotlin.coroutines.CoroutineContext
+import kotlin.coroutines.EmptyCoroutineContext
 
 /**
  * 订阅来自所有 [Bot] 的所有联系人的消息事件. 联系人可以是任意群或任意好友或临时会话.
@@ -33,7 +35,10 @@ import kotlin.contracts.contract
  */
 @UseExperimental(ExperimentalContracts::class)
 @MessageDsl
-inline fun <R> CoroutineScope.subscribeMessages(crossinline listeners: MessageSubscribersBuilder<MessagePacket<*, *>>.() -> R): R {
+inline fun <R> CoroutineScope.subscribeMessages(
+    coroutineContext: CoroutineContext = EmptyCoroutineContext,
+    crossinline listeners: MessageSubscribersBuilder<MessagePacket<*, *>>.() -> R
+): R {
     // contract 可帮助 IDE 进行类型推断. 无实际代码作用.
     contract {
         callsInPlace(listeners, InvocationKind.EXACTLY_ONCE)
@@ -42,7 +47,7 @@ inline fun <R> CoroutineScope.subscribeMessages(crossinline listeners: MessageSu
     return MessageSubscribersBuilder { messageListener: MessageListener<MessagePacket<*, *>> ->
         // subscribeAlways 即注册一个监听器. 这个监听器收到消息后就传递给 [listener]
         // listener 即为 DSL 里 `contains(...) { }`, `startsWith(...) { }` 的代码块.
-        subscribeAlways {
+        subscribeAlways(coroutineContext) {
             messageListener.invoke(this, this.message.toString())
             // this.message.toString() 即为 messageListener 中 it 接收到的值
         }
@@ -56,12 +61,15 @@ inline fun <R> CoroutineScope.subscribeMessages(crossinline listeners: MessageSu
  */
 @UseExperimental(ExperimentalContracts::class)
 @MessageDsl
-inline fun <R> CoroutineScope.subscribeGroupMessages(crossinline listeners: MessageSubscribersBuilder<GroupMessage>.() -> R): R {
+inline fun <R> CoroutineScope.subscribeGroupMessages(
+    coroutineContext: CoroutineContext = EmptyCoroutineContext,
+    crossinline listeners: MessageSubscribersBuilder<GroupMessage>.() -> R
+): R {
     contract {
         callsInPlace(listeners, InvocationKind.EXACTLY_ONCE)
     }
     return MessageSubscribersBuilder<GroupMessage> { listener ->
-        subscribeAlways {
+        subscribeAlways(coroutineContext) {
             listener(this, this.message.toString())
         }
     }.run(listeners)
@@ -74,12 +82,15 @@ inline fun <R> CoroutineScope.subscribeGroupMessages(crossinline listeners: Mess
  */
 @UseExperimental(ExperimentalContracts::class)
 @MessageDsl
-inline fun <R> CoroutineScope.subscribeFriendMessages(crossinline listeners: MessageSubscribersBuilder<FriendMessage>.() -> R): R {
+inline fun <R> CoroutineScope.subscribeFriendMessages(
+    coroutineContext: CoroutineContext = EmptyCoroutineContext,
+    crossinline listeners: MessageSubscribersBuilder<FriendMessage>.() -> R
+): R {
     contract {
         callsInPlace(listeners, InvocationKind.EXACTLY_ONCE)
     }
     return MessageSubscribersBuilder<FriendMessage> { listener ->
-        subscribeAlways {
+        subscribeAlways(coroutineContext) {
             listener(this, this.message.toString())
         }
     }.run(listeners)
@@ -92,12 +103,15 @@ inline fun <R> CoroutineScope.subscribeFriendMessages(crossinline listeners: Mes
  */
 @UseExperimental(ExperimentalContracts::class)
 @MessageDsl
-inline fun <R> Bot.subscribeMessages(crossinline listeners: MessageSubscribersBuilder<MessagePacket<*, *>>.() -> R): R {
+inline fun <R> Bot.subscribeMessages(
+    coroutineContext: CoroutineContext = EmptyCoroutineContext,
+    crossinline listeners: MessageSubscribersBuilder<MessagePacket<*, *>>.() -> R
+): R {
     contract {
         callsInPlace(listeners, InvocationKind.EXACTLY_ONCE)
     }
     return MessageSubscribersBuilder<MessagePacket<*, *>> { listener ->
-        this.subscribeAlways {
+        this.subscribeAlways(coroutineContext) {
             listener(this, this.message.toString())
         }
     }.run(listeners)
@@ -106,16 +120,21 @@ inline fun <R> Bot.subscribeMessages(crossinline listeners: MessageSubscribersBu
 /**
  * 订阅来自这个 [Bot] 的所有群消息事件
  *
+ * @param coroutineContext 给事件监听协程的额外的 [CoroutineContext]
+ *
  * @see CoroutineScope.incoming
  */
 @UseExperimental(ExperimentalContracts::class)
 @MessageDsl
-inline fun <R> Bot.subscribeGroupMessages(crossinline listeners: MessageSubscribersBuilder<GroupMessage>.() -> R): R {
+inline fun <R> Bot.subscribeGroupMessages(
+    coroutineContext: CoroutineContext = EmptyCoroutineContext,
+    crossinline listeners: MessageSubscribersBuilder<GroupMessage>.() -> R
+): R {
     contract {
         callsInPlace(listeners, InvocationKind.EXACTLY_ONCE)
     }
     return MessageSubscribersBuilder<GroupMessage> { listener ->
-        this.subscribeAlways {
+        this.subscribeAlways(coroutineContext) {
             listener(this, this.message.toString())
         }
     }.run(listeners)
@@ -128,12 +147,15 @@ inline fun <R> Bot.subscribeGroupMessages(crossinline listeners: MessageSubscrib
  */
 @UseExperimental(ExperimentalContracts::class)
 @MessageDsl
-inline fun <R> Bot.subscribeFriendMessages(crossinline listeners: MessageSubscribersBuilder<FriendMessage>.() -> R): R {
+inline fun <R> Bot.subscribeFriendMessages(
+    coroutineContext: CoroutineContext = EmptyCoroutineContext,
+    crossinline listeners: MessageSubscribersBuilder<FriendMessage>.() -> R
+): R {
     contract {
         callsInPlace(listeners, InvocationKind.EXACTLY_ONCE)
     }
     return MessageSubscribersBuilder<FriendMessage> { listener ->
-        this.subscribeAlways {
+        this.subscribeAlways(coroutineContext) {
             listener(this, this.message.toString())
         }
     }.run(listeners)
@@ -148,9 +170,12 @@ inline fun <R> Bot.subscribeFriendMessages(crossinline listeners: MessageSubscri
  * @see subscribeMessages
  * @see subscribeGroupMessages
  */
-inline fun <reified E : Event> CoroutineScope.incoming(capacity: Int = Channel.RENDEZVOUS): ReceiveChannel<E> {
+inline fun <reified E : Event> CoroutineScope.incoming(
+    coroutineContext: CoroutineContext = EmptyCoroutineContext,
+    capacity: Int = Channel.RENDEZVOUS
+): ReceiveChannel<E> {
     return Channel<E>(capacity).apply {
-        subscribeAlways<E> {
+        subscribeAlways<E>(coroutineContext) {
             send(this)
         }
     }

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/event/Subscribable.kt

@@ -11,8 +11,6 @@
 
 package net.mamoe.mirai.event
 
-import net.mamoe.mirai.BotImpl
-import net.mamoe.mirai.event.events.BotEvent
 import net.mamoe.mirai.event.internal.broadcastInternal
 import net.mamoe.mirai.utils.MiraiInternalAPI
 
@@ -22,7 +20,7 @@ import net.mamoe.mirai.utils.MiraiInternalAPI
  * 若监听这个类, 监听器将会接收所有事件的广播.
  *
  * @see subscribeAlways
- * @see subscribeWhile
+ * @see subscribeOnce
  *
  * @see subscribeMessages
  *
@@ -73,9 +71,6 @@ suspend fun <E : Event> E.broadcast(): E = apply {
     if (this is BroadcastControllable && !this.shouldBroadcast) {
         return@apply
     }
-    if (this is BotEvent && !(this.bot as BotImpl<*>).onEvent(this)) {
-        return@apply
-    }
     this@broadcast.broadcastInternal() // inline, no extra cost
 }
 

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/event/events/BotEvents.kt

@@ -7,6 +7,8 @@
  * https://github.com/mamoe/mirai/blob/master/LICENSE
  */
 
+@file:Suppress("unused")
+
 package net.mamoe.mirai.event.events
 
 import net.mamoe.mirai.Bot
@@ -57,7 +59,7 @@ sealed class BotOfflineEvent : BotEvent {
     /**
      * 被服务器断开或因网络问题而掉线
      */
-    data class Dropped(override val bot: Bot) : BotOfflineEvent(), Packet, BotPassiveEvent
+    data class Dropped(override val bot: Bot, val cause: Throwable?) : BotOfflineEvent(), Packet, BotPassiveEvent
 }
 
 /**
@@ -194,7 +196,7 @@ data class GroupNameChangeEvent(
     override val origin: String,
     override val new: String,
     override val group: Group,
-    val isByBot: Boolean
+    val isByBot: Boolean // 无法获取 operator
 ) : GroupSettingChangeEvent<String>, Packet
 
 /**
@@ -210,6 +212,8 @@ data class GroupEntranceAnnouncementChangeEvent(
     val operator: Member?
 ) : GroupSettingChangeEvent<String>, Packet
 
+val GroupEntranceAnnouncementChangeEvent.isByBot: Boolean get() = operator != null
+
 
 /**
  * 群 "全员禁言" 功能状态改变. 此事件广播前修改就已经完成.
@@ -224,6 +228,8 @@ data class GroupMuteAllEvent(
     val operator: Member?
 ) : GroupSettingChangeEvent<Boolean>, Packet
 
+val GroupMuteAllEvent.isByBot: Boolean get() = operator != null
+
 /**
  * 群 "匿名聊天" 功能状态改变. 此事件广播前修改就已经完成.
  */
@@ -237,6 +243,8 @@ data class GroupAllowAnonymousChatEvent(
     val operator: Member?
 ) : GroupSettingChangeEvent<Boolean>, Packet
 
+val GroupAllowAnonymousChatEvent.isByBot: Boolean get() = operator != null
+
 /**
  * 群 "坦白说" 功能状态改变. 此事件广播前修改就已经完成.
  */
@@ -260,6 +268,8 @@ data class GroupAllowMemberInviteEvent(
     val operator: Member?
 ) : GroupSettingChangeEvent<Boolean>, Packet
 
+val GroupAllowMemberInviteEvent.isByBot: Boolean get() = operator != null
+
 // endregion
 
 
@@ -293,6 +303,8 @@ sealed class MemberLeaveEvent : GroupMemberEvent {
     data class Quit(override val member: Member) : MemberLeaveEvent()
 }
 
+val MemberLeaveEvent.Kick.isByBot: Boolean get() = operator != null
+
 // endregion
 
 // region 名片和头衔
@@ -319,6 +331,8 @@ data class MemberCardChangeEvent(
     val operator: Member?
 ) : GroupMemberEvent
 
+val MemberCardChangeEvent.isByBot: Boolean get() = operator != null
+
 /**
  * 群头衔改动. 一定为群主操作
  */
@@ -333,9 +347,18 @@ data class MemberSpecialTitleChangeEvent(
      */
     val new: String,
 
-    override val member: Member
+    override val member: Member,
+
+    /**
+     * 操作人.
+     * 不为 null 时一定为群主. 可能与 [member] 引用相同, 此时为群员自己修改.
+     * 为 null 时则是机器人操作.
+     */
+    val operator: Member?
 ) : GroupMemberEvent
 
+val MemberSpecialTitleChangeEvent.isByBot: Boolean get() = operator != null
+
 // endregion
 
 
@@ -367,6 +390,8 @@ data class MemberMuteEvent(
     val operator: Member?
 ) : GroupMemberEvent, Packet
 
+val MemberMuteEvent.isByBot: Boolean get() = operator != null
+
 /**
  * 群成员被取消禁言事件. 被禁言的成员都不可能是机器人本人
  */
@@ -378,6 +403,8 @@ data class MemberUnmuteEvent(
     val operator: Member?
 ) : GroupMemberEvent, Packet
 
+val MemberUnmuteEvent.isByBot: Boolean get() = operator != null
+
 // endregion
 
 // endregion

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/event/internal/InternalEventListeners.kt

@@ -9,7 +9,6 @@
 
 package net.mamoe.mirai.event.internal
 
-import kotlinx.atomicfu.atomic
 import kotlinx.coroutines.*
 import net.mamoe.mirai.event.Event
 import net.mamoe.mirai.event.EventDisabled
@@ -32,8 +31,12 @@ fun <L : Listener<E>, E : Event> KClass<out E>.subscribeInternal(listener: L): L
 
 @PublishedApi
 @Suppress("FunctionName")
-internal fun <E : Event> CoroutineScope.Handler(handler: suspend (E) -> ListeningStatus): Handler<E> {
-    return Handler(coroutineContext[Job], coroutineContext, handler)
+internal fun <E : Event> CoroutineScope.Handler(
+    coroutineContext: CoroutineContext,
+    handler: suspend (E) -> ListeningStatus
+): Handler<E> {
+    val context = this.newCoroutineContext(coroutineContext)
+    return Handler(context[Job], context, handler)
 }
 
 private inline fun inline(block: () -> Unit) = block()
@@ -77,7 +80,32 @@ internal class Handler<in E : Event>
  */
 internal fun <E : Event> KClass<out E>.listeners(): EventListeners<E> = EventListenerManager.get(this)
 
-internal class EventListeners<E : Event> : LockFreeLinkedList<Listener<E>>()
+internal class EventListeners<E : Event>(clazz: KClass<E>) : LockFreeLinkedList<Listener<E>>() {
+    @Suppress("UNCHECKED_CAST")
+    val supertypes: Set<KClass<out Event>> by lazy {
+        val supertypes = mutableSetOf<KClass<out Event>>()
+
+        fun addSupertypes(clazz: KClass<out Event>) {
+            clazz.supertypes.forEach {
+                val classifier = it.classifier as? KClass<out Event>
+                if (classifier != null) {
+                    supertypes.add(classifier)
+                    addSupertypes(classifier)
+                }
+            }
+        }
+        addSupertypes(clazz)
+
+        supertypes
+    }
+}
+
+internal expect class MiraiAtomicBoolean(initial: Boolean) {
+
+    fun compareAndSet(expect: Boolean, update: Boolean): Boolean
+
+    var value: Boolean
+}
 
 /**
  * 管理每个事件 class 的 [EventListeners].
@@ -88,16 +116,8 @@ internal object EventListenerManager {
 
     private val registries = LockFreeLinkedList<Registry<*>>()
 
-    private val lock = atomic(false)
-
-    private fun setLockValue(value: Boolean) {
-        lock.value = value
-    }
-
-    @Suppress("BooleanLiteralArgument")
-    private fun trySetLockTrue(): Boolean {
-        return lock.compareAndSet(false, true)
-    }
+    // 不要用 atomicfu. 在 publish 后会出现 VerifyError
+    private val lock: MiraiAtomicBoolean = MiraiAtomicBoolean(false)
 
     @Suppress("UNCHECKED_CAST", "BooleanLiteralArgument")
     internal tailrec fun <E : Event> get(clazz: KClass<out E>): EventListeners<E> {
@@ -106,11 +126,11 @@ internal object EventListenerManager {
                 return it.listeners as EventListeners<E>
             }
         }
-        if (trySetLockTrue()) {
-            val registry = Registry(clazz, EventListeners())
+        if (lock.compareAndSet(false, true)) {
+            val registry = Registry(clazz as KClass<E>, EventListeners(clazz))
             registries.addLast(registry)
-            setLockValue(false)
-            return registry.listeners as EventListeners<E>
+            lock.value = false
+            return registry.listeners
         }
         return get(clazz)
     }
@@ -123,19 +143,10 @@ internal suspend inline fun Event.broadcastInternal() {
 
     EventLogger.info { "Event broadcast: $this" }
 
-    callAndRemoveIfRequired(this::class.listeners())
-
-    var supertypes = this::class.supertypes
-    while (true) {
-        val superSubscribableType = supertypes.firstOrNull {
-            it.classifier as? KClass<out Event> != null
-        }
-
-        superSubscribableType?.let {
-            callAndRemoveIfRequired((it.classifier as KClass<out Event>).listeners())
-        }
-
-        supertypes = (superSubscribableType?.classifier as? KClass<*>)?.supertypes ?: return
+    val listeners = this::class.listeners()
+    callAndRemoveIfRequired(listeners)
+    listeners.supertypes.forEach {
+        callAndRemoveIfRequired(it.listeners())
     }
 }
 

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/message/FriendMessage.kt

@@ -13,7 +13,6 @@ import net.mamoe.mirai.Bot
 import net.mamoe.mirai.contact.QQ
 import net.mamoe.mirai.event.BroadcastControllable
 import net.mamoe.mirai.message.data.MessageChain
-import net.mamoe.mirai.utils.MiraiInternalAPI
 
 class FriendMessage(
     bot: Bot,

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/message/GroupMessage.kt

@@ -14,7 +14,6 @@ import net.mamoe.mirai.contact.Group
 import net.mamoe.mirai.contact.Member
 import net.mamoe.mirai.contact.MemberPermission
 import net.mamoe.mirai.event.Event
-import net.mamoe.mirai.message.data.At
 import net.mamoe.mirai.message.data.Message
 import net.mamoe.mirai.message.data.MessageChain
 import net.mamoe.mirai.utils.getValue
@@ -38,7 +37,6 @@ class GroupMessage(
 
     override val subject: Group get() = group
 
-    inline fun At.member(): Member = group[this.target]
     inline fun Long.member(): Member = group[this]
 
 

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/message/MessagePacket.kt

@@ -19,7 +19,7 @@ import net.mamoe.mirai.contact.Contact
 import net.mamoe.mirai.contact.Group
 import net.mamoe.mirai.contact.Member
 import net.mamoe.mirai.contact.QQ
-import net.mamoe.mirai.data.EventPacket
+import net.mamoe.mirai.data.Packet
 import net.mamoe.mirai.event.events.BotEvent
 import net.mamoe.mirai.message.data.*
 import net.mamoe.mirai.utils.*
@@ -37,7 +37,7 @@ expect abstract class MessagePacket<TSender : QQ, TSubject : Contact>(bot: Bot)
  */ // Tips: 在 IntelliJ 中 (左侧边栏) 打开 `Structure`, 可查看类结构
 @Suppress("NOTHING_TO_INLINE")
 @MiraiInternalAPI
-abstract class MessagePacketBase<TSender : QQ, TSubject : Contact>(_bot: Bot) : EventPacket, BotEvent {
+abstract class MessagePacketBase<TSender : QQ, TSubject : Contact>(_bot: Bot) : Packet, BotEvent {
     /**
      * 接受到这条消息的
      */
@@ -115,6 +115,8 @@ abstract class MessagePacketBase<TSender : QQ, TSubject : Contact>(_bot: Bot) :
      */
     inline fun QQ.at(): At = At(this as? Member ?: error("`QQ.at` can only be used in GroupMessage"))
 
+    inline fun At.member(): Member = (this@MessagePacketBase as? GroupMessage)?.group?.get(this.target) ?: error("`At.member` can only be used in GroupMessage")
+
     // endregion
 
     // region 下载图片

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/message/data/At.kt

@@ -15,7 +15,7 @@
 package net.mamoe.mirai.message.data
 
 import net.mamoe.mirai.contact.Member
-import net.mamoe.mirai.contact.groupCardOrNick
+import net.mamoe.mirai.contact.nameCardOrNick
 import net.mamoe.mirai.utils.MiraiInternalAPI
 import kotlin.jvm.JvmMultifileClass
 import kotlin.jvm.JvmName
@@ -28,7 +28,7 @@ import kotlin.jvm.JvmName
  */
 class At @MiraiInternalAPI constructor(val target: Long, val display: String) : Message {
     @UseExperimental(MiraiInternalAPI::class)
-    constructor(member: Member) : this(member.id, "@${member.groupCardOrNick}")
+    constructor(member: Member) : this(member.id, "@${member.nameCardOrNick}")
 
     override fun toString(): String = display
 

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/message/data/Image.kt

@@ -47,7 +47,7 @@ sealed class Image : Message {
     abstract val imageId: String
 
     final override fun toString(): String {
-        return "[image::$imageId]"
+        return "[mirai:$imageId]"
     }
 
     final override fun eq(other: Message): Boolean {

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/message/data/Message.kt

@@ -57,7 +57,7 @@ interface Message {
      */
     interface Key<M : Message>
 
-    infix fun eq(other: Message): Boolean = this == other
+    infix fun eq(other: Message): Boolean = this.toString() == other.toString()
 
     /**
      * 将 [toString] 与 [other] 比较

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/message/data/MessageChain.kt

@@ -38,6 +38,7 @@ import kotlin.reflect.KProperty
 interface MessageChain : Message, MutableList<Message> {
     // region Message override
     override operator fun contains(sub: String): Boolean
+
     override fun followedBy(tail: Message): MessageChain
     // endregion
 
@@ -67,6 +68,36 @@ interface MessageChain : Message, MutableList<Message> {
     }
 }
 
+/**
+ * 遍历每一个有内容的消息, 即 [At], [AtAll], [PlainText], [Image], [Face], [XMLMessage]
+ */
+inline fun MessageChain.foreachContent(block: (Message) -> Unit) {
+    this.forEachIndexed { index: Int, message: Message ->
+        if (message is At) {
+            if (index == 0 || this[index - 1] !is QuoteReply) {
+                block(message)
+            }
+        } else if (message.hasContent()) {
+            block(message)
+        }
+    }
+}
+
+/**
+ * 判断这个 [Message] 是否含有内容, 即是否为 [At], [AtAll], [PlainText], [Image], [Face], [XMLMessage]
+ */
+fun Message.hasContent(): Boolean {
+    return when (this) {
+        is At,
+        is AtAll,
+        is PlainText,
+        is Image,
+        is Face,
+        is XMLMessage -> true
+        else -> false
+    }
+}
+
 /**
  * 提供一个类型的值. 若不存在则会抛出异常 [NoSuchElementException]
  */

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/message/data/MessageSource.kt

@@ -31,6 +31,11 @@ interface MessageSource : Message {
      */
     val messageUid: Long
 
+    /**
+     * 发送时间, 单位为秒
+     */
+    val time: Long
+
     /**
      * 发送人号码
      */

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/network/BotNetworkHandler.kt

@@ -68,7 +68,7 @@ abstract class BotNetworkHandler : CoroutineScope {
      */
     @Suppress("SpellCheckingInspection")
     @MiraiInternalAPI
-    abstract suspend fun relogin()
+    abstract suspend fun relogin(cause: Throwable? = null)
 
     /**
      * 初始化获取好友列表等值.

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/utils/MiraiLogger.kt

@@ -70,6 +70,13 @@ interface MiraiLogger {
      */
     val identity: String?
 
+    /**
+     * 获取 [MiraiLogger] 是否已开启
+     *
+     * 除 [MiraiLoggerWithSwitch] 可控制开关外, 其他的所有 [MiraiLogger] 均一直开启.
+     */
+    val isEnabled: Boolean
+
     /**
      * 随从. 在 this 中调用所有方法后都应继续往 [follower] 传递调用.
      * [follower] 的存在可以让一次日志被多个日志记录器记录.
@@ -151,43 +158,43 @@ interface MiraiLogger {
 
 
 inline fun MiraiLogger.verbose(lazyMessage: () -> String) {
-    if (this is MiraiLoggerWithSwitch && switch) verbose(lazyMessage())
+    if (isEnabled) verbose(lazyMessage())
 }
 
 inline fun MiraiLogger.verbose(lazyMessage: () -> String, e: Throwable?) {
-    if (this is MiraiLoggerWithSwitch && switch) verbose(lazyMessage(), e)
+    if (isEnabled) verbose(lazyMessage(), e)
 }
 
 inline fun MiraiLogger.debug(lazyMessage: () -> String?) {
-    if (this is MiraiLoggerWithSwitch && switch) debug(lazyMessage())
+    if (isEnabled) debug(lazyMessage())
 }
 
 inline fun MiraiLogger.debug(lazyMessage: () -> String?, e: Throwable?) {
-    if (this is MiraiLoggerWithSwitch && switch) debug(lazyMessage(), e)
+    if (isEnabled) debug(lazyMessage(), e)
 }
 
 inline fun MiraiLogger.info(lazyMessage: () -> String?) {
-    if (this is MiraiLoggerWithSwitch && switch) info(lazyMessage())
+    if (isEnabled) info(lazyMessage())
 }
 
 inline fun MiraiLogger.info(lazyMessage: () -> String?, e: Throwable?) {
-    if (this is MiraiLoggerWithSwitch && switch) info(lazyMessage(), e)
+    if (isEnabled) info(lazyMessage(), e)
 }
 
 inline fun MiraiLogger.warning(lazyMessage: () -> String?) {
-    if (this is MiraiLoggerWithSwitch && switch) warning(lazyMessage())
+    if (isEnabled) warning(lazyMessage())
 }
 
 inline fun MiraiLogger.warning(lazyMessage: () -> String?, e: Throwable?) {
-    if (this is MiraiLoggerWithSwitch && switch) warning(lazyMessage(), e)
+    if (isEnabled) warning(lazyMessage(), e)
 }
 
 inline fun MiraiLogger.error(lazyMessage: () -> String?) {
-    if (this is MiraiLoggerWithSwitch && switch) error(lazyMessage())
+    if (isEnabled) error(lazyMessage())
 }
 
 inline fun MiraiLogger.error(lazyMessage: () -> String?, e: Throwable?) {
-    if (this is MiraiLoggerWithSwitch && switch) error(lazyMessage(), e)
+    if (isEnabled) error(lazyMessage(), e)
 }
 
 /**
@@ -268,7 +275,7 @@ class MiraiLoggerWithSwitch internal constructor(private val delegate: MiraiLogg
     @PublishedApi
     internal var switch: Boolean = default
 
-    val isEnabled: Boolean get() = switch
+    override val isEnabled: Boolean get() = switch
 
     fun enable() {
         switch = true
@@ -278,16 +285,16 @@ class MiraiLoggerWithSwitch internal constructor(private val delegate: MiraiLogg
         switch = false
     }
 
-    override fun verbose0(message: String?) = if (switch) delegate.verbose(message) else Unit
-    override fun verbose0(message: String?, e: Throwable?) = if (switch) delegate.verbose(message, e) else Unit
-    override fun debug0(message: String?) = if (switch) delegate.debug(message) else Unit
-    override fun debug0(message: String?, e: Throwable?) = if (switch) delegate.debug(message, e) else Unit
-    override fun info0(message: String?) = if (switch) delegate.info(message) else Unit
-    override fun info0(message: String?, e: Throwable?) = if (switch) delegate.info(message, e) else Unit
-    override fun warning0(message: String?) = if (switch) delegate.warning(message) else Unit
-    override fun warning0(message: String?, e: Throwable?) = if (switch) delegate.warning(message, e) else Unit
-    override fun error0(message: String?) = if (switch) delegate.error(message) else Unit
-    override fun error0(message: String?, e: Throwable?) = if (switch) delegate.error(message, e) else Unit
+    override fun verbose0(message: String?) = delegate.verbose(message)
+    override fun verbose0(message: String?, e: Throwable?) = delegate.verbose(message, e)
+    override fun debug0(message: String?) = delegate.debug(message)
+    override fun debug0(message: String?, e: Throwable?) = delegate.debug(message, e)
+    override fun info0(message: String?) = delegate.info(message)
+    override fun info0(message: String?, e: Throwable?) = delegate.info(message, e)
+    override fun warning0(message: String?) = delegate.warning(message)
+    override fun warning0(message: String?, e: Throwable?) = delegate.warning(message, e)
+    override fun error0(message: String?) = delegate.error(message)
+    override fun error0(message: String?, e: Throwable?) = delegate.error(message, e)
 }
 
 /**
@@ -298,54 +305,65 @@ class MiraiLoggerWithSwitch internal constructor(private val delegate: MiraiLogg
  * 在定义 logger 变量时, 请一直使用 [MiraiLogger] 或者 [MiraiLoggerWithSwitch].
  */
 abstract class MiraiLoggerPlatformBase : MiraiLogger {
+    override val isEnabled: Boolean get() = true
     final override var follower: MiraiLogger? = null
 
     final override fun verbose(message: String?) {
+        if (!isEnabled) return
         follower?.verbose(message)
         verbose0(message)
     }
 
     final override fun verbose(message: String?, e: Throwable?) {
+        if (!isEnabled) return
         follower?.verbose(message, e)
         verbose0(message, e)
     }
 
     final override fun debug(message: String?) {
+        if (!isEnabled) return
         follower?.debug(message)
         debug0(message)
     }
 
     final override fun debug(message: String?, e: Throwable?) {
+        if (!isEnabled) return
         follower?.debug(message, e)
         debug0(message, e)
     }
 
     final override fun info(message: String?) {
+        if (!isEnabled) return
         follower?.info(message)
         info0(message)
     }
 
     final override fun info(message: String?, e: Throwable?) {
+        if (!isEnabled) return
         follower?.info(message, e)
         info0(message, e)
     }
 
     final override fun warning(message: String?) {
+        if (!isEnabled) return
         follower?.warning(message)
         warning0(message)
     }
 
     final override fun warning(message: String?, e: Throwable?) {
+        if (!isEnabled) return
         follower?.warning(message, e)
         warning0(message, e)
     }
 
     final override fun error(message: String?) {
+        if (!isEnabled) return
         follower?.error(message)
         error0(message)
     }
 
     final override fun error(message: String?, e: Throwable?) {
+        if (!isEnabled) return
         follower?.error(message, e)
         error0(message, e)
     }

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/utils/cryptor/ECDH.kt

@@ -19,7 +19,9 @@ expect interface ECDHPublicKey {
     fun getEncoded(): ByteArray
 }
 
-expect class ECDHKeyPair {
+internal expect class ECDHKeyPairImpl : ECDHKeyPair
+
+interface ECDHKeyPair {
     val privateKey: ECDHPrivateKey
     val publicKey: ECDHPublicKey
 
@@ -27,6 +29,15 @@ expect class ECDHKeyPair {
      * 私匙和固定公匙([initialPublicKey]) 计算得到的 shareKey
      */
     val initialShareKey: ByteArray
+
+    object DefaultStub : ECDHKeyPair {
+        val defaultPublicKey = "020b03cf3d99541f29ffec281bebbd4ea211292ac1f53d7128".chunkedHexToBytes()
+        val defaultShareKey = "4da0f614fc9f29c2054c77048a6566d7".chunkedHexToBytes()
+
+        override val privateKey: Nothing get() = error("stub!")
+        override val publicKey: Nothing get() = error("stub!")
+        override val initialShareKey: ByteArray get() = defaultShareKey
+    }
 }
 
 /**
@@ -41,6 +52,8 @@ expect class ECDH(keyPair: ECDHKeyPair) {
     fun calculateShareKeyByPeerPublicKey(peerPublicKey: ECDHPublicKey): ByteArray
 
     companion object {
+        val isECDHAvailable: Boolean
+
         /**
          * 由完整的 publicKey ByteArray 得到 [ECDHPublicKey]
          */
@@ -60,14 +73,11 @@ expect class ECDH(keyPair: ECDHKeyPair) {
     override fun toString(): String
 }
 
-/**
- *
- */
 @Suppress("FunctionName")
 expect fun ECDH(): ECDH
 
-val initialPublicKey =
-    ECDH.constructPublicKey("3046301006072A8648CE3D020106052B8104001F03320004928D8850673088B343264E0C6BACB8496D697799F37211DEB25BB73906CB089FEA9639B4E0260498B51A992D50813DA8".chunkedHexToBytes())
+val initialPublicKey
+    get() = ECDH.constructPublicKey("3046301006072A8648CE3D020106052B8104001F03320004928D8850673088B343264E0C6BACB8496D697799F37211DEB25BB73906CB089FEA9639B4E0260498B51A992D50813DA8".chunkedHexToBytes())
 private val commonHeadFor02 = "302E301006072A8648CE3D020106052B8104001F031A00".chunkedHexToBytes()
 private val commonHeadForNot02 = "3046301006072A8648CE3D020106052B8104001F033200".chunkedHexToBytes()
 private const val constantHead = "3046301006072A8648CE3D020106052B8104001F03320004"

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/utils/cryptor/Proto.kt → mirai-core/src/commonMain/kotlin/net.mamoe.mirai/utils/cryptor/protoBuf.kt

@@ -17,7 +17,6 @@ import kotlinx.io.core.readUInt
 import kotlinx.io.core.readULong
 import net.mamoe.mirai.utils.MiraiDebugAPI
 import net.mamoe.mirai.utils.MiraiExperimentalAPI
-import net.mamoe.mirai.utils.MiraiInternalAPI
 import net.mamoe.mirai.utils.io.*
 import kotlin.jvm.JvmStatic
 

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/utils/io/TypeConversion.kt → mirai-core/src/commonMain/kotlin/net.mamoe.mirai/utils/io/conversion.kt

@@ -21,6 +21,16 @@ import kotlin.random.nextInt
  * 这些函数为内部函数, 可能会改变
  */
 
+/**
+ * 255 -> 00 FF
+ */
+fun Short.toByteArray(): ByteArray = with(toInt()) {
+    byteArrayOf(
+        (shr(8) and 0xFF).toByte(),
+        (shr(0) and 0xFF).toByte()
+    )
+}
+
 /**
  * 255 -> 00 00 00 FF
  */

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/utils/Time.kt → mirai-core/src/commonMain/kotlin/net.mamoe.mirai/utils/time.kt

@@ -14,7 +14,6 @@ package net.mamoe.mirai.utils
 
 import kotlin.jvm.JvmMultifileClass
 import kotlin.jvm.JvmName
-import kotlin.time.seconds
 
 // 临时使用, 待 Kotlin Duration 稳定后使用 Duration.
 // 内联属性, 则将来删除这些 API 将不会导致二进制不兼容.

mirai-core/src/commonMain/kotlin/net.mamoe.mirai/utils/tryNTimes.kt

@@ -15,17 +15,16 @@ expect fun Throwable.addSuppressed(e: Throwable)
 
 @MiraiInternalAPI
 @Suppress("DuplicatedCode")
-inline fun <R> tryNTimes(repeat: Int, block: () -> R): R {
+inline fun <R> tryNTimes(repeat: Int, block: (Int) -> R): R {
     var lastException: Throwable? = null
 
     repeat(repeat) {
         try {
-            return block()
+            return block(it)
         } catch (e: Throwable) {
             if (lastException == null) {
                 lastException = e
-            }
-            lastException!!.addSuppressed(e)
+            } else lastException!!.addSuppressed(e)
         }
     }
 
@@ -34,17 +33,16 @@ inline fun <R> tryNTimes(repeat: Int, block: () -> R): R {
 
 @MiraiInternalAPI
 @Suppress("DuplicatedCode")
-inline fun <R> tryNTimesOrNull(repeat: Int, block: () -> R): R? {
+inline fun <R> tryNTimesOrNull(repeat: Int, block: (Int) -> R): R? {
     var lastException: Throwable? = null
 
     repeat(repeat) {
         try {
-            return block()
+            return block(it)
         } catch (e: Throwable) {
             if (lastException == null) {
                 lastException = e
-            }
-            lastException!!.addSuppressed(e)
+            } else lastException!!.addSuppressed(e)
         }
     }
 
@@ -53,18 +51,17 @@ inline fun <R> tryNTimesOrNull(repeat: Int, block: () -> R): R? {
 
 @MiraiInternalAPI
 @Suppress("DuplicatedCode")
-inline fun <R> tryNTimesOrException(repeat: Int, block: () -> R): Throwable? {
+inline fun <R> tryNTimesOrException(repeat: Int, block: (Int) -> R): Throwable? {
     var lastException: Throwable? = null
 
     repeat(repeat) {
         try {
-            block()
+            block(it)
             return null
         } catch (e: Throwable) {
             if (lastException == null) {
                 lastException = e
-            }
-            lastException!!.addSuppressed(e)
+            } else lastException!!.addSuppressed(e)
         }
     }
 

mirai-core/src/jvmMain/kotlin/net/mamoe/mirai/BotFactoryJvm.kt

@@ -29,13 +29,13 @@ internal val factory: BotFactory = run {
     """
     No BotFactory found. Please ensure that you've added dependency of protocol modules.
     Available modules:
-    - net.mamoe:mirai-core-timpc
+    - net.mamoe:mirai-core-timpc (stays at 0.12.0)
     - net.mamoe:mirai-core-qqandroid (recommended)
     You should have at lease one protocol module installed.
     -------------------------------------------------------
     找不到 BotFactory. 请确保你依赖了至少一个协议模块.
     可用的协议模块: 
-    - net.mamoe:mirai-core-timpc
+    - net.mamoe:mirai-core-timpc (0.12.0 后停止更新)
     - net.mamoe:mirai-core-qqandroid (推荐)
     请添加上述任一模块的依赖(与 mirai-core 版本相同)
     """.trimIndent()

mirai-core/src/jvmMain/kotlin/net/mamoe/mirai/MiraiEnvironmentJvm.kt

-/*
- * Copyright 2020 Mamoe Technologies and contributors.
- *
- * 此源代码的使用受 GNU AFFERO GENERAL PUBLIC LICENSE version 3 许可证的约束, 可以在以下链接找到该许可证.
- * Use of this source code is governed by the GNU AGPLv3 license that can be found through the following link.
- *
- * https://github.com/mamoe/mirai/blob/master/LICENSE
- */
-
-@file:Suppress("MayBeConstant", "unused")
-
-package net.mamoe.mirai
-
-actual object MiraiEnvironment {
-    @JvmStatic
-    actual val platform: Platform
-        get() = Platform.JVM
-}
\ No newline at end of file

mirai-core/src/jvmMain/kotlin/net/mamoe/mirai/event/internal/EventInternalJvm.kt

@@ -16,15 +16,16 @@ import net.mamoe.mirai.event.ListeningStatus
 import net.mamoe.mirai.utils.MiraiInternalAPI
 import java.util.function.Consumer
 import java.util.function.Function
+import kotlin.coroutines.EmptyCoroutineContext
 
 @MiraiInternalAPI
 @Suppress("FunctionName")
 fun <E : Event> Class<E>._subscribeEventForJaptOnly(scope: CoroutineScope, onEvent: Function<E, ListeningStatus>): Listener<E> {
-    return this.kotlin.subscribeInternal(scope.Handler { onEvent.apply(it) })
+    return this.kotlin.subscribeInternal(scope.Handler(EmptyCoroutineContext) { onEvent.apply(it) })
 }
 
 @MiraiInternalAPI
 @Suppress("FunctionName")
 fun <E : Event> Class<E>._subscribeEventForJaptOnly(scope: CoroutineScope, onEvent: Consumer<E>): Listener<E> {
-    return this.kotlin.subscribeInternal(scope.Handler { onEvent.accept(it); ListeningStatus.LISTENING; })
+    return this.kotlin.subscribeInternal(scope.Handler(EmptyCoroutineContext) { onEvent.accept(it); ListeningStatus.LISTENING; })
 }
\ No newline at end of file

mirai-core/src/jvmMain/kotlin/net/mamoe/mirai/event/internal/MiraiAtomicBoolean.kt

+package net.mamoe.mirai.event.internal
+
+import java.util.concurrent.atomic.AtomicBoolean
+
+
+internal actual class MiraiAtomicBoolean actual constructor(initial: Boolean) {
+    private val delegate: AtomicBoolean = AtomicBoolean(initial)
+
+    actual fun compareAndSet(expect: Boolean, update: Boolean): Boolean {
+        return delegate.compareAndSet(expect, update)
+    }
+
+    actual var value: Boolean
+        get() = delegate.get()
+        set(value) {
+            delegate.set(value)
+        }
+}
\ No newline at end of file

mirai-core/src/jvmMain/kotlin/net/mamoe/mirai/utils/BotConfigurationJvm.kt

@@ -105,8 +105,8 @@ class DefaultLoginSolver(
     override suspend fun onSolveUnsafeDeviceLoginVerify(bot: Bot, url: String): String? = loginSolverLock.withLock {
         val logger = getLogger(bot)
         logger.info("需要进行账户安全认证")
-        logger.info("该账户有[设备锁]/[不常用登陆地点]/[不常用设备登陆]的问题")
-        logger.info("完成以下账号认证即可成功登陆|理论本认证在mirai每个账户中最多出现1次")
+        logger.info("该账户有[设备锁]/[不常用登录地点]/[不常用设备登录]的问题")
+        logger.info("完成以下账号认证即可成功登录|理论本认证在mirai每个账户中最多出现1次")
         logger.info("请将该链接在QQ浏览器中打开并完成认证, 成功后输入任意字符")
         logger.info("这步操作将在后续的版本中优化")
         logger.info(url)
@@ -221,11 +221,11 @@ actual open class BotConfiguration actual constructor() {
     /**
      * 重连失败后, 继续尝试的每次等待时间
      */
-    actual var reconnectPeriodMillis: Long = 60.secondsToMillis
+    actual var reconnectPeriodMillis: Long = 5.secondsToMillis
     /**
      * 最多尝试多少次重连
      */
-    actual var reconnectionRetryTimes: Int = 3
+    actual var reconnectionRetryTimes: Int = Int.MAX_VALUE
     /**
      * 验证码处理器
      */

mirai-core/src/jvmMain/kotlin/net/mamoe/mirai/utils/cryptor/ECDHJvm.kt

@@ -9,7 +9,6 @@
 
 package net.mamoe.mirai.utils.cryptor
 
-import net.mamoe.mirai.utils.io.chunkedHexToBytes
 import net.mamoe.mirai.utils.md5
 import org.bouncycastle.jce.provider.BouncyCastleProvider
 import java.security.*
@@ -21,20 +20,13 @@ import javax.crypto.KeyAgreement
 actual typealias ECDHPrivateKey = PrivateKey
 actual typealias ECDHPublicKey = PublicKey
 
-actual class ECDHKeyPair(
-    private val delegate: KeyPair?
-) {
-    actual val privateKey: ECDHPrivateKey get() = delegate?.private ?: error("ECDH is not available")
-    actual val publicKey: ECDHPublicKey get() = delegate?.public ?: defaultPublicKey
+internal actual class ECDHKeyPairImpl(
+    private val delegate: KeyPair
+) : ECDHKeyPair {
+    override val privateKey: ECDHPrivateKey get() = delegate.private
+    override val publicKey: ECDHPublicKey get() = delegate.public
 
-    actual val initialShareKey: ByteArray = if (delegate == null) {
-        defaultShareKey
-    } else ECDH.calculateShareKey(privateKey, initialPublicKey)
-
-    companion object {
-        internal val defaultPublicKey = "020b03cf3d99541f29ffec281bebbd4ea211292ac1f53d7128".chunkedHexToBytes().adjustToPublicKey()
-        internal val defaultShareKey = "4da0f614fc9f29c2054c77048a6566d7".chunkedHexToBytes()
-    }
+    override val initialShareKey: ByteArray = ECDH.calculateShareKey(privateKey, initialPublicKey)
 }
 
 @Suppress("FunctionName")
@@ -42,33 +34,34 @@ actual fun ECDH() = ECDH(ECDH.generateKeyPair())
 
 actual class ECDH actual constructor(actual val keyPair: ECDHKeyPair) {
     actual companion object {
-        private var isECDHAvailable = true
+        @Suppress("ObjectPropertyName")
+        private val _isECDHAvailable: Boolean = kotlin.runCatching {
+            if (Security.getProvider(BouncyCastleProvider.PROVIDER_NAME) != null) {
+                Security.removeProvider(BouncyCastleProvider.PROVIDER_NAME)
+            }
+            Security.addProvider(BouncyCastleProvider())
+            generateKeyPair() // try if it is working
+        }.isSuccess
 
-        init {
-            isECDHAvailable = kotlin.runCatching {
-                Security.addProvider(BouncyCastleProvider())
-                generateKeyPair() // try if it is working
-            }.isSuccess
-        }
+        actual val isECDHAvailable: Boolean get() = _isECDHAvailable
 
         actual fun generateKeyPair(): ECDHKeyPair {
-            return if (!isECDHAvailable) {
-                ECDHKeyPair(null)
-            } else ECDHKeyPair(KeyPairGenerator.getInstance("EC", "BC").apply { initialize(ECGenParameterSpec("secp192k1")) }.genKeyPair())
+            if (!isECDHAvailable) {
+                return ECDHKeyPair.DefaultStub
+            }
+            return ECDHKeyPairImpl(KeyPairGenerator.getInstance("ECDH")
+                .also { it.initialize(ECGenParameterSpec("secp192k1")) }
+                .genKeyPair())
         }
 
         actual fun calculateShareKey(
             privateKey: ECDHPrivateKey,
             publicKey: ECDHPublicKey
         ): ByteArray {
-            return if (!isECDHAvailable) {
-                ECDHKeyPair.defaultShareKey
-            } else {
-                val instance = KeyAgreement.getInstance("ECDH", "BC")
-                instance.init(privateKey)
-                instance.doPhase(publicKey, true)
-                md5(instance.generateSecret())
-            }
+            val instance = KeyAgreement.getInstance("ECDH", "BC")
+            instance.init(privateKey)
+            instance.doPhase(publicKey, true)
+            return md5(instance.generateSecret())
         }
 
         actual fun constructPublicKey(key: ByteArray): ECDHPublicKey {

mirai-core/src/jvmMain/kotlin/net/mamoe/mirai/utils/io/PlatformSocket.kt

@@ -30,7 +30,10 @@ actual class PlatformSocket : Closeable {
     private lateinit var socket: Socket
 
     actual val isOpen: Boolean
-        get() = socket.isConnected
+        get() =
+            if (::socket.isInitialized)
+                socket.isConnected
+            else false
 
     actual override fun close() {
         if (::socket.isInitialized) {

mirai-core/src/jvmTest/kotlin/net/mamoe/mirai/utils/LockFreeLinkedListTest.kt

@@ -63,9 +63,6 @@ internal class LockFreeLinkedListTest {
         val addJob = async { list.concurrentDo(2, 30000) { addLast(1) } }
 
         //delay(1) // let addJob fly
-        if (addJob.isCompleted) {
-            println("Number of elements are not enough")
-        }
         val foreachJob = async {
             list.concurrentDo(1, 10000) {
                 forEach { it + it }

mirai-japt/README.md

@@ -32,7 +32,7 @@ Mirai Java Apt
 <dependencies>
     <dependency>
         <groupId>net.mamoe</groupId>
-        <artifactId>mirai-core-qqandroid</artifactId>
+        <artifactId>mirai-core-qqandroid-jvm</artifactId>
         <version>CORE_VERSION</version> <!-- 替换版本为最新版本 -->
     </dependency>
     
@@ -51,7 +51,7 @@ repositories {
 }
 
 dependencies {
-  implementation("net.mamoe:mirai-core-qqandroid:CORE_VERSION")
+  implementation("net.mamoe:mirai-core-qqandroid-jvm:CORE_VERSION")
   implementation("net.mamoe:mirai-japt:JAPT_VERSION")
 }
 ```

mirai-japt/build.gradle.kts

@@ -59,7 +59,7 @@ fun kotlinx(id: String, version: String) = "org.jetbrains.kotlinx:kotlinx-$id:$v
 fun ktor(id: String, version: String) = "io.ktor:ktor-$id:$version"
 
 dependencies {
-    api(project(":mirai-core"))
+    implementation(project(":mirai-core"))
     runtimeOnly(files("../mirai-core/build/classes/kotlin/jvm/main")) // classpath is not added correctly by IDE
 
     api(group = "org.jetbrains.kotlinx", name = "kotlinx-coroutines-javafx", version = "1.3.2")

mirai-japt/src/main/java/net/mamoe/mirai/japt/BlockingBot.java

@@ -184,5 +184,13 @@ public interface BlockingBot {
     /**
      * 关闭这个 [Bot], 停止一切相关活动. 不可重新登录.
      */
-    void dispose(@Nullable Throwable throwable);
+    void close(@Nullable Throwable throwable);
+
+    /**
+     * @deprecated 使用 {@link #close(Throwable)}
+     */
+    @Deprecated
+    default void dispose(@Nullable Throwable throwable) {
+        close(throwable);
+    }
 }