Skip to content

Latest commit

 

History

History
410 lines (241 loc) · 13 KB

CHANGELOG.md

File metadata and controls

410 lines (241 loc) · 13 KB

更新日志

[2.10.0] - 2023-11-27

修复

  • debug 模式下将输出全局异常日志
  • 修复文件上传文档错误 #537

新增

变更

  • 升级 mirai core 版本, 支持 2.16.0
  • 移除 GroupEntranceAnnouncementChangeEvent 入群通知变更事件类型
  • ForwardMessagedisplay 字段可选 @ProgramRipper

[2.9.1] - 2023-3-2

修复

  • websocket 异常断开时连接无法释放
  • ForwardMessage 的 display 字段中属性可空 @ProgramRipper

新增

  • 新增 webhook 下的 timeout 设置

变更

  • 升级 mirai core 版本, 支持 2.14.0

  • [2.8.0] - 2023-2-10

修复

  • webhook 失效

新增

  • 支持获取最新群成员列表数据 #666
  • 支持修改转发消息的显示内容 #680
  • 支持移除群员时,禁止该成员申请入群 #679
  • 群设置获取的新增中新增是否开启全员禁言 #628

[2.7.1] - 2022-12-20

修复

  • 修复依赖错误导致无法启动

[2.7.0] - 2022-12-17

修复

  • 修复无法从其他插件中加载消息持久化 SPI 的问题 (#639)
  • 修复开启 single mode 并 关闭 verify 时, 无法使用 http 接口 (#658). (不建议这样使用)
  • 修复 webhook 在 bot 下线后无法发送 bot 离线事件 (#641)
  • 修复上传群文件后没有发送群消息提醒 (#637)

新增

  • 支持反向 websocket 重连, 详情见 反向 ws 配置文件 (#621)
  • 支持反向 websocket 未认证时执行 about, botList 指令 (#610)
  • 转发消息支持从其他群、好友对话的缓存中获取消息来进行转发消息的构建,新增 messageRef 字段,详情见文档 (#623)
  • 用户申请入群事件 MemberJoinRequestEvent 新增可空字段 invitorId, 表示可能存在的邀请人

变更

  • 升级 kotlin, ktor 版本
  • 升级 mirai core 版本, 支持 2.13.2

[2.6.2] - 2022-8-31

修复

  • 修复 webhook 不执行命令时控制台报错
  • 修复 ImageFlashImage 无法区分 @BlueGlassBlock

[2.6.1] - 2022-8-10

修复

  • 修复 webhook 在新版本 mirai-console 中失效
  • 更正错误文档

[2.6.0] - 2022-8-8

修复

  • 修复 webhook 可能发起 HTTP/2 请求,导致目标服务器不支持
  • 修复 http 下未读消息队列未消费出现内存泄露,现默认最大容量 100

新增

  • 新增 群解散 bot 退出群聊 事件 BotLeaveEventDisband @RF-Tar-Railt
  • 新增 Image, FlashImage 消息类型 width, heignt 等新字段 (#598)
  • 新增获取已登录的可用 bot 列表接口 接口详情 (#580)
  • 新增 获取漫游消息 的支持
  • 新增配置 http 轮询模式下未读队列的大小限制
  • 可用 websocket 申请的 session 直接发起 http 接口的请求。 (操作未读队列的接口除外)
  • 可通过 SPI 载入第三方 session 持久化机制 (当前可引用 mah 做编译时依赖,后续会抽离 SPI 相关接口到额外依赖)

变更

  • 为支持 session 持久化,且解决多个群聊中消息 id 的重复问题。此版本起,传入 messageId 引用消息的接口均可能需要传入上下文(好友id、群id)

[2.5.2] - 2022-5-15

修复

  • 修复获取群文件下载信息失败
  • 修复通过文件id获取文件信息时失败
  • 修复上传群文件失败 #553

变更

  • 原文件下载信息直接在文件信息中返回(除下载地址),下载信息在原字段中同时保留

[2.5.1] - 2022-5-15

修复

  • 修复获取文件接口没有返回目录的信息 (#571)

变更

  • 各种原因,2.5.1, 包括 2.5.0 仅支持 core 2.11

[2.5.0] - 2022-2-17

修复

  • 配置文件中 adapter 声明顺序导致请求头中 sessionKey 丢失

新增

变更

  • 更新 core 到版本 2.10.0

[2.4.0] - 2021-12-06

修复

  • 修复插件重启后可能出现的内存泄漏(虽然一般没人只重启插件)
  • 修复 session 关闭时未能正确关闭所有资源
  • 修复 session 复用出现的事件重复问题,session 引入计数引用优化复用问题
    1. http 环境下需要手动释放
    2. websocket 环境下链接断开自动释放
    3. session 释放时引用计数递减,直到引用为 0 完全释放
  • 修复上传文件无法正常返回 #507
  • 修复撤回时消息时间戳的错误 #490

变更

  • 更新 core 依赖版本到 2.8.0

已知问题

  • core 更新了文件操作的API,且遗漏了通过 id 获取文件夹的API。因此没有完全适配新API,后续 core 更新废除旧API时,可能出现不兼容
  • 群公告接口尚不可用
  • 开发者设备内存只有8G,导致更新缓慢

[2.3.3] - 2021-10-28

修复

  • ws, reverse ws, web hook 下未知事件报错

[2.3.2] - 2021-10-19

修复

  • 解决 cache 由于并发问题引起的内存泄漏

已知问题

  • websocket 未释放 session, 大量重启 SDK 创建 session 时建议同时重启 mah. 内存占用最大的 cache 可在 session 间复用,该问题影响较小

  • websocket 重用 session 时会多次触发事件,建议多个 socket 使用不同 session 建立连接

  • [2.3.1] - 2021-09-12

修复

  • 修复文件上传后没有发布消息提示, #468
  • 减少上传资源时出现内存泄露的可能

[2.3.0] - 2021-09-09

修复

  • 修复上报时提示的资源泄漏
  • 修复群文件上传报错
  • 修复消息撤回事件中时间的错误, #442
  • 修复 ws 创建连接时, 认证失败的返回数据格式不正确, #446

变更

  • 更新 core 依赖版本到 2.7.0
  • groupConfig 移除群通知参数, 无法获取也无法发布, 下个版本会专门开放群通知接口
  • 语音上报的返回结果不再携带 url 参数, 语音消息不受影响
  • 明确群文件上传 path 参数意义为父级目录, 上传后的文件名取自 multipart 参数中的文件名

优化

新增

  • 新增修改群员管理员权限接口 接口定义
  • 支持好友语音
  • 语音追加 length 返回语音时间长度, 单位为秒
  • BotJoinGroupEvent, MemberJoinEvent 两个入群时间追加邀请人 invitor 参数
  • BotLeaveEvent Bot 离群事件, 在 Bot 被踢出时可通过 operator 获取执行操作的管理员信息
  • 群文件相关接口全增加 path 参数用于模糊定位(群文件相同目录可重名), 优先级高于 id, 精准定位请使用 id
  • 丰富群文件信息的 downloadInfo 参数的内容,包括修改时间、上传时间、上传者、下载次数

[2.2.0] - 2021-08-09

修复

  • 部分接口中的大小写匹配
  • 状态码序列化异常
  • 语音失真
  • 文件上传时可能出现的内存泄漏

优化

  • peekMessage 接口拼写错误, 原 peakMessage 接口保留一段时间兼容
  • 提升 webhook 的一点点性能
  • 补充文档, 戳一戳事件、明确环境中 path 参数的含义

新增

  • MiraiCode 消息类型支持,可将 MiraiCode 作为一种消息类型 消息格式 MiraiCode的使用
  • Webhook Adapter 对请求头 qq, bot 追加可反代的 X-header 格式
  • 配置文件中智能的 host 解析, 默认解析到 http:// scheme
  • 群文件请求 /file/list, /file/info 可携带 withDownloadInfo 返回额外的下载信息 查看文件列表
  • 群文件请求 /file/list 追加分页参数, offset, size

[2.1.0] - 2021-07-19

修复

  • 群文件相关接口字段错误 isDictionary -> idDirectory, isDictionary 保留一段时间兼容性, 涉及接口
  • http 文件上传 /file/upload 返回值(已兼容)
  • 创建群文件夹 /file/mkdir 请求参数(不兼容)
  • 查看群文件列表 /file/list 返回值(已兼容)
  • 获取文件信息 /file/info 返回值(已兼容)
  • websocket 部分异常没有返回正确的格式 #383
  • websocket 无法进行引用回复 #401
  • 若干文档说明,更正 反向ws adapter 的使用文档

新增

  • 获取 session 信息 #386 [GET] /sessionInfo, websocket 命令字 sessionInfo

[2.0.2] - 2021-06-14

修复

  • 管理员处理入群请求时,拒绝消息丢失
  • 可能存在着的未读消息序列化错误

[2.0.1] - 2021-06-12

修复

  • 修复 http adapter 对于 [GET] 请求参数序列化错误

变更

  • 由于 http adapter[GET] 请求无法针对文件 id根目录传递空字符串, 将为该 id 值提供默认值参数, 默认值为空字符串, 即默认操作根目录

[2.0.0] - 2021-06-12

修复

  • 修复 session 释放接口错误
  • 修复 websocketsession 相互干扰
  • 修复请求参数序列化内部异常
  • 修复多 adaptor 协作时 session 类型不匹配

[2.0-RC2] - 2021-05-26

变更

  • Mirai core 版本更新到 2.6.4
  • ForwardMessage 字段修改为与 1.x 相同:
    • 类型type: Forward -> ForwardMessage
    • 节点: nodes -> nodeList
    • 发送人: sender -> senderId, name -> senderName

修复

  • about 接口修复, #351
  • session 生成异常, #345
  • websocket adapter 异常导致断连
  • 配置序列化导致 webhook 等初始化异常

新增

  • 追加 debug 模式开启 debug 信息
  • 群文件支持
  • 其他客户端消息(OtherClientMessage)接收支持, #331 (受 core 限制, 暂不支持发送)
  • mirai console 命令 API

该版本为预览版本, 功能未经过充分测试, 提前发布以适应接口变更 请酌情使用

[2.0-RC1] - 2021-05-10

新增

  • 支持新消息类型: MusicShare, Dice, ForwardMessage, ``
  • 支持新消息事件: 好友输入状态改变, 好友昵称改变, 群荣誉改变(龙王)
  • 支持新操作: 设置精华, 删除好友, 查询资料片戳一戳
  • 群成员返回 最后发言事件, 入群时间 等字段
  • 多媒体上传支持 base64 格式
  • 支持反向 websocket, 上报支持回调

变更

  • 群名片变更, 群头衔变更, 群权限变更, 群匿名开启变更 等事件 new 字段正式废除
  • 认证流程变更, 且支持从请求头认证
  • http 部分接口返回格式变更
  • 多媒体上传不再进行缓存

详见迁移文档

优化

  • adapter 拆分
  • 解决已发现的内存泄漏

正式发布前待解决

  • 恢复 console 命令相关接口
  • 恢复群文件相关接口
  • 恢复 API TESTER 工具

版本依赖

  • mirai core: 2.6.2

该版本为预览版本, 功能未经过充分测试, 提前发布以适应接口变更 请酌情使用