Repository navigation
OpenCode QQ Bot 0.3.13 - delivery hardening
OpenCode QQ Bot 0.3.13 — 投递链路硬化与重复回复根治
本次发版集中解决两类用户可见问题:同一消息多次执行/多气泡重复投递,与长任务期间"没有任何回复"的静默观感;同时补齐投递链路的崩溃自愈与平台渲染适配。
投递幂等(重复回复根治)
- 受理双层去重:同 QQ msgId 跨进程原子占位(K1)+ 同用户同内容在途指纹(K2)——多实例并发受理与"连发同文"都只放行一次;窗口=并发在途,已完成消息的重发按重发处理
- flagrant 排队消息空会话坏账清结:启动对账对从未进会话的账只通知永不自动重派,杜绝"对账 400 永挂"
- lost 重派补时间锚:文本探针失配时按到达时刻找回原回合,已答不再重跑
重启恢复(放大器根除)
- 网关 session/seq 持久化(
~/.openqq/gateway-state.json):重启优先 RESUME,服务端只补断线窗口;失败自动回退 IDENTIFY,附 seq 回补观测日志 - 单实例锁新增 60s 周期自检:锁被他人接管/锁文件消失即自杀退出,杜绝多实例暗跑(含插件自动拉起通道的 try 模式即退)
直答体验(共享桌面会话)
- 直答回合归属:prompt 以 API 受理返回的 user 消息 id 为锚,前台直答 / 后台等待 / 重启补投都只取"本回合"的产物——不再出现"等 21 分钟拿到别人排障报告"的错位
- 受理回执可开关:默认不发"已收到",调试期设
QQ_ACK_RECEIPT=1召回 - 后台停滞通告升级:带任务状态(已停滞/状态不明/已终结未回传)+ 最近工具动作 + 无进展时长
QQ 渲染保真
- 出站有序列表
1.自动转1、:QQ 渲染器对1.型会跨段全局续编(实测),顿号形态逐字保真;代码块内不动、变换幂等
其他
- 标准 QQ 端能力(审批四键卡片、子会话审批来源标注、下拉队列/命令面板)随本轮全部回归
- 文档:README 能力矩阵/环境变量/排障表同步;
docs/review-20261103-replay.md为本次根治的完整复盘(根因链路/验收账/残余风险)
升级提示:npm 用户直接 npm i -g @linjz/opencode-qqbot@0.3.13;插件用户经 opencode 插件更新即可。新环境变量均为可选项,默认行为即推荐形态。