2.7.0

[Him188]

mirai-core

2.7.0 相较于 2.7-RC 的变更以斜体表示, 其他为基于 2.6.8 的变更.

不兼容变更

• 弃用 GroupSettings.entranceAnnouncement, 以 2.7-M2 加入的 Announcements 代替 (group.setting.entranceAnnouncement 取不到群公告 #1398, 弃用 GroupSettings.entranceAnnouncement #1399)
• 弃用语音 Voice, 以新增的 Audio 代替. 完全保留兼容性.
• 现在移除群成员 (NormalMember.kick) 时默认不将目标群员加入黑名单 (支持在踢出群成员时选择是否拉黑 #1457)
• MessageSubscribersBuilder 的 startsWith 和 endsWith 现在不再 trim 参数. (fix: do trimming properly in startsWith & endsWith, #1282 #1314)
  • 修复无法处理带首尾空格的消息的问题. ([DSL]startsWith不按预期工作 #1282)

  即如果参数有空格, 以前的代码会过滤空格, 但现在不会.

新特性

消息

• 新语音 API Audio (Introduce Audio for new API, revert changes on Voice in 2.7-M2 #1452)
  • 支持好友语音, 提供类似于发送图片的多种发送语音的 API (支持私聊语音 #931, Private voice support #1310)
  • 新增公共接口 VoiceSupported 接口, 由 Group 与 Friend 实现
  • 尽可能支持语音的转发, 直接转发协议数据结构
  • 支持语音的序列化 (Voice serialization #1368)
• 支持最新的原生表情 (Face) (Update system face #1260)
• 新增 Kotlin DSL subscribeUserMessages 监听 UserMessage
• 为 Image 实现 hashCode 与 equals, 仅判断 Image.imageId (为 Image 添加 equals 和 hashCode #1302)
• MusicShare 支持酷狗音乐和酷我音乐 (feat: support kugou,kuwo music share #1228)
• 支持嵌套的合并转发并支持序列化 (支持嵌套的合并转发 #1183, 无法序列化嵌套的合并转发: Class 'ForwardMessageInternal' is not registered for polymorphic serialization in the scope of 'SingleMessage'. #1267, Add RefineContext for refining #1195, Support receive nested ForwardMessages #1196)

群操作

• 新增群公告 API Group.announcements (群公告的lowLevelApi #138, 添加群公告 API #140, GroupAnnoucement #1141, Redesign Announcement API #1389)
• 支持在移除群成员 (NormalMember.kick) 时选择是否加入黑名单 (支持在踢出群成员时选择是否拉黑 #1457)
• 支持群主设置或取消群员的管理员权限 (官方群管理员功能 #547, 添加管理员修改功能 #1178)

其他

• 重构网络层 (重构网络层 #1226, Network rewrite #1191)
• 重新设计默认的登录解决器, 默认启用滑动验证码支持, 内嵌使用手机帮助解决滑块验证码的支持 (优化 SwingSolver UI #1283, Redesign LoginSolver #1285)
• 允许使用第三方日志库如 SLF4J, Log4J 接管 mirai 日志系统 (关于Bot的Logger的一些改进建议 #1426, Improve logging: use Log4j internally and support markers #1464)
• 在 mirai-core 所有模块的 JAR META-INF/MANIFEST.MF 里存储版本信息 (在发布的 jar 中附带版本信息 #1351, Add version info in META-INF/MANIFEST.MF #1355)
• 在 GC 时释放泄露的资源 (ExternalResourceLeakObserver #1383)
• 添加内联的 BotFactory.newBot (BotFactory.newBot 无法调用 BotConfiguration.inheritCoroutineContext #1233, Add inline BotFactory.newBot for Kotlin DSL. fix #1233 #1234)

优化和修复

• 更新到 Kotlin 1.5, 更新相关依赖 (快上 Kotlin 1.5 #1245, Kotlin 1.5 and dependencies updates #1246, Kotlin 1.5 and dependencies updates mirai-console#346)

  • 使 MessageChain 变为 sealed interface
  • 使 MessageEvent 变为 sealed interface

    依赖模块	原版本号	新版本号
    kotlin-compiler	1.4.30	1.5.10
    kotlin-stdlib	1.4.30	1.5.10
    kotlinx-coroutines-core	1.4.2	1.5.0
    atomicfu	0.15.1	0.16.1
    ktor	1.5.1	1.5.4
    kotlinx-serialization-core	1.1.0	1.2.1

• 增加 @NotStableForInheritance 标注不应该被继承的接口 (Add @NotStableForInheritance and apply it to suitable classes #1385)

• 删除意外添加的 kotlinx.serialization 编译器依赖 (fix: serialization plugin should not be put into runtime classpath #1197)

• 文档更新 (Review docs and improve readability #1291, Clearify docs for ExternalResource and RemoteFile #1248, ...)

网络层

• 修复在接收到 ReqMSFOffline 时没有重连的问题
• 修复某些情况下重连时遇到解析数据包错误的问题 (ExceptionInPacketCodecException) (ExceptionInPacketCodecException(cause=java.lang.IllegalArgumentException: data must len % 8 == 0 && len >= 16 but given -1) #1405, Fix #1405, before it is a compiler undefined behavior #1408)
• 修复被挤下线后反复重连失败的问题 (Force离线事件后反复重试登录失败 #1203)
• 修复某些情况下无法识别群管理员权限的问题 (获取不到特定年代之前加群成员的PERMISSION #1192)
• 修复开启联系人缓存后无法接收好友消息的问题 (使用enableContactCache() 后无法接收好友消息 #1208)
• 在同步好友消息记录 (序号) 失败时也继续登录 (mirai-core 2.6.2版本登陆时timeout syncing friend message history #1222, syncMessageSvc 不应阻止初始化 #1253)
• 修复 Bot 被挤下线后必须删除 account.secrets 才能登录的问题 (同一个QQ,本地和服务器来回切换,提示下线通知,必须删除cache文件夹和device.json文件才行 #1205)
• 处理状态心跳的返回值, 解决可能的无法接收消息问题 (StatSvc.SimpleGet: Decode the resp #1241)
• 使用新版本登录加密算法 (ECDH: Replacing old curve, thanks to MiraiGo #1237)
• 绕过在 Android P 之后的版本无法使用 EC 的限制 (Bypass BC deprecation check on Android #1481)
• 修复其他客户端消息同步事件的日志 (MessageSyncEvent 日志内容错误 #1380)
• 优化在遇到设备锁验证时的提示消息
• 优化重连时的日志, 每种异常只打印一次
• 解决潜在的内存泄露问题
• 提升重连稳定性
• 更好地支持单线程调度下的网络任务

Contact

• 修复无法检测部分群的群管理员的问题 (获取不到特定年代之前加群成员的PERMISSION #1192, Fix #1192, request admin when loading groups #1257)
• 修复无法获取群公告的问题 (IMirai.getRawGroupAnnouncements) (Mirai.getRawGroupAnnouncements 取不到群公告 #1322, Fix #1322, remove redundant cookie #1372)
• 修正发送消息因 Bot 被禁言而失败时抛出的异常
• 减少因群 uin 和 code 转换错误导致的问题 (groupUin和groupCode互转函数的问题 #1479, fc8fd70)

Message

• 去除合并转发消息卡片的多余的空格 (Remove redundant spaces in rendering ForwardMessage #1275)
• 提升 MessageChain.get, MessageChain.contains 的性能
• 修复协议内部消息类型被暴露给 MessageReceipt.source.originalMessage 的问题 (协议内部消息类型被暴露给 MessageReceipt.source.originalMessage #1371)
• Face.toString() 现在返回类似 [可怜], 而不是 [mirai:face:123] (Face.toString: use contentToString() for better readability #1382)
• 修复转发消息 At 昵称错误的问题 (转发消息@信息错误 #1137)

Event

• 修复 EventChannel.filter Java 版在执行阻塞调用时会阻塞协程调度的问题
• 确保 BotOnlineEvent, BotOfflineEvent 以及 BotReloginEvent 广播的时机及顺序
• 修复 EventChannelKotlinExtensions 的引用歧义
• 修复 BotOnlineEvent 有可能在登录成功后好一会才会推送的问题 (BotOnlineEvent 事件在程序运行后好一会才会推送 #1051)
• 修复群员首次在群内发言时会触发 MemberCardChangeEvent 的问题 (没有群名片的群员在说话时会触发MemberCardChangeEvent #1151, Introduce MemberNick class and correct nameCard decoding, Fix #1151 #1231)
• 修复 MessageSubscribersBuilder.has 报错 ClassCastException 的问题 (Subscriber DSL 的 has<*> 不能正常捕获消息 #1223)

mirai-console

优化和修复

• 在加载插件时打印其版本号 (加载插件的时候顺便打印插件版本号 mirai-console#369)
• 在阻塞环境中执行非 suspend 的指令方法 (v2.6.2 JSimpleCommand/JCompositeCommand 在windows和linux平台运行行为不一致 mirai-console#341)
• Console 内置配置使用只读的 ReadOnlyPluginConfig (Fix: builtins config use ReadOnlyPluginConfig mirai-console#375)
• 更新依赖

  依赖模块	原版本号	新版本号
  yamlkt	0.9.0	0.10.0

mirai-console-gradle

新特性

• 简化 JSimpleCommand 的构造器 (Add @JvmOverloads for JSimpleCommand constructor and add default … mirai-console#349)

• 允许用户覆盖 Kotlin 版本号 (而非与 mirai-console 编译时的版本号相同) (使用 mirai-console Gradle 插件后无法指定 Kotlin 版本 mirai-console#367)

  因此可以使用较旧的版本, 但若使用更新版本可能会导致不兼容.

• 在生成插件项目时:

  • 添加 test/kotlin/RunTerminal.kt 以帮助测试 (在生成项目时写出 RunTerminal mirai-console#362, 建议完善Mirai插件自动生成的.gitignore文件 mirai-console#366)
  • 添加 .gitignore

不兼容变更

• 删除默认添加的 mavenCentral 仓库 (判断群 580202355 的群员 3104026189 的权限失败: 0x00000001(1). #389)

  使用者可能需要额外添加如下内容:

  dependencies {
    mavenCentral()
  }

优化和修复

• 在 LoginCommand 登录完成后将结果同时发送给指令执行人和控制台 (LoginCommand: Send login results also to ConsoleCommandSender mirai-console#348)
• 支持 Gradle 7.0 (mirai-console-gradle 适配gradle7 mirai-console#368)
• 删除对 Bintray JCenter 的引用 (同时上传大量群图片时报错 #387)

---

感谢外部贡献者:

• @sandtechnology
• @HoshinoTented
• @AdoptOSS
• @wdvxdr1123
• @493505110
• @cssxsh

---

This discussion was created from the release 2.7.0.

[Alceatraz]

Action是不是跑崩了，打了个红叉。MavenRepository中搜不到2.7.0😂

[Him188]

central 同步比较慢, 一般要个大半天