水缸机器人

Appearance

更新日志 ​

2026-11-04 1.6.2 ​

  • 移除GraalJS 脚本插件系统：删除 ScriptPlugin / ScriptBridge 与 js-language / truffle-runtime 依赖，插件体系只剩 JAR 与 nc 两种形态；
  • 新增nc 脚本插件（自研 nacre 语言）：plugins/*.nc 文件视为插件，加载时内存编译为 JVM 字节码直接执行（性能接近 Java 插件）
  • 移除图片素材（v2/media-images）：素材图片上传生命周期事件；新增 ApiLimits 本地参数校验（字符显示宽度、文件大小、键盘行列等平台限制，发包前拦截为可读异常）

2026-11-04 1.6.1 ​

  • 内部版本

2026-11-04 1.6.0 ​

  • 内部版本

2026-10-30 1.5.3 ​

  • 新增图文卡片支持单聊（msg_type=8）：此前 msg_type=8 仅群聊可用，现群聊与单聊均支持
  • 新增 Bngeuit.sendC2CCard(openid, title, description, picUrl, jumpUrl)（BotApi 同步新增）
  • 新增 C2CMessageRequest 新增 card 字段与 Builder.card()，本地校验放行 msg_type=8

2026-10-30 1.5.2 ​

  • 插件卸载清理不再被 onDisable 异常中断；enable 失败自动回滚；重名插件拒绝加载 —— 消除「已从列表移除却仍收事件、ClassLoader 不释放、无法二次卸载」的僵尸插件
  • PluginDisableEvent 改为禁用动作之前触发，监听者可访问插件全部资源做善后
  • 插件卸载时先等待在途事件回调结束（≤10s）再关闭 ClassLoader，消除「回调正在执行、插件已被禁用」的竞态
  • 脚本插件新增 bngeuit.run* / cancelTask 调度封装（自动以脚本插件为 owner，卸载时任务随之取消）
  • 调整调度器 6 个插件方法 owner 必填（传 null 抛 IllegalArgumentException），框架系统任务拆分 runSystem* 系列；新增插件受管执行器 JavaPlugin.getExecutor()（卸载自动关闭）；自建线程卸载时兜底中断
  • 优化半开连接检测：连续 2 个心跳间隔未收到 ACK 主动断连重连 —— 此前要等 TCP 超时，可能长时间「假在线」丢事件
  • 优化重连调度：正常掉线零延迟重连（RESUME 补推，不丢消息）；仅连接建立失败时按 5s~60s 指数退避
  • 优化HTTP 429 自动重试：按 Retry-After 等待重试（最多 2 次），消息洪峰时限流不再成片抛给插件
  • 优化 EventBus 分发改「事件类 → 处理器」索引缓存（每条消息 O(1) 命中，替代全量扫描）；周期调度任务捕获 Throwable，不再因 Error 静默终止

2026-10-23 1.5.1 ​

  • 新增 ApiLimits 接口限制常量化：素材图片 10 MB / 100 张；富媒体硬限 200 MB（图片 20 MB / 视频 30 MB / 语音 20 MB 软限）；菜单、面板、键盘、禁言、分享链接等官方限制集中管理，超限统一抛 IllegalArgumentException
  • 本地参数校验（发包前拦截，避免服务端错误码）：消息发送（msg_type 与内容字段对应、content/markdown 互斥、msg_seq 非负等）、富媒体上传（大小 / MD5 / SHA1 / 分片）、素材图片、内嵌键盘、菜单 / 面板 / 分享链接、群管理全链路本地校验
  • 插件生态：新增 AiChat AI 聊天插件；CraneAssistant 推送信息服务独立（PushService / PushConfig）；WebUI 新增监控页

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 ​

  • 发布