Skip to content

OpenCode QQ Bot 0.3.13 - delivery hardening

Choose a tag to compare

@linjz3376 linjz3376 released this 03 Nov 07:33
· 178 commits to main since this release

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 插件更新即可。新环境变量均为可选项,默认行为即推荐形态。