更新日志

2026-10-23 1.5.0

• 新增后置事件体系：NotifyEvent 基类 + 28 个类型化后置事件，与发送事件一一配对（命名规则：前置事件名 + Notify）
• 后置事件在写操作 HTTP 成功后触发，不可取消，携带 getOriginal()（前置事件）与 getResponse()（响应 DTO）
• 新增 HeartbeatEvent，WebSocket 收发心跳包时触发
• 新增插件生命周期事件 PluginEnableEvent / PluginDisableEvent
• 新增素材管理 API：图片预上传后以 qqbot-media:// 链接在 Markdown 中反复引用（prepare / PUT 直传 / complete / 列表 / 删除 / uploadMediaImage 组合方法）
• 新增 dto/message/media 包（MediaImageFormat 枚举 + 3 个响应类 + MediaImage），3 对素材相关事件
• BotHttp 新增 putBinary()，用于向预签名 URL 直传二进制并取回 ETag
• Bngeuit 新增 atEveryone()，生成 <qqbot-at-everyone /> 标签（仅群聊）
• JAR manifest 写入 Implementation-Version，运行时可读框架版本
• 消息事件的 author / mentions 统一为 User，attachments 统一为 MessageAttachment；事件类内嵌的 Author / C2CAuthor / Attachment / C2CAttachment 删除
• MessageMarkdown 移除模板字段（templateId / customTemplateId），只保留 content 与 forceVerifyImageResource
• dto/message 按业务域分包（keyboard / stream / interaction / group / upload / friend），import 路径变更
• BotUser 按官方响应体补齐 6 字段（新增 bot / unionOpenid / unionUserAccount）
• InteractionEvent 等事件内嵌的枚举与数据类迁出到 dto/message/interaction 等包

提示

本次存在 import 路径与事件字段类型的破坏性变更，升级插件时需同步修改。

2026-10-14 1.4.0

• 新增群成员管理 API（内邀接口）：成员列表、成员详情、批量移除、黑名单查询与操作
• 新增 dto/message/member 包（Member / BlacklistUser / 各响应类 / BlacklistOp 枚举）
• 新增发送事件 GroupMemberBatchRemoveEvent / GroupMemberBlacklistEvent，均可取消
• 门面新增便捷方法：getGroupMembers / getGroupMember / batchRemoveGroupMembers / getGroupMemberBlacklist / addMemberToBlacklist / removeMemberFromBlacklist

提示

群成员相关接口需向平台申请内邀白名单，未开通时报错码 11253。

2026-10-05 1.3.1

• ARKData 的 arkType 封装成枚举类（并同步官方 20260916 变更）
• config.yml 新增几个线程池大小的配置和 webhook 的 backlog 的配置

提示

官方 20260903 变更 新增的成员管理相关接口 已在 1.4.0 中以内邀接口形式加入 Bngeuit

2026-08-30 1.3.0

• 命令系统新增 Tab 补全功能和对应 API
• 内置命令新增 /group /c2c 命令，命令参数支持 ()xxx 格式读取 config.yml 配置
• 优化日志系统，现在不在区分框架和插件 Logger，调整 /log 命令
• 流式消息新增快捷构建器 StreamAction
• API优化：sendXxxx 去除无用的 msgSeq 参数
• BotApiImpl 新增大量便捷方法
• 所有（尤其是事件类）timestamp 字段、参数统一为新增的 Timestamp 类
• 删除不再使用的 EventUtil 类
• InteractionResponseCode 从 BotApi 中独立到 dto.message 包内
• 新增输入状态 InputState 枚举，用于 StreamMessageRequest
• 新增 CommandUtil 工具类，可用于处理群聊、单聊指令
• 改进控制台交互体验

提示

本次 API 改动可能导致你的插件无法继续使用。

2026-08-21 1.2.1

• CommandHelper#printHelp 输出 @CommandBody 注册的命令帮助时顺序改为按方法声明顺序（原按 name 字母排序）

2026-08-20 1.2.0

• 新增群禁言管理功能（API、DTO、发送事件），支持单人/批量/定时/周期/全员禁言，时间戳与 RFC3339 双参数
• 新增入群申请与自动审批功能（API、DTO、接收/发送事件）
• 新增 C2C 自定义菜单功能（API、DTO、发送事件）
• 新增指令面板功能（API、DTO、发送事件），支持 C2C/群聊两种场景
• Bngeuit 新增 atUser() / cmdInput() Markdown 辅助方法
• Bngeuit 新增 RFC3339 与时间戳互转工具方法
• 接口域名从 bots.qq.com 调整为 api.bot.qq.com（官方 20260810 变更）
• 群消息 / C2C 消息请求新增 force_verify_image_resource 参数
• FriendAddEvent / FriendDelEvent 的 union_openid 封装为 FriendAuthor，新增 shortCode

2026-08-18 1.1.0

• 新增脚本插件，支持用 JavaScript 编写插件并热加载
• 新增 Webhook 模式，作为 WebSocket 之外的另一种接入方式
• 新增 C2CCommandSender，支持私聊场景的命令处理
• 新增 onActive 生命周期，机器人上线时统一触发
• 优化 YAML 相关配置类，提升加载解析稳定性

2026-08-07 1.0.0

• 发布