Repository navigation
HuHoBot-Penguin_Spigot v1.15.1
HuHoBot-Penguin_Spigot v1.15.1
修复版本:QQ 指令面板同步 30019「面板版本冲突」。直接替换 plugins/ 下的主插件 jar 重启即可。
下载
| 文件 | 用途 | 大小 |
|---|---|---|
HuHoBot-Penguin_Spigot-1.15.1.jar |
主插件,必需。放在 plugins/ |
22.6 MB |
HuHoBot-Engine-GraalJs-1.15.1.jar |
可选。仅当你要写 .js 脚本时需要,放进 plugins/HuHoBotPenguin/engines/ |
34.1 MB |
HuHoBot-Engine-GraalPy-1.15.1.jar |
可选。仅当你要写 .py 脚本时需要,放进 plugins/HuHoBotPenguin/engines/ |
124.6 MB |
只想用现成附属插件的话,只下载主插件即可,两个引擎包不必装。
.lua 脚本不需要任何引擎——LuaJ 已经打进主 jar,不放引擎包插件照常启动,只是对应语言的脚本加载失败,其它语言不受影响。
引擎包需与主插件同一次构建产出(文件名版本号要一致,对不上时启动会给出告警)。
修复内容
- fix: QQ 指令面板同步报 30019「面板版本冲突」 —— 原位更新按官方文档补传
panel.version(详情接口顶层与panel内两个位置都读取);冲突时重读一次版本再重试一次 - fix: 面板同步并发自撞与撞限频(40030009「面板操作进行中」) —— 同步入口串行化,同一时刻只跑一次,期间的请求收敛为一次补跑;两次同步最小间隔 6 秒,对应官方写接口 10 QPM 限频
- improve: 面板同步错误提示区分 30013 / 30019 / 40030009 并给出排查建议
原因说明
PUT /v2/panels/{panel_id} 属于乐观并发接口:请求体的 panel.version 必须等于服务端当前版本,否则返回 30019。旧实现从查询详情里取回了面板却丢掉了 version,只提交 remark + items,因此原位更新必然触发版本冲突;多个命令注册并发触发同步时还会互相覆盖,进一步触发 40030009。本版本在请求中带上版本号、冲突时重读重试,并对同步入口做串行化与节流。