Mirai Versions Save

感谢大家四年以来对 mirai 的支持。阳光穿过秋天的枫叶，留下一张张独特的风景，如此灿烂，如此艳丽。

mirai-core

优化和修复

• 修复登录收到结果 180 时会无限重连的问题
• 修复 ShortVideo 文档
• 优化 ShortVideo 的内部日志

mirai-console

优化和修复

• 修复 JVM 插件 JAR 中使用 plugin.yml 加载时无法加载的问题 (#2791 by @cssxsh)

mirai-core

新特性

• 短视频消息 ShortVideo 支持 (#867, #1664, #2011, #2621, #2739)

可通过 Contact.uploadShortVideo 为好友和群上传视频消息，更多信息请查看此方法的 KDoc

• 超级表情 SuperFace 支持 (#2621, #2722 by @cssxsh)

超级表情是类似 菜汪 和 流泪 之类的有高级动画显示的表情，可以通过对应普通表情 Face.toSuperFace 转换

• 为 ANDROID_PAD 协议启用戳一戳支持 (#2771)
• 添加 val MiraiProtocol.isNudgeSupported: Boolean 用于判断当前协议是否支持戳一戳 (#2771)

优化和修复

• 修复获取 QIMEI 请求的载荷参数错误 (#2749 by @zhaodice)
• 修复 Base64 工具在 Android 平台的行为与 JVM 平台不一致的问题 (#2753 by @zhaodice)
• 在升级旧版本的设备信息文件之前检查文件写权限
• 修复从可确定图片类型的 Mirai Code 构造的图片 时 type 为 UNKNOW 或与期望类型不一致 (#2760, #2761 @Hamusuta0320)
• 修复在某些情况下无法收到好友消息撤回事件 (#2784)
• 优化 NormalMember.specialTitle 文档 (#2777 by @MrY-Cat)
• 移除 Kotlin Native 相关的注解
• (internal) 弃用 mirai-core-api 的 jvmBase 模块，与 common 模块合并 (#2772)

mirai-console

不兼容变更

• 弃用 PermitteeId.hasChild，改为 PermitteeId.isChildOf (#2762 by @cssxsh)

新特性

• 添加强制性最终用户使用须知，将在 console 首次启动和须知内容变动时显示 (#2738)
• 现在插件可通过内置配置文件资源加载插件依赖 (#1985, #2189, #2735)
• 现在插件可依赖指定版本 console 来限制 conosle 的版本 (#1895, #2703 by @cssxsh)

优化和修复

• 优化 AutoLogin 配置文件部分注释 (#2742 by @ParaN3xus)
• 修复在控制台中当上次输入请求被取消导致输入队列阻塞的问题
• 修复 Bot 登录失败后关闭 Bot 时 console 异常退出的问题 (#2740)
• 将 console backend 的 org.slf4j.spi.SLF4JServiceProvider 移动至 console frontend base (#2443 by @cssxsh)
• 在插件加载前排除 ID 相同的插件 (#2136, #2703 by @cssxsh)
• 优化 AutoLoginEvent 显示 (#2750 by @cssxsh)

CI

• 在 CI 构建时上传 Maven 本地仓库作为构建产物 (#2725 by @cssxsh)

IDEA

• 支持 IDEA 2023.2 (#2769, #2775 by @Samarium150)

2.15.0 是 2.15 的稳定版本，此更新记录仅包含 2.15.0-RC 至 2.15.0 的更新。完整更新记录请查看前几个预览版本

mirai-core

不兼容变更

• (Internal) EncryptService 注册方式改为 Factory (fa389f40)

新特性

• 添加 val MiraiProtocol.isQRLoginSupported: Boolean （#2726， #2642）

优化和修复

• 二维码登录相关修复 （#2708 by @cssxsh）
• (Internal) 当 EncryptService 可用时提示服务来源警告
• (Internal) EncryptService update
• 默认关闭登录验证时的内部日志
• 修复禁言匿名成员 (#2711 by @cssxsh, #2626, #2370)

---

关于包数据加密 / 签名 （Internal）(#2716)

mirai 不会内置任何第三方 签名/加密 服务，而是提供 SPI 让用户自行实现。 mirai 已经提供了外部 EncryptService SPI 供用户对接。如果您没有能力自行对接，您可以考虑到论坛寻找社区对接。

在使用社区服务前，您需要了解并理解以下内容

1. 保证可信来源！ 当，且仅当， 服务来源可信时，使用此服务。mirai 传递给服务的内容包括但不限于：
   • 所有的 Bot 登录请求（包含 Bot 的所有敏感信息（如密码，登录凭证等））
   • Bot 发出去的全部消息内容
2. 保护好你的网络！ 据最近观察，部分相关的服务实现并没有对消息进行加密，如果您所访问的服务位于公开网络，您的数据有被窃取的风险。
3. 保护好你的日志！ 据最近观察，部分相关服务使用 HTTP GET 请求传递数据体，当远程服务出错时，服务对接可能会直接将此次请求的连接直接输出到日志中，此日志可能包含了此次尝试 签名/加密 的内容，而此内容可能包含关键信息。 当您需要上传日志时，请记得移除相关的请求日志。 如果您无法分辨哪些请求需要被抹除时，您可以参考以下规则：
   • 请求连接包含大量 Hex 文本，抹除 （Hex: 由 0-9 和 ABCDEF 组成的序列 ）
   • 请求包含大量 Base64 文本，抹除 （如您不知道什么是 Base64 文本，您可以简单当做是超长的英文与符号组合）
   • 请求连接过长，抹除（如连接日志换行了三次都还没有显示完全）

mirai-core

不兼容变更

• 删除 native 编译目标 (#2698)
• 弃用 DeviceInfo 构造器及 serializer, 以 DeviceInfoBuilder 和 DeviceInfo.serializeToString 替代 (#2674)
• MessageSyncEvent 的 MessageSource 的 targetId 由机器人 ID 变为实际的消息发送对象 (#2122, #2513)

新特性

• 更新登录协议 (#2613, #2592)

• 现在可以在 BotAuthorization.authorize 时通过 BotAuthInfo 获取导致重新登录的原因 (#2664)

• 优化插件 classpath 策略 (#2666)

  文档

  • 添加选项以允许插件不搜索其他插件的 classpath
  • 添加选项以允许插件阻止其他未依赖此插件的插件进行引用

• AudioToSilkService 现在稳定 (#2658)

• 支持使用 JSON 保存与读取 PluginData 与 PluginConfig (#2498 by @NoMathExpectation)

• 支持获取和管理群精华消息 (Group.essences) (#837, #2293, #2314 by @cssxsh)

• 以 Android Library 形式发布 Android 编译目标 (#2635, #2699 by @MrXiaoM)

优化和修复

• 修复扫码登录的已知问题 (无法进入登录验证等) (#2623, #2645, #2633 with @cssxsh)

• 修复刷新令牌后令牌不保存的问题 (#2590, #2584)

  这是一个很长时间的错误, 应该只在完全重启 mirai 或更新 bot 后才会影响

• 修复 java.lang.IllegalStateException: wLoginSigInfoField is not yet initialized (#1603, #2449, #2450 by @sandtechnology)

• 修复获取群活跃数据失败的问题 (#2609, #2610 by @cssxsh)

• 修复部分合并转发消息仅被作为APP消息接收的问题 (#2618, #2675)

• 修复 MessageSource 定位相关逻辑: (#2510, #2513)

  • 发送消息时实际发送的消息会忽略通过 MessagePreSendEvent 所进行的修改 (#2525)
  • 安卓客户端发送的 Quote 中 message source id 有误 (#2495)
  • OnlineMessageSourceFromGroupImpl 的 fromId 有误 (#2277)

• 修复获取群精华消息报错 (#2668, #2672 by @cssxsh)

• 修复群公告协议 (#2619 by @cssxsh)

• 修复 OnlineAnnouncement.members 只能获取 50 个人的问题 (#2531, #2530 by @cssxsh)

• 修复发送消息时实际发送的消息会忽略通过 MessagePreSendEvent 所进行的修改的问题 (#2525 by @NoMathExpectation)

• 优化文档 (#2639 by @cssxsh)

• 完善了用户文档部分的内容 (#2541 by @MikkoAyaka)

• 在文档注释手表协议不支持戳一戳事件 (#2572 by @7aGiven)

• 在消息日志中去除特殊控制符

• 添加 QRCodeLoginListener.onCompleted() 用于资源释放

mirai-core-mock

• 实现 Image.isUploaded (#2582 by @Nambers)
• 修复 mockHonorMember (#2473 by @Nambers)

mirai-console

优化和修复

• 修复事件文档中 AutoLoginEvent 与 StartupEvent 的描述 (#2692 by @BakaFT)

IDEA

新特性

• 新增一个勾选框，为用户提供是否使用阿里云镜像仓库的选项 (#2636 by @Samarium150)
• 添加 Gradle 插件的阿里云镜像仓库 (#1778, #2636 by @Samarium150)
• 支持设置 jvmTarget (#2387, #2631 by @Samarium150)
• 使插件在新建项目时创建 gradle-wrapper.properties 文件和 src/test 文件夹 (#2617, #2622 by @Samarium150)

mirai-core

不兼容变更

• 删除了旧版的为兼容 Java 生成的阻塞式方法桥

  这只会导致依赖 mirai 2.1.0 (发布于 2 年前) 编译的 Java 代码现在无法使用 mirai 2.15.0-M1 及以上版本运行. 将它们使用 2.15.0-M1 及以上重新编译即可运行.

  这是因为 KJBB 以前有 bug, 会生成返回值为 Unit 的方法桥. mirai 为了兼容, 一直让 KJBB 既生成返回 Unit 的, 也生成返回 void 的. 但自 Kotiln 编译器 1.8.0 起, 其 IR lowering 会把 companion object 中的静态函数 @JvmStatic 的返回值由 Unit 变更为 void, 导致编译器插件 KJBB 不再能做兼容.

新特性

• 支持扫码登录 (#2502 with @StageGuard, #1281)

新的登录方法通过 BotAuthorization & BotFactory.newBot(id: Long, authorization: BotAuthorization) 登录

关于详细的使用方法请参考 BotAuthorization 的注释

扫码登录的实现不一定稳定 (因为涉及修改了大量内部登录和维护在线逻辑), 文档也还在正在准备中.
在 2.15.0-RC 可能会修改扫码登录的 API.

mirai-console 尚未支持在命令中指定扫码登录, 但是提供了 MiraiConsole.addBot(id: Long, authorization: BotAuthorization) 用于扫码登录

优化和修复

• 更新 Kotlin 到 1.8.10, kotlinx-serialization 到 1.5.0 (#2578)
• 修复特殊情况可能无法加载 services 的问题 (#2268, #2511 by @Nambers, #2428 by @cssxsh)

  例如在 Minecraft 插件中

• 增加 TxCaptchaHelper 可用性无法保证的警告 (#2564 by @MrXiaoM)
• 修正消息多态序列化, 输出的 JSON 不再包含多余的 "type" 字段 (#2414)
• 修正群公告发送失败报错 no login (#2069, #2512 by @cssxsh)
• 修正使用 Announcements.get(fid) 出现 kotlinx.serialization.MissingFieldException: Field 'msg' (#2509, #2512 by @cssxsh)
• 修正短暂断网时不能成功重连 (#2488, #2504, #2505 by @sandtechnology)
• 修复 OfflineMessageSource 回复时, 引用回复的 At 变空白的问题 (#2501)
• 在无法连接服务器时在报错信息中携带尝试连接的服务器 (#2576 by @cssxsh)
• 修正 dumpTlvMap 返回值不正确的问题 (内部) (#2557 by @MrXiaoM)
• 修正文档细节 (#2547 by @7aGiven)

mirai-core-mock

• 在 upload 后的 MockImage 中提供 size 属性 (#2515)

mirai-console

新特性

• JvmPlugin 以 getResource 方法获取全局资源文件 (#2536 by @ArgonarioD)
• 添加新事件 StartupEvent, AutoLoginEvent (#2446 by @cssxsh)

  分别在 Console 启动完成后, 和自动登录后触发

优化和修复

• 文档修正(#2503 by @7aGiven, #2506 by @7aGiven, #2457 by @char-46, #2577 by @cssxsh, #2491 by @EnchStudio)
• 修复在Android系统运行时，被杀后台时抛出的 InterruptedException 导致崩溃 (#2474 by @zhaodice)
• 修复使用 Console 扩展时，对于扩展的函数返回非 null 值报错的情况 (#2528 by @NoMathExpectation)

2.14.0 的稳定版本，相比 2.14.0-RC 没有更新。

mirai-core

优化和修复

• 修复无法登录的问题 (#2433 by @sandtechnology)

此修复也在 2.14.0-RC 包含

mirai-core

不兼容变更

• 删除 SwingLoginSolver (#2410)

它以前是设计给解决图形验证码, 而现在基本不会遇到图形验证码了。现在将默认使用命令行版本 LoginSolver。 以前使用 "-Dno-desktop" 可以禁用 SwingLoginSolver，现在这个选项将没有效果，不会报错。

• 现在使用 RemoteFile 将会得到编译错误

RemoteFile 早在 2.8 就弃用了, 使用时会得到警告. 现在起使用将会得到编译错误.

新特性

• 群聊获取历史消息 (Group 实现 RoamingSupported) (#1866, #2332 by @StageGuard )

可使用 group.roamingMessages / group.getRoamingMessages()

• 商城表情: 石头剪刀布 (#2220 by @cssxsh )

类型名称为 RockPaperScissors

• 群打卡事件支持 (#1663, #2217 by @cssxsh )

类型名称为 SignEvent

• Announcement 现在可以获取 已确认/未确认 的群成员 (#2255 by @cssxsh )

优化和修复

• 修复无法登录的问题 (#2433 by @sandtechnology )

此修复也会在 2.13.4 包含

• 修复群员列表缓存文件不完整时会导致 bot init 失败的错误 (#2399)
• 当设备信息等变更的时候清除缓存 (#2346, #2388)

不清除会导致登录失败等问题

• 修复 iOS 无法查看私聊转发消息的问题 (#1575)
• 修复转发消息存在特殊字符时无法加载的问题 (#2241)
• 修正 contentToString() 注释不严谨处 (#2373, #2374 by @MrXiaoM )
• 修正 PokeMessage.id (#2170)
• 修复 QuoteReply 无法引用 bot 发出的 ForwardMessage (#2342)
• 修改日志等级的颜色 (#2336)

  现在 WARN 是金黄色，而不是红色

mirai-core-mock

优化和修复

• 避免 MockAbsoluteFile.md5/sha1 可能为空 (#2436 by @Nambers )
• 修复部分信息撤回逻辑不正确的错误 (#2421 by @Nambers )
• 修复 MockNormalMember.modiyAdmin() 逻辑错误 (#2420 by @Nambers )
• 修复 uploadMockImage 上传相同文件时触发 java.nio.file.FileAlreadyExistsException (#2401)
• 引入 AvatarGenerator
• 修复联系人头像等信息更新同步的问题

mirai-console

新特性

• JvmPlugin 中现在可以调用 mirai console 所使用的针对 Kotlin object 优化后的 SPI Service Loader (#2247 by @cssxsh)

优化和修复

• 修复 JvmPlugin.onDisable 被多次执行的错误 (#2015, #2397)
• 修复低版本 Android 系统报错 java.lang.NoSuchMethodError: No virtual method getDeclaredAnnotation(Ljava/lang/Class;)L (#2354 by @zhaodice)
• 在命令的报错中去除不必要的 InvocationTargetException 包装 (#2258 by @cssxsh )
• 优化 MiraiLogger (在 mirai-console) 性能 (#2341)
• SLF4J 支持 (#2341)

IDEA

• 支持 2022.3 (#2372)

  • 新插件版本号为 223-2.14.0-172-1
  • 新版本只支持 2022.3 + Kotlin 1.7.20 (因为 2022.3 捆绑 1.7.20)

---

关于 mirai-console SLF4J 支持 (#2341)

配置文件修改

修改均为默认配置, 先前已经生成的配置不会进行修改

Logger.yml

 # 默认日志输出等级
 # 可选值: ALL, VERBOSE, DEBUG, INFO, WARNING, ERROR, NONE
 defaultPriority: INFO
 # 特定日志记录器输出等级
 loggers: 
   example.logger: NONE
   console.debug: NONE
   Bot: ALL
+  org.eclipse.aether.internal: INFO
+  org.apache.http.wire: INFO

+# 是否启动外部日志框架桥接
+binding: 
+  slf4j: true

ABI 变更

注: 实际上 console 没有直接的 ABI 变更

依赖更新: org.slf4j:slf4j-api:1.7.32 -> 2.0.3

此依赖的更新只会影响 slf4j-api 的对接, 并不会影响 slf4j-api 的单纯使用

即不会对插件有任何影响, 只会对部分对 console 进行高度自定义的会有少许影响

其他 API 变更

• mirai-logging-log4j2 现在使用 org.apache.logging.log4j:log4j-slf4j2-impl
• mirai-logging-slf4j-logback 现在使用 1.3.4
• mirai-core-all 现在携带的是 slf4j 2.0.x

---

新年快乐! 🎆🎉

mirai-core

优化和修复

• 修复登录时出现 DecryptionFailedException 的问题 (#2167, #2419 by @sandtechnology)
• 修复使用 ANDROID_PHONE 或 ANDROID_PAD 登录时出现错误 "版本过低" 的问题 (#2405, #2423 by @sandtechnology)
• 为 friendGroupId 增加默认值 0, 以兼容旧缓存 (#2403 by @cssxsh)

mirai-core

优化和修复

• 修复发送图片时发生 java.lang.NoSuchMethodError 的问题 (#2381)

  自 2.13.0