# Version 1.x ## `1.3.2` 2020/10/04 - 修复缓存过滤的错误导致的戳一戳等信息没法及时处理的问题 ## `1.3.1` 2020/9/21 ### 新特性 - 无 ### 优化和修复 - 修复 `BotJoinGroupEvent.Retrieve` 的显示错误 (#606 by @Karlatemp) - 添加缺少的戳一戳模板 (#615 by @sandtechnology) - 修复罕见情况下的群成员加群 `member -XXXX not found in XXXX` ## `1.3.0` 2020/9/16 ### 新特性 - 支持群恢复相关事件: `MemberJoinEvent.Retrieve`, `BotJoinGroupEvent.Retrieve` (#531 by @Karlatemp) - 群荣耀获取 (`Bot._lowLevelGetGroupHonorListData`) (#501 by @yyuueexxiinngg) - 戳一戳事件: `MemberNudgedEvent`, `BotNudgedEvent`.(#600 by @sandtechnology) - 发送戳一戳: `Bot.nudge()`, `User.nudge()` - 为 `BotFactory` 添加伴生对象. 在顶层方法不方便使用时可使用伴生对象的 `Bot` 构建方法 ### 优化和修复 - **修复好友消息和事件同步相关问题:** - 部分情况下无法同步好友消息 (#249) - BotInvitedJoinGroupRequestEvent 重复执行两次 (#449) - 群消息可能发送失败 (#527) - 机器人启动后第二次被拉入群聊不会刷新群列表 (#580) - 新群员入群事件只触发一次 (#590) - 入群申请 MemberJoinRequestEvent 没有广播 (#542) - 新成员入群未处理 (#567) - 修复 `At` 之后的多余空格的问题 (#557) - 修复 `QuoteReply` 前多余 `At` 和空格的问题 (#524) - 修复群信息初始值 (`isMuteAll`, `isAllowMemberInvite`, ...) (#286) - 修复 `Voice.url` 的域名缺失问题 (#584 by @Hieuzest) - 修复日志颜色污染的问题 (#596 by @Karlatemp) - 修复 `Bot.nick` 无法获取的问题 (#566) - 修复登录时 `IndexOutOfBoundsException` 的问题 (#598) - 修复 Bot 被踢出群收到的事件类型错误的问题 (#358) (#509 by @sandtechnology) - 修复 `Bot.close` 后必须收到一个数据包才会关闭的问题 (#557) - 优化 `PermissionDeniedException` 的消息内容 ## `1.2.3` 2020/9/11 - 在同步事件失败时添加重试, 改善 #249, #482, #542, #567, #590 - 修复不断重连同一个服务器的问题 (#589) - 修复 `BotJoinGroupEvent.Active` 和 `BotJoinGroupEvent.Invite` 没有继承 `BotJoinGroupEvent` 的问题 (#532 by [@yyuueexxiinngg](https://github.com/yyuueexxiinngg)) - 修复 `EmptyMessageChain` 与其他 `MessageChain` 拼接时发生 `NoSuchElementException` 的问题 (#550, #561 by [@sandtechnology](https://github.com/sandtechnology)) - 为 `Image.queryUrl` 添加 JvmBlockingBridge - 优化 `PermissionDeniedException` 的错误信息 - 更新到 Kotlin `1.4.10` ## `1.2.2` 2020/8/22 - 修复依赖冲突问题 (#523) ## `1.2.1` 2020/8/19 - 修复在 Java 调用 `group.uploadImage` 时编译出错的问题 (#511) - 为 `group.uploadVoice` 添加 Java 方法 (需要 [kotlin-jvm-blocking-bridge](https://github.com/mamoe/kotlin-jvm-blocking-bridge)) (#512) - 更新 ktor 到 1.4.0 ## `1.2.0` 2020/8/19 ### 新特性 - 初步语音支持: `Group.uploadVoice`, 支持 silk 或 amr 格式. **注意**: 现阶段语音实现仅为临时方案, 在将来 (`2.0.0`) 一定会变动. 使用时请评估可能带来的不兼容性. - 新增将日志转换为 log4j, JDK Logger, SLF4J 等框架的方法: `LoggerAdapters` (#498 by [@Karlatemp](https://github.com/Karlatemp)) - 支持解析好友输入状态: `FriendInputStatusChangedEvent` (by [@sandtechnology](https://github.com/sandtechnology)) - 支持解析好友昵称改变事件: `FriendNickChangedEvent` (#507 by [@Karlatemp](https://github.com/Karlatemp)) - `nextEvent` 和 `nextEventOrNull` 添加 `filter` - 将 mirai 码相关内容从 mirai-serialization 集成到 mirai-core - `GroupMessageEvent` 现在实现接口 `GroupEvent` - `FriendMessageEvent` 现在实现接口 `FriendEvent` (#444) ### 依赖更新 - 更新 Kotlin 版本到 [`1.4.0`](https://blog.jetbrains.com/zh-hans/kotlin/2020/08/kotlin-1-4-released-with-a-focus-on-quality-and-performance-zh/) - 更新 kotlinx-coroutines-core 到 `1.3.9` - 使用者也需要更新到 `1.4.0`, 至少更新编译器 (Maven 和 Gradle 插件) - **更新 kotlinx-serialization 到 `1.0.0-RC`**: kotlinx-serialization 在此版本做了较大的不兼容改动. ### API 弃用 - `String.toMessage`: 为避免和 mirai code 产生混乱. - `URL.toExternalImage` - `Input.toExternalImage` ### 优化和修复 - 显式 API - mirai 的所有公开 API 均已经显式加上 `public` 修饰符, 遵循 [Koltin Explicit API mode](https://kotlinlang.org/docs/reference/whatsnew14.html#explicit-api-mode-for-library-authors) 规范. 如: ```kotlin data class BotOnlineEvent internal constructor( override val bot: Bot ) : BotActiveEvent, AbstractEvent() ``` - *调整了一些不应该公开的 API 为 `internal`, 这些调整在绝大多数情况下不影响现有代码* - 修复群权限判断失败的问题 (#389) - 修复 `syncFromEvent` 文档错误 (#427) - 新增 `BotConfiguration.loadDeviceInfoJson(String)` (#450) - 修复成员进群后第一次发言触发改名事件的问题 (#475 by [@cxy654849388](https://github.com/cxy654849388) - 修复 `group.quit` 未正确执行的问题 (#472, #477 by [@Mr4s](https://github.com/Mrs4s) - 修复初始化时 syncCookie 同步问题 - 修复 Network Protocol: java.lang.IllegalStateException: returnCode = -10008 (#470) - 修复 `Member.isMuted` - 修复 `Method.registerEvent` 相关问题 (#495 by @sandtechnology, #499 by @Karlatemp) - 修复 Android 手表协议无法监听撤回事件的问题 (#448) - 改进好友消息同步过程 ## `1.1.3` 2020/7/17 - 修复 ListenerHost Java 兼容性问题 (#443, #446 by [@Karlatemp](https://github.com/Karlatemp)) ## `1.1.2` 2020/7/16 - 修复 JvmMethodEvents `T.registerEvents` 注册时错误判断 `@NotNull` 注解的问题 (#436) ## `1.1.1` 2020/7/11 - 修复最后一个 mirai 码之后的消息无法解析的问题 (#431 [@cxy654849388](https://github.com/cxy654849388)) ## `1.1.0` 2020/7/9 - 支持 Android 手表协议 (`BotConfiguration.MiraiProtocol.ANDROID_WATCH`) - `EventHandler` 现在支持 `Nothing` 类型. - 修复无需同意直接进群时，在加载新群信息完成前收到消息过早处理的问题 (#370) - 修复在某些情况下，管理员邀请群Bot加群会被误判为群成员申请加群的问题 (#402 by [@kenvix](https://github.com/kenvix)) - 修复从其他客户端加群时未同步的问题 (#404, #410) - 修复 `ConfigPushSvc.PushReq` 解析失败的问题 (#417) - 修复 `_lowLevelGetGroupActiveData` - 修复 `SimpleListenerHost.coroutineScope` 潜在的 Job 被覆盖的问题 ## `1.0.4` 2020/7/2 - 修复上传图片失败时内存泄露的问题 (#385) - 修复大量图片同时上传时出错的问题 (#387) - 修复在一些情况下 BotOfflineEvent 没有正常处理而无法继续接收消息的问题 (#376) - 修复 Bot 在某个群 T 出某个人导致 Bot 终止的问题 (#372) - 修复 `@PlannedRemoval` 的文档 ## `1.1-EA2` 2020/7/2 - 添加 `BotConfiguration.json`, 作为序列化时使用的 Json format, 修复潜在的因 kotlinx.serialization 进行不兼容更新而导致的不兼容. **不兼容变更**: - Image.imageId 后缀由 `.mirai` 变为图片文件实际类型, 如 `.png`, `.jpg`. 兼容原 `.mirai` 后缀. **修复**: - ([1.0.4](https://github.com/mamoe/mirai/releases/tag/1.0.4) 中修复的问题) - ([1.0.3](https://github.com/mamoe/mirai/releases/tag/1.0.3) 中修复的问题) ## `1.0.3` 2020/6/29 - 修复 friendlist.GetTroopListReqV2：java.lang.IllegalStateException: type mismatch 10 (#405) ## `1.1-EA` 2020/6/16 **主要**: - 添加实验性 `CodableMessage` 作为支持 mirai 码的 `Message` 的接口. - 支持 [mirai 码](docs\mirai-code-specification.md) 解析; 新模块 [`mirai-serialization`](mirai-serialization) - 实现 `MessagePreSendEvent` 和 `MessagePostSendEvent` (#339). **不兼容变更**: - 重命名实验性 API `CustomMessage.Factory.serialize` 到 `CustomMessage.Factory.dump` - 重命名实验性 API `CustomMessage.Factory.deserialize` 到 `CustomMessage.Factory.load` - 弃用 `MessageSendEvent` (#339). 迁移计划: WARNING in 1.1.0, ERROR in 1.2.0, REMOVE in 1.3.0 - 调整 `VipFace` 的 mirai 码表示, 详见 mirai 码规范 - `Face.toString()` 现在返回表情名称, 如 "\[偷笑\]", 而不是 "\[表情\]" (#345 @goldimax) **优化和修复**: - 修复群头像的获取不正确的问题 (#340) - 将 `PttMessage` 与 `Voice` 标注 `@MiraiExperimentalAPI` (missing) - 删除 `Message.plus(another: Flow)` 的 `@ExperimentalCoroutinesApi` - 提升发送群消息的稳定性 - 一些文档优化 - 其他内部优化 - 提升在上个版本中弃用的 API 的弃用等级 ## `1.0.2` 2020/6/1 - 新增 `Bot.botInstancesSequence` - 修复日志中的时间未更新的问题 - 修复在某些情况下，Bot登录的时候无限重连 (#361) - 优化一些文档注释 ## `1.0.1` 2020/5/25 - 新增临时会话消息发送事件: `TempMessageSendEvent` (#338) - 新增 `Bot.isOnline` (#342)
- 修复日志重定向到文件后无换行的问题 - 修复 Bot 被邀请入群事件的解析, 添加 `BotJoinGroupEvent.Invite` (#344) - 修复 IPv6 地址支持 (#334) - 修复一些 KDoc (#337) - 优化一些内部的日志的显示 ## `1.0.0` 2020/5/22 - `ContactOrBot` 现在继承 `CoroutineScope` - 在没有手动指定 `deviceInfo` 时构建 Bot 将会发出警告, 须手动选择使用 `randomDeviceInfo` 或 `fileBasedDeviceInfo` 或自定义, 详见 [BotConfiguration.kt: Lines 69-72](mirai-core/src/commonMain/kotlin/net.mamoe.mirai/utils/BotConfiguration.common.kt#L69-L72)
- 引入 `SimpleListenerHost` 以帮助 Java 处理事件监听 - 添加 Java 广播事件的方式: `EventKt.broadcast(Event)` - 添加 `Bot.getInstanceOrNull` - 改进 JVM 平台的 `PlatformLogger`, 添加 `DirectoryLogger`, `SingleFileLogger` 以提供重定向日志的快捷方式 - 统一日志格式, 使用 (正则) `^([\w-]*\s[\w:]*)\s(\w)\/(.*?):\s(.+)$`. 详见 [PlatformLogger.jvm.kt: Line 46](mirai-core/src/jvmMain/kotlin/net/mamoe/mirai/utils/PlatformLogger.jvm.kt#L46)
- 弃用 `Bot.queryUrl(Image)`, 改用 `image.queryUrl()` 扩展. (保留兼容到 1.2.0) - 弃用 `Bot.accept*`, `Bot.reject*` 等相应入群请求等事件的方法, 改用事件的成员函数. (保留兼容到 1.2.0)
- 修复 `Bot` 实例化时 `NPE` 问题 - 修复网络状态差时 `Bot` 网络模块无法处理分包的问题 - 修复当无 Bot 在线时调用 `image.queryUrl()` 抛出的异常与 KDoc 描述不符的问题 - 修复 `BotJoinGroupEvent` 重复广播问题 - 修复邀请 Bot 进群时事件处理异常的问题 (#319) - 修复当 `Event` 被实现为一个 Kotlin `object` 时无法正常拦截事件的问题 - 修复图片链接获取为空的问题 (#318) - 修复成员被移除群后可能发生内存泄露的问题 - 修复异常没有正确输出到日志的问题 - 修复一些 `DefaultLogger` 的不恰当使用的问题 - 修复 `UnknownHostException` 未被正常捕获的问题
- 在 Bot 被禁言时忽略 `reply` 方式创建的监听器 (`subscribeMessages` DSL) - 使用更宽松的方式读取 `device.json` - 将 `Bot.selfQQ` 标注 `@MiraiExperimentalAPI` - 提高默认心跳超时时间 - 改进多处 KDoc - 更新 kotlinx-coroutines-core 到 1.3.7 - ... 忽略了内部变动 ## `1.0-RC2-1` 2020/5/11 修复一个 `VerifyError` ## `1.0-RC2` 2020/5/11 主要内容: - 增强网络稳定性 (#298, #317), 修复 `Bot.close` 或 Bot 离线后没有从 `Bot.botInstances` 中删除的问题 (#317) - `subscribeMessages` 现在默认使用 `MONITOR` 优先级 - `MessageChain` 现在继承 `List` - 新增 `messageChainOf(vararg Message)` - 支持 Bot 头像更改事件: `BotAvatarChangedEvent` (#271) - 支持好友头像更改事件: `FriendAvatarChangedEvent` - 新增 `nextEventOrNull`: 挂起当前协程, 直到监听到事件的广播, 返回这个事件实例. 超时时返回 `null` - **弃用 `Bot.subscribe.*`, `Bot.nextMessage`, `Bot.subscribe.*Messages`: 为了更好的协程生命周期管理, 这些函数已经被隐藏, 保留二进制兼容到 1.3.0**. 现有源代码不会被破坏, 但将不再筛选事件的 `Bot` 实例. 在 mirai 决定好替代的 API 前需要手动筛选. (即不影响目前单 Bot 运行的服务) - 支持在事件监听时使用 Kotlin 函数引用: ```kotlin suspend fun onMessage(event: GroupMessageEvent): ListeningStatus { return ListeningStatus.LISTENING } scope.subscribe(::onMessage /*, priority=..., concurrency=... */) ``` - 支持反射式事件监听, 改善 Java 的事件监听体验. 示例查看 [JvmMethodEventsTest.kt: Line 22](mirai-core/src/jvmTest/kotlin/net/mamoe/mirai/event/JvmMethodEventsTest.kt#L22) - 添加 `typealias EventPriority = Listener.EventPriority` - 优化 `Face` 的构造器: 现在 `Face` 拥有一个参数为 `id` 的公开构造器 - 让 `ContactList` 实现接口 `Collection` - 弃用 `QuoteReply.time` 等语意不明的扩展 (无法区分 `time` 是 `source` 的时间还是 `QuoteReply` 自身时间) 优化 & 修复: - 删除 `FileCacheStrategy.newImageCache(URL, format: String)` 中的 `format` 参数 - 隐藏 `MessageChain` 原有 `Iterable` 相关 API (兼容现有代码) - 修复 `Message.repeat` - 修复 `MemberJoinEvent` 比 `MemberJoinRequestEvent` 早广播的问题 (#288) - 修复 Bot 接受好友申请时 groupId 处理错误 (#309) - 修复 `MessageSubscribersBuilder` 一处 KDoc 错误 (#308 @wuxianucw) - 修复 Android 平台 `BufferedImage ClassNotDefFound` 的问题 - 优化 `MessageSource.internalId` KDoc - 优化 重连时的计时显示 (#311 @Karlatemp) - 优化 `Bot.getInstance` 找不到相关 `Bot` 实例时的异常信息 - 将 `MessageMetadata.contentToString` 定义为 `final` - 忽略了 732 类型同步消息 (原启动后会大量显示) - 忽略 'VIP 进群提示' 的群同步消息 - 让随机设备信息更随机 - 其他一些内部优化 (无公开 API 变更) ## `1.0-RC` 2020/5/6 ### 事件优先级与拦截 > 特别感谢 @Karlatemp (#279) - 支持事件拦截: `Event.intercept()`, `Event.isIntercepted` - 支持事件优先级: `HIGHEST, HIGH, NORMAL, LOW, LOWEST` 和 `MONITOR` 事件广播时按监听器的优先级从高到低依次调用, 在任意一个监听器 拦截事件(`Event.intercept()`) 后停止广播, 不调用后续监听器. 最后调用 `MONITOR` 级别的监听器. - 在 `subscribe`, `subscribeAlways`, `nextMessage`, `syncFromEvent`, `subscribeMessages` 等所有事件监听函数中添加 `priority` 参数, 默认使用 `NORMAL` 优先级. 兼容 `1.0` 以前的 API 到 `1.2.0`, 旧版本 API 使用 `MONITOR` 级别. ### 图片缓存策略 `FileCacheStrategy` - 新增 `FileCacheStrategy`, 可管理上传图片等操作时的缓存行为. - 内置内存缓存 (`FileCacheStrategy.MemoryCache`) 与默认使用的临时文件 (`FileCacheStrategy.TempCache`) 缓存, 可选临时文件存放目录 - 新增 `BotConfiguration.fileCacheStrategy`, 为单个 `Bot` 指定缓存策略 - 在图片上传 (无论是否成功) 删除临时文件 - 图片上传失败时支持自动重试 - 修复部分情况下文件没有关闭的问题 (#302) - 因新架构为懒惰处理, 弃用所有 `*.suspendToExternalImage` ### 修正 `ContactMessage` 命名歧义 (#299) - 原有 `ContactMessage` 实际上是一个事件, 而其命名与消息 `Message` 易产生迷惑. 弃用 (兼容到 `1.2.0`): - `MessagePacket` - `MessagePacketBase` 进行如下更名: - `ContactMessage` -> `MessageEvent` - `FriendMessage` -> `FriendMessageEvent` - `GroupMessage` -> `GroupMessageEvent` - `TempMessage` -> `TempMessageEvent` 暂未决定是否提供 `UserMessageEvent` 作为 `TempMessageEvent` 和 `FriendMessageEvent` 的公共父类. - 优化扩展函数结构, 统一放置在 `MessageEventExtensions`, 以使 `MessageEvent` 结构清晰. ### 支持平板登录方式 - 可选, 且默认作为平板身份登录, 与手机电脑不冲突. - 可通过 `BotConfiguration.protocol` 切换协议. ### 其他 - **`MessageChain.get` 现在返回可空的 `Message`**. 可迁移到 `MessageChain.getOrFail`. - 添加 `nextEvent`: 挂起当前协程, 直到监听到事件 `[E]` 的广播, 返回这个事件实例. - 删除部分冗长的如 `nextMessageContainingOrNullAsync` 等函数. - 添加 `Message.content` 扩展属性作为 `Message.contentToString()` 的捷径 - 简化图片结构, 弃用 `OnlineFriendImage`, `OnlineGroupImage`, `OfflineGroupImage`, `OfflineFriendImage` 这四个类. - 修复关闭验证码窗口后阻塞协程的问题 (#296) - 删除全部 `0.x.x` 版本更新时做的兼容 - 删除全部 `@SinceMirai("0.x.0")` - 支持接收群语音消息 - 优化图片 ID 正则表达式 - 优化大量 KDoc - 优化上传图片和长消息时的日志内容 - 允许引用回复离线的消息源 (在 `MessageChain.quote` 时消息链中的 `MessageSource` 可以为 `OfflineMessageSource`) - 拆分 JCE 序列化到独立的库 (#300) - 在重连时增加计时 - 简化 `MemberPermission` 比较 - 在消息事件中使用强引用 (#303) - 修复邀请机器人进群事件无法解析的问题 (#301) # Version 0.x 开发版本. 频繁更新, 不保证高稳定性 ## `0.40.0` 2020/4/29 在 `1.0.0` 正式版发布时, 所有为旧版本做的兼容都将删除, 因此请尽快迁移. - `Message` 不再继承 `CharSequence` (兼容到 `1.0.0`) - 废弃 `XmlMessage` 和 `JsonMessage`. 需使用 `ServiceMessage` 并手动指定 `serviceId` - 修复登录时概率失败的问题 - 提高事件处理稳定性 - Java 事件默认 `LOCKED`, 而不是 `CONCURRENT` - 弃用 `PlainText.stringValue`, 以 `PlainText.content` 替代 - 将 `VipFace` 作为 `PlainText` 发送, 而不是抛出异常 - 修复 `BufferedImage.toExternalImage` 降低图片质量的问题 ## `0.39.5` 2020/4/28 - 优化登录初始化, 提高稳定性 (#282) - 支持 VIP 表情的解析: `VipFace` (不支持发送) - 支持更多的戳一戳消息 (`PokeMessage`) 类型 - 修复 Android 平台的正则语法错误问题 - 修复 `BotInvitedJoinRequestEvent.ignore` - 提升 `LockFreeLinkedList` 遍历性能, 即 `ContactList` 遍历性能 - 将 `LockFreeLinkedList` 标注 `@MiraiInternalAPI` 并计划于 1.0.0 修改为 `internal` ## `0.39.4` 2020/4/27 - 支持匿名消息解析 (#277) - 修复部分情况下撤回失败的问题 - 修复部分情况下解析群名片错误的问题 - 修复解析匿名群成员错误的问题 - 修复 `LoginSolver` `Swing` 选择问题 - 添加 `NoStandardInputForCaptchaException`, 在无可用标准输入时中断登录 ## `0.39.3` 2020/4/25 - 添加 `Message.isContentEmpty()` 和 `Message.isContentNotEmpty()` - 在发送消息前检查是否为空 (#268) - 修复重复收到一些事件的问题 (#259) - 支持所有图片的下载链接获取 (#250) - 修复部分情况下验证码窗口无法显示的问题 (#270) - 构造 `ForwardMessage` 时不允许 `ForwardMessage.nodeList` 为空. ## `0.39.2` 2020/4/24 - 完善 `Message` 相关的 KDoc - 在支持图像界面的环境下弹出验证码输入 (#257) - 修复无法通过 id 发送图片的问题 (#262) - 修复彩色群名解析不全的问题 (#263) ## `0.39.1` 2020/4/24 - 修复长消息发送失败的问题 (#256) - 撤销 `Bot.instances` 更改, 添加新的 `Bot.botInstances` 以兼容以前代码 - 修复密码错误时未停止重连的问题 - 修复 `ForwardMessage` 无法从 `firstOrNull` 获取的问题 ## `0.39.0` 2020/4/23 **二进制不兼容的修改:** `Bot.instances` 现在返回 `List`, 而不是 `List>` 由于他们在 JVM 签名相同, 无法做兼容. ### Contact 架构改变 原有 `Member` 继承 `QQ`, `QQ` 继承 `Contact` 架构改变. 新架构为: - 弃用 `QQ` 命名 (二进制兼容到 1.0.0) - 新增 `User` 继承 `Contact`, 作为 `Member` 和 `Friend` 的父类 - `Member` 继承 `User` - `Friend` 继承 `User` #### 迁移 由于 `Member` 不再是 `QQ` 子类, 而原本表示 '好友' 意义的 `QQ` 删除, 需要根据实际情况替换 `QQ` 的引用为 `Friend` 或 `Group` 因修改, 新增以下 API: - `fun Member.asFriend(): Friend`: 得到此成员作为好友的对象或抛出异常 - `fun Member.asFriendOrNull(): Friend`: 得到此成员作为好友的对象或返回 `null` - `inline val Member.isFriend: Boolean`: 判断此成员是否为好友 同时有以下修改: - `val User.nameCardOrNick`: 获取非空群名片 (如果是群员) 或昵称 - 弃用 `fun Member.isMuted()` 而改为属性 `val Member.isMuted` ### 图片 - 构造所有类型图片时只接受唯一一个参数 `imageId: String`. - 所有类型图片只能获取唯一一个属性 `imageId: String` (以前可以获取长宽等数据) - 提高发送图片的性能 - 优化 `BufferedImage.toExternalImage` 的性能 - 统一图片后缀: `{ ... }.mirai` ### 消息 - 新增合并转发及其 DSL - 新增 `OfflineMessageSource` 构造 - 新增 `MessageSource` 修改: `MessageSource.copyAmend(block)` - 修复 'sequence not yet available' 问题 (#) - 修复好友消息的消息源 id 错误的问题 (#247) - 如果群成员是好友, 则发送好友消息, 而不是临时会话消息. - 添加 `MessageSource.internalId` 以便将来使用 - 添加 `OnlineMessageSource.toOffline` - 添加 `ContactMessage.time` - 添加 `ContactMessage.senderName` #### `OfflineMessageSource` 构造 可使用 DSL 构造离线消息, 修改其发送人, 发送时间, 发送内容等. 这对于跨群转发等情况十分有用. [MessageSourceBuilder.kt: Line 90](mirai-core/src/commonMain/kotlin/net.mamoe.mirai/message/data/MessageSourceBuilder.kt#L90) DSL 总览: ``` val source: OfflineMessageSource = bot.buildMessageSource { bot sendTo target // 指定发送人和发送目标 metadata(source) // 从另一个消息源复制 id, internalId, time messages { // 指定消息内容 +"hi" } } ``` #### 合并转发及其 DSL 合并转发: [ForwardMessage](mirai-core/src/commonMain/kotlin/net.mamoe.mirai/message/data/ForwardMessage.kt#L80) DSL: [ForwardMessageBuilder](mirai-core/src/commonMain/kotlin/net.mamoe.mirai/message/data/ForwardMessage.kt#L315) DSL 总览: ```kotlin buildForwardMessage { 123456789 named "鸽子 A" says "咕" 100200300 named "鸽子 C" at 1582315452 says "咕咕咕" // at 设置时间 987654321 named "鸽子 B" says "咕" myFriend says "咕" bot says { // 构造消息链, 同 `buildMessageChain` +"发个图片试试" +Image("{90CCED1C-2D64-313B-5D66-46625CAB31D7}.jpg") } } ``` 不支持解析别人的转发. ### 其他 - 支持 bot 名片被其他人修改时的同步 - 修复登录时遇到服务器不可用时无法继续重连的问题 - 更名 `Identified` 到 `ContactOrBot`, 去掉其 '实验性' 注解 - `Bot.instances` 现在返回 `List`, 而不是 `List>` (二进制兼容) - 更名 `subscribingGet` 到 `syncFromEvent`, 并将其定义为稳定 API. - 更名 `subscribingGetAsync` 到 `asyncFromEvent`, 并将其定义为稳定 API. - 添加接受 `eventClass: KClass` 参数的事件监听 `subscribe` - 在 `MessageSubscribersBuilder` 添加 `sentBy(User)`, `sentFrom(Group)`, `atAll`, `at` DSL - 修复某些时候未处理 `BotOfflineEvent.Force` 的问题 ## `0.38.0` 2020/4/20 - 新增自定义消息 (实验性): `CustomMessage` - 新增 `MessageChain.contentEquals` - 新增 `Message.isPlain`, `Message.isNotPlain` - 新增 `MessageChain.allContent`, `MessageChain.noneContent` - 修复 `CombinedMessage.toString` 顺序错误, 添加缓存 - 新增 `BotConfiguration.inheritCoroutineContext` - 将 Java API `MessageChain.getOrNull` 更名为 `MessageChain.firstOrNull` - 将 Java API `MessageChain.get` 更名为 `MessageChain.first` - 将 Java API `MessageReceipt.recall(long)` 更名为 `MessageReceipt.recallIn(long)` 以与其他 API 保持一致 - 优化 `MessageChainBuilder` 构建逻辑 ## `0.37.5` 2020/4/20 - 上传长消息和图片时允许重试, 提高稳定性 - 优化无网络时的重连逻辑 - 在 `Message` 中添加 `equals` 和 `hashCode`, 将部分类型消息定义为 `data class` - `MessageSource.id` 现在返回非 0 序列号 - 实现已撤回判断, 同一个 `MessageSource` 只能撤回一次 ## `0.37.4` 2020/4/17 - 修复 #220: 无法正常解析邀请机器人进群的富文本消息 - 修复 #236: 删除无用的 getter 方法生成 - 修复上传长消息时报错错误的问题 ## `0.37.3` 2020/4/15 新增: - 在群名修改事件(`GroupNameChangeEvent`)中支持获取操作人 - 修复 #229, 引入 `ServiceMessage` 作为 `JsonMessage`, `XmlMessage` 的父类并处理所有类型富文本消息解析 - 将所有 `RichMessage` 标注 `MiraiExperimentalAPI` 以警告将来改动 问题修复: - 修复潜在的长消息上传失败问题 - 简化 `MessageSubscriberBuilder` DSL, 整理 `linear.kt`, `subscribers.kt` - 修复启动时概率解析失败 ConfigPushSvc.PushReq - 修复 #228: 登录时没有因 `LoginFailedException` 中断 - 重构登录重连控制, 确保单一进程 - 处理无网络连接问题, 在无网络时将不尝试登录而等待网络连接 - 修复 #227: Android 最新版无法编译 - 修复 #226: BotUnmuteEvent - 修复 #225: 重复接收到群消息撤回问题 - 修复 #220: 无法正常解析邀请机器人进群的富文本消息 - 修复 #217: 解析 OnlinePush confess 状态时没有覆盖全面 - 优化遇到未知消息时的日志 ## `0.37.2` 2020/4/13 - 修复 `OnlineMessageSource.Incoming.target` 类型错误 - 引入实验性 `Identified` 接口作为 `Contact` 和 `Bot` 的公共接口 - 加快图片 MD5 计算过程 - 加快图片上传过程 - 其他小优化 ## `0.37.1` 2020/4/12 **从 `0.37.1` 起 JVM 平台依赖无需带 "-jvm" 模块名** **即原 "mirai-core-jvm" 和 "mirai-core-qqandroid-jvm" 均需去掉 "-jvm", 变为 "mirai-core" 和 "mirai-core-qqandroid"** - 登录时尝试多个服务器, 随服务器需求切换服务器 (解决潜在的无法登录的问题) (#52) - 优化带有 `QuoteReply` 时的消息长度估算 - 添加 `MessageChainBuilder.build`, 效果同 `asMessageChain` - 在 `ContactMessage` 中添加 `At.isBot` - 在 `MessageSubscribersBuilder` 中添加 `String.invoke`, `atBot` DSL ## `0.37.0` 2020/4/11 - 支持主动退群: `Group.quit`, `BotLeaveEvent.Active` - 支持临时消息撤回 - 支持好友消息撤回 - 修复一个内存泄露问题 - 修复彩色群名片读取失败的问题 - 修复退群事件重复广播的问题 (#221) ## `0.36.1` 2020/4/10 - 修复 `botPermission` - 删除一些无用的调试输出 ## `0.36.0` 2020/4/10 - 支持临时会话: `TempMessage` (#16) - 支持群员主动加入事件 `MemberJoinEvent.Active` - 添加 `subscribeTempMessages` 等相关 DSL - 添加 `FriendAddEvent`, `FriendDeleteEvent` (#216) - 修复各种事件重复广播的问题 (#173, #212) - 修复 `OfflineMessageSource.id` - 修复 `Member.kick` - 修复彩色群名片读取, 支持群名片更改事件 (#210) - 增加超时 (#175) - 支持合并转发消息的解析, 修复部分情况下长消息解析失败的问题 - 修复新成员加入时没有添加进成员列表的问题 (#172) ## `0.35.0` 2020/4/8 - 新增处理加好友请求: `NewFriendRequestEvent` - 新增处理加群请求: `MemberJoinRequestEvent` - 现在 `MessageSource.originalMessage` 也可以获取到 `MessageSource` - 支持机器人加入了大量群时的群列表获取 - 优化 init 过程 - 添加更清晰的错误日志 - 修复撤回自己发送的消息时的权限判定 - 修复 `botAsMember.nameCard` 修改时需要管理员权限的问题 - 修复 `MessageSource.key` - 修复其他一些小问题 ## `0.34.0` 2020/4/6 - 修复长消息判定. - 为 `selectMessages`, `selectMessagesUnit` 添加可选筛选 context 的参数: `filterContext: Boolean` - 统一消息日志 - 加快重连速度 `Message` 改动 (二进制兼容): - 添加 `Message.contentToString` 以转换为最接近官方消息的字符串 - 添加 `ConstrainSingle` 的 `Message` 类型以保证一个消息链中只存在一个 `QuoteReply` 和一个 `MessageSource` - `CombinedMessage` 现在实现接口 `MessageChian` 并变为 `internal` 以降低复杂度 (使用 `MessageChain` 替换 `CombinedMessage` 的引用). - `Message.plus` 现在返回 `MessageChain` 而不是 `CombinedMessage` - 弃用 `NullMessageChain` (使用 `null` 替代) - `Message` 中 `eq`, `contains` 等函数移动至 `SingleMessage` 以避免歧义. - 更名 `MessageChain.any` 到 `MessageChain.anyInInstance` 以与标准库的 `Iterable.any` 区分 - 更名 `MessageChain.first` 到 `MessageChain.firstIsInstance` 以与标准库的 `Iterable.first` 区分 - 更名 `MessageChain.firstOrNull` 到 `MessageChain.firstIsInstanceOrNull` 以与标准库的 `Iterable.firstOrNull` 区分 ## `0.33.0` 2020/4/4 - 重构 [`MessageSource`](https://github.com/mamoe/mirai/blob/master/mirai-core/src/commonMain/kotlin/net.mamoe.mirai/message/data/MessageSource.kt), 支持直接获取相关对象, 支持所有类型的引用. - 简化引用回复, 现在只需要 `source.quote()` 即可创建引用 (而不需要 `sender` 参数) - 现在可通过 `QuoteReply.source` 获取源消息, 且可以撤回该消息或再次引用. - 支持闪照: 可通过 `Image.flash()` 将普通图片转为闪照. - 支持 `Bot.nick` (#93) - 修复消息长度判断 (#195) (实验性) - 修复 Android 目标上 `SystemDeviceInfo.imei` 可能会抛出 NPE 的问题 - 修复 `GroupNameChangeEvent` 重复广播的问题 - 修复 `ContactMessage.nextMessageContaining` - 修复 `selectMessage` 时无法正常完结, 和 timeout 没有被取消的问题 - 修复 #133, #197, #187, #180, #77, #192 ## `0.32.0` 2020/4/2 - 使用 Kotlin 1.3.71, 兼容原使用 Kotlin 1.4-M1 编译的代码. - 优化 `BotConfiguration`, 去掉 DSL 操作, 使用 `fileBasedDeviceInfo(filename)` 等函数替代. (兼容原操作方式, 计划于 `0.34.0` 删除) - 调整长消息判定权重, 具体为: Chinese char=4, English char=1, Quote=700, Image=800, 其他消息类型转换为字符串后判断长度. - 添加 `ContactMessage` 以替代 `MessagePacket<*, *>` 的情况 - 添加 `MessageTooLargeException` - 使用 `Bot.id` 替代 `Bot.uin` - 在 `Dispatchers.IO` 协程调度器中执行 Java API 创建的事件处理. - 修复 Java API `Member.kick` 参数 `message` 没有正常传递的问题 - 将部分意外定义为 public 的 API 改为 internal. - 将部分 internal API 从 `mirai-core` 移至 `mirai-core-qqandroid` ## `0.31.4` 2020/3/31 - 修复 At 在手机上显示错误的问题 ## `0.31.3` 2020/3/31 - 修复 #178 ## `0.31.2` 2020/3/30 - 修复长文本长度检测, 提高判断性能 - 修复特殊的好友图片 ID 无法构造为消息 - 新增 `AtAll.display` - 所有消息元素统一 `toString`: `[mirai:image:ID]`, `[mirai:face:ID]`, `[mirai:at:TARGET]`, `[mirai:poke:TYPE,ID]`, `[mirai:quote:ID]` 等 (仍为实验性) ## `0.31.1` 2020/3/29 - 修复重复解析禁言事件的问题 (#83) ## `0.31.0` 2020/3/29 - 支持长消息发送, 单条消息最多含 4500 字符和 50 张图片 - 支持戳一戳消息: `PokeMessage` - 修复 重复收到好友消息 (#129), 私聊图片出错 (#165) - 为 `MessageChain.toString` 增加缓存 (非原子), 以提升长消息处理的性能 - 发消息失败时将抛出带提示的异常 - 添加 `MessageSource` 将被重写的警告 ## `0.30.1` 2020/3/26 - 修复一些事件解析失败的问题 ## `0.30.0` 2020/3/24 此版本为二进制不兼容更新, 全部使用者都需要重新编译. 源码兼容的改变: - 删除全部 `@Depreacted` 兼容 - 删除全部多余的 `@JvmName` 以兼容将来的改变 (新 MPP 模块等级制架构) - 调整部分函数的 JVM 可见性 - 内联部分 `MessageChain` 工具函数 - **更新到 Kotlin 1.4-M1** ([如何更新到 Kotlin 1.4-M1](https://gist.github.com/Him188/9f395d058b89226d412a200bdd0595be)) 源码不兼容的改变: - 群设置由 `Group` 移动到独立的 `GroupSettings` - 调整 API 可见性: 将除 `BotFactory` 外 `mirai-core-qqandroid` 中全部 API 改为 `internal` 消息部分: - `SingleMessage` 实现接口 `CharSequence` 和 `Comparable` - 为 `FriendImage`, `GroupImage`, `OnlineImage`, `OfflineImage` 增加 `companion object Key` - 调整 `RichMessage`, 将所有子类聚合到一个文件 - 移动 `XmlMessageHelper` 为 `RichMessage.Compation` - 命名调整: `buildXMLMessage` 改为 `buildXmlMessage` - 修复 `CombinedMessage` 中错误的 `left` 和 `element` 事件部分: - 加强 `selectMessages`, 增加回复, 引用回复, 默认值, 超时支持: 原处理方式: ```kotlin val message = nextMessageOrNull(10.secondsToMillis) ?: kotlin.run { quoteReply("请在 10 秒内发送一张图片") return@case } val image = message.getOrNull(OnlineImage) ?: kotlin.run { reply(message.quote() + "请发送一张图片") return@case } reply(message.quote() + image.originUrl) ``` 使用 `selectMessages` DSL: ```kotlin selectMessagesUnit { has() quoteReply { message[OnlineImage].originUrl } timeout(10.secondsToMillis) quoteReply { "请在 10 秒内发送图片以获取链接" } defaultQuoteReply { "请发送一张图片" } } ``` ## `0.29.1` 2020/3/22 - 确保二进制兼容, #155 - 修复 Android 上 ECDH init 失败问题, #154 ## `0.29.0` 2020/3/22 - 引入新消息监听 DSL: `whileSelectMessages`, 简化连续监听过程 ```kotlin bot.subscribeMessages { "开启复读模式" `->` { reply("成功开启") whileSelectMessages { "stop" `->` { reply("已关闭复读") false // 停止循环 } default { reply(message) true // 继续循环 } } reply("复读模式结束") } } ``` - 引入新消息监听 DSL: `selectMessages`, 简化筛选监听过程 ```kotlin bot.subscribeMessages { "test" `->` { reply("choose option: 'hello', 'hi'") val value: String = selectMessages { "hello" `->` { "123" } "hi" `->` { "222" } default { "default value" } } reply(value) } } ``` - 监听消息的 DSL 新增 `infix fun String.->(block)` - 处理 `StatSvc.ReqMSFOffline` (#150) - `Contact.sendMessage` 现在接受 `Message` 参数, 而不是 `MessageChain` 以兼容 `CombinedMessage` - `Member.sendMessage` 现在返回 `MessageReceipt` 而不是 QQ 泛型 - 调整 JVM `MessageUtils` 中一些方法的可见性 (`@JvmSynthetic`) - 调整命名: `OfflineImage.queryOriginUrl` 改为 `OfflineImage.queryUrl` - 允许手动重新初始化 `Bot` (`BotNetworkHandler.init`), 确保重初始化资源释放 ## `0.28.0` 2020/3/19 - 修复 Jce 反序列化在部分情况下出错的问题, 修复 #145 - 新增群公告低级 API - 新增群活跃数据低级 API - 修复 #141, #143, #131 - 更多原生表情 (`Face`) ## `0.27.0` 2020/3/8 - 支持 `XML`, `Json`, `LightApp` 等 `RichMessage` ## `0.26.2` 2020/3/8 - 新增 `MessageChain.repeat` 与 `MessageChain.times` - JVM 平台下 `PlatformLogger` 可重定向输出 - 修复 `NullMessageChain.equals` 判断不正确的问题 - 新增 `PlainText.of` 以应对一些特殊情况 ## `0.26.1` 2020/3/8 - 重写 Jce 序列化, 提升反序列性能 - 更新 `Kotlin` 版本到 1.3.70 - 更新 `kotlinx.coroutines`, `atomicfu`, `kotlinx.coroutines` 依赖版本 ## `0.26.0` 2020/3/7 - 使用 `kotlinx.io` 而不是 `ktor.io` - 修复 #111, #108, #116, #112 ## `0.25.0` 2020/3/6 - 适配 8.2.7 版本（2020 年 3 月）协议 - 全面的 `Image` 类型: Online/Offline Image, Friend/Group Image - 修复查询图片链接时好友图片链接错误的问题 - 修复 bugs: #105, #106, #107 ## `0.24.1` 2020/3/3 - 修复 `Member` 的委托 `QQ` 弱引用被释放的问题 - 用 `Bot.friends` 替代 `Bot.qqs` - 用 `Bot.containsFriend`, `Bot.containsGroup` 替代 `Bot.contains` - 新增 `BotFactory.Bot(String, ByteArray)` 用 md5 密码登录 - 为 `BotFactory` 等类型的一些扩展指定 `JvmName` - 移动 `Bot.QQ` 到低级 API ## `0.24.0` 2020/3/1 - Java 完全友好: Java 使用者可以同 Kotlin 方式直接阻塞式或异步（Future）调用 API - 新增 `MessageSource.originalMessage: MessageChain` 以获取源消息内容 - 群消息的撤回现在已稳定 (`Bot.recall`) - 现在可以引用回复机器人自己发送的消息: `MessageReceipt.quoteReply` - 新增 `MessageRecallEvent` - 整理 `MessageChain` 的构造, 优化性能 - 整理所有网络层代码, 弃用 `kotlinx.io` 而使用 `io.ktor.utils.io` - 其他杂项优化 ## `0.23.0` 2020/2/28 - 修复上传图片 - 一些问题修复 - 大量杂项优化 - `MessageReceipt.source` 现在为 public. 可获取源消息 id - 修复上传好友图片失败的问题 - 上传群图片现在分包缓存, 优化性能 ## `0.22.0` 2020/2/24 - 重构 `MessageChain`, 引入 `CombinedMessage`. (兼容大部分原 API) - 新增 `MessageChainBuilder`, `buildMessageChain` - `ExternalImage` 现在接收多种输入参数 - 修复访问好友消息回执 `.sequenceId` 时抛出异常的问题 ## `0.21.0` 2020/2/23 - 支持好友消息的引用回复 - 更加结构化的 `QuoteReply` 架构, 支持引用任意群/好友消息回复给任意群/好友. ## `0.20.0` 2020/2/23 - 支持图片下载: `image.channel(): ByteReadChannel`, `image.url()` - 添加 `LockFreeLinkedList.iterator` - 添加 `LockFreeLinkedList.forEachNode` - 并行处理事件监听 - 添加 `nextMessageContaining` 和相关可空版本 - '撤回' 从 `Contact` 移动到 `Bot` - 删除 `MessageSource.sourceMessage` - 让 MessageSource 拥有唯一的 long 类型 id, 删除原 `uid` 和 `sequence` 结构. - 修复 `Message.eq` 歧义 ## `0.19.1` 2020/2/21 - 支持机器人撤回群消息 (含自己发送的消息): `Group.recall`, `MessageReceipt.recall` - 支持一定时间后自动撤回: `Group.recallIn`, `MessageReceipt.recallIn` - `sendMessage` 返回 `MessageReceipt` 以实现撤回功能 - 添加 `MessageChain.addOrRemove` - 添加 `ContactList.firstOrNull`, `ContactList.first` - 新的异步事件监听方式: `subscribingGetAsync` 启动一个协程并从一个事件从获取返回值到 `Deferred`. - 新的线性事件监听方式: `subscribingGet` 挂起当前协程并从一个事件从获取返回值. ##### 新的线性消息连续处理: `nextMessage` 挂起当前协程并等待下一条消息: 使用该示例, 发送两条消息, 一条为 "禁言", 另一条包含一个 At ```kotlin case("禁言") { val value: At = nextMessage { message.any(At) }[At] value.member().mute(10) } ``` 示例 2: ```kotlin case("复读下一条") { reply(nextMessage().message) } ``` - 修复一些情况下 `At` 无法发送的问题 - 统一 ImageId: 群消息收到的 ImageId 均为 `{xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx}.jpg` 形式（固定长度 37） - 支持成员主动离开事件的解析 (#51) ## `0.18.0` 2020/2/20 - 添加 `MessageSource.time` - 添加事件监听时额外的 `coroutineContext` - 为一些带有 `operator` 的事件添加 `.isByBot` 的属性扩展 - 优化事件广播逻辑, 修复可能无法触发监听的问题 - 为所有 `Contact` 添加 `toString()` (#80) - 支持成员禁言状态和时间查询 `Member.muteTimeRemaining` - 修复 `At` 的 `display` (#73), 同时修复 `QuoteReply` 无法显示问题 (#54). - 广播 `BotReloginEvent` (#78) - 支持机器人自身禁言时间的更新和查询 (#82) ## `0.17.0` 2020/2/20 - 支持原生表情 `Face` - 修正 `groupCardOrNick` 为 `nameCardOrNick` - 增加 `MessageChain.foreachContent(lambda)` 和 `Message.hasContent(): Boolean` - 提高重连速度 - 修复重连后某些情况不会心跳 - 修复收包时可能产生异常 ## `0.16.0` 2020/2/19 - 添加 `Bot.subscribe` 等筛选 Bot 实例的监听方法 - 其他一些小问题修复 - 优化重连处理逻辑 - 确保好友消息和历史事件在初始化结束前同步完成 - 同步好友消息记录时不广播 ## `0.15.5` 2020/2/19 - 为 `MiraiLogger` 添加 common property `val isEnabled: Boolean` - 修复 #62: 掉线重连后无 heartbeat - 修复 #65: `Bot` close 后仍会重连 - 修复 #70: ECDH is not available on Android platform - 从服务器收到的事件将会额外使用 `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 - 尝试修复 `atomicfu` 编译错误的问题 - 查询群信息失败后重试 ## `0.15.1` 2020/2/15 - 统一异常处理: 所有群成员相关操作无权限时均抛出异常而不返回 `false`. - 初始化未完成时缓存接收的所有事件包 (#46) - 解析群踢人事件时忽略找不到的群成员 - 登录完成后广播事件 `BotOnlineEvent` ## `0.15.0` 2020/2/14 - 新增事件: `BotReloginEvent` 和 `BotOfflineEvent.Dropped` - `AtAll` 现在实现 `Message.Key` - 新增 `BotConfiguration` DSL, 支持自动将设备信息存储在文件系统等 - 新增 `MessageSource.quote(Member)` - 更好的网络层连接逻辑 - 密码错误后不再重试登录 - 掉线后尝试快速重连, 失败则普通重连 (#47) - 有原因的登录失败时将抛出特定异常: `LoginFailedException` - 默认心跳时间调整为 60s - 解决一些验证码无法识别的问题 - 忽略一些不需要处理的事件(机器人主动操作触发的事件) ## `0.14.0` 2020/2/13 - **支持 at 全体成员: `AtAll`** - **支持 `AtAll` 的发送和解析** - **修复某些情况下禁言处理异常** 小优化: - 在 `GroupMessage` 添加 `quoteReply(Message)`, 可快速引用消息并回复 - 为 `CoroutineScope.subscribeMessages` 添加返回值. 返回 lambda 的返回值 - 在验证码无法处理时记录更多信息 - 优化 `At` 的空格处理 (自动为 `At` 之后的消息添加空格) - 删除 `BotConfiguration` 中一些过时的设置 ## `0.13.0` 2020/2/12 - 修改 BotFactory, 添加 `context` 参数. - currentTimeMillis 减少不必要对象创建 - 优化无锁链表性能 (大幅提升 `addAll` 性能) -qqanroid 安卓协议发布, 基于最新 QQ, 版本 `8.2.0` 支持的功能: - 登录: 密码登录. 设备锁支持, 不安全状态支持, 图片验证码支持, 滑动验证码支持. - 消息: 文字消息, 图片消息(含表情消息), 群员 At, 引用回复. - 列表: 群列表, 群员列表, 好友列表均已稳定. - 群操作: 查看和修改群名, 查看和修改群属性(含全体禁言, 坦白说, 自动批准加入, 匿名聊天, 允许成员拉人), 设置和解除成员禁言, 查看和修改成员名片, 踢出成员. - 消息事件: 接受群消息和好友消息并解析 - 群事件: 群员加入, 群员离开, 禁言和解除禁言, 群属性(含全体禁言, 坦白说, 匿名聊天, 允许成员拉人)改动. ### mirai-api-http HTTP API 已完成, by [@ryoii](https://github.com/ryoii). 详见 [README](https://github.com/mamoe/mirai/tree/master/mirai-api-http) Mirai 仍处于快速迭代状态. 将来仍可能会有 API 改动. ## `0.12.0` *2020/1/19* 1. 监听消息时允许使用条件式的表达式, 如: ```kotlin (contains("1") and has()){ reply("Your message has a string '1' and an image contained") } (contains("1") or endsWith("2")){ } ``` 原有单一条件语法不变: ```kotlin contains("1"){ } "Hello" reply "World" ``` 2. Message: 修复 `eq` 无法正确判断的问题; 性能优化. 3. 简化 logger 结构(API 不变). 4. 事件 `cancelled` 属性修改为 `val` (以前是 `var` with `private set`) ## `0.11.0` *2020/1/12* - 弃用 `BotAccount.id`. 将来它可能会被改名成为邮箱等账号. QQ 号码需通过 `bot.uin` 获取. - `Gender` 由 `inline class` 改为 enum - `String.chain()` 改为 `String.toChain()` - `List.chain()` 改为 `List.toChain()` -timpc - 修复在有入群验证时无法解析群资料的问题 (#30) ## `0.10.6` *2020/1/8* TIMPC - Fix #27, 群成员找不到的问题 - 一些小优化 ## `0.10.5` *2020/1/3* - 修复有时表情消息无法解析的问题 - 为心跳增加重试, 降低掉线概率 - 消息中的换行输出为 \n - 其他一些小问题修复 ## `0.10.4` *2020/1/1* - 事件处理抛出异常时不停止监听 - 添加 `Bot(qq, password, config=Default)` - 一些性能优化 ## `0.10.3` *2020/1/1* - 修复一个由 atomicfu 的 bug 导致的 VerifyError - 添加 `ExternalImageAndroid` - 事件处理抛出异常时正确地停止监听 ## `0.10.1` *2019/12/30* **Bot 构造** `Bot` 构造时修改 `BotConfiguration` 而不是登录时. 移除 `CoroutineScope.Bot` 移除 `suspend Bot(...)` 添加 `Bot(..., BotConfiguration.() -> Unit)` 添加 `Bot(..., BotConfiguration = BotConfiguration.Default)` **其他** 全面的在线状态 (`OnlineStatus`) 移动部分文件, 模块化 ## `0.10.0` *2019/12/23* **事件优化** 更快的监听过程 现在监听不再是 `suspend`, 而必须显式指定 `CoroutineScope`. 详见 `Subscribers.kt` 删除原本的 bot.subscribe 等监听模式. **其他** `Contact` 现在实现接口 `CoroutineScope` ## `0.9.0` *2019/12/20* **协议模块独立** 现在 `mirai-core` 只提供基础的抽象类. 具体的各协议实现为 `mirai-core-PROTOCOL`. 这些模块都继承自 `mirai-core`. 现在, 要使用 mirai, 必须依赖于特定的协议模块, 如 `mirai-core-timpc`. 查阅 API 时请查看 `mirai-core`. 每个模块只提供少量的额外方法. 我们会给出详细列表. 在目前的开发中您无需考虑多协议兼容. **Bot 构造** 协议抽象后构造 Bot 需指定协议的 `BotFactory`. 在 JVM 平台, Mirai 通过 classname 自动加载协议模块的 `BotFactory`, 因此若您只使用一套协议, 则无需修改现行源码 **事件** 大部分事件包名修改. **UInt -> Long** 修改全部 QQ ID, Group ID 的类型由 UInt 为 Long. **此为 API 不兼容更新**, 请将所有无符号标志 `u` 删除即可. 如 `123456u` 改为 `123456` 另还有其他 API 的包名或签名修改. 请使用 IDE 自动修补 import 即可. ## `0.8.2` *2019/12/15* - 修复 GroupId.toGroupInternalId 错误 - 修复解析群消息时小概率出现的一个错误 ## `0.8.1` *2019/12/15* - 修复有时群资料无法获取的情况 - 现在 `At.qq`, `Long.qq` 等函数不再是 `suspend` ## `0.8.0` *2019/12/14* 协议 - 现在查询群资料时可处理群号无效的情况 - 现在能正常分辨禁言事件包 功能 - 增加无锁链表: LockFreeLinkedList, 并将 ContactList 的实现改为该无锁链表 - **ContactSystem.getQQ 不再是 `suspend`** - ContactSystem.getGroup 仍是 `suspend`, 原因为需要查询群资料. 在群 ID 无效时抛出 `GroupNotFoundException` 优化 - 日志中, 发送给服务器的包将会被以名字记录, 而不是 id ## `0.7.5` *2019/12/09* - 修复验证码包发出后无回复 (错误的验证码包) ## `0.7.4` *2019/12/08* - 修复 bug - 优化 JVM 平台上需要验证码时的提示 ## `0.7.3` *2019/12/07* - 删除 klock 依赖, 添加 Time.kt. 待将来 kotlin Duration 稳定后替换为 Duration ## `0.7.2` *2019/12/07* - 使所有协议相关类 `internal` - 去掉一些 `close` 的不应该有的 `suspend` - `QQ`, `Member`, `Group` 现在继承接口 `CoroutineScope` - 将 `LoginResult` 由 `inline class` 修改为 `enum class` - 添加和修改了 `BotAccount` 和 `Bot` 的构造器 ## `0.7.1` *2019/12/05* - 修复禁言时间范围错误的问题 - 禁言的扩展函数现在会传递实际函数的返回值 ## `0.7.0` *2019/12/04* 协议 - 重新分析验证码包, 解决一些无法解析的情况. (这可能会产生新的问题, 遇到后请提交 issue) - 重新分析提交密码包 - *提交验证码仍可能出现问题 (已在 `0.7.5` 修复)* 功能 - XML 消息 DSL 构造支持 (实验性) (暂不支持发送) - 群成员列表现在包含群主 (原本就应该包含) - 在消息事件处理中添加获取 `.qq()` 和 `.group()` 的扩展函数. - 现在处理群消息时 sender 为 Member (以前为 QQ) - 修改 `Message.concat` 为 `Message.followedBy` - 修改成员权限 `OPERATOR` 为 `ADMINISTRATOR` - **bot.subscribeAll<>() 等函数的 handler lambda 的 receiver 由 Bot 改变为 BotSession**; 此变动不会造成现有代码的修改, 但并不兼容旧版本编译的代码 性能优化 - 内联 ContactList - 2 个 Contact.sendMessage 重载改为内联扩展函数 **(需要添加 import)** - 其他小优化 ## `0.6.1` *2019/12/03* - 新增: 无法解析密码包/验证码包时的调试输出. 以兼容更多的设备情况 - 新增: `MessagePacket` 下 `At.qq()` 捷径获取 QQ ## `0.6.0` *2019/12/02* - 新增: 禁言群成员 (`Member.mute(TimeSpan|Duration|MonthsSpan|Int|UInt)`) - 新增: 解禁群成员 (`Member.unmute()`) - 修复: ContactList key 无法匹配 (Kotlin 内联类型泛型投影错误)