Repository navigation
Releases
v0.3.16:六笔修复全实弹批次
QQBot 多角色单进程六笔缺陷修复全实弹批次(v36→v43,11-18/11-19 二十四小时战役)
- P6 镜像身份守卫:SSE 重放事件穿透时序锁致 QQ 直答回合重复收摘要 → promptId 来源身份核对(owner 拍板:判信息来源不依赖时序)
- P8 SSE 静默看门狗:对端 FIN/RST 部分路径下 body 迭代器不抛错 → 120s 零字节判死走既有指数退避(QQ_SSE_SILENCE_MS 可覆盖;dropsse 实弹重连 9/9)
- P9 Retry-After 退避:429 注入原固定节奏 → client 透出 [retry-after:N] 标记,就绪环路按暗示值退避(boot 实证)
- P10 看门狗双信号守卫:CLI/引导器 spawn 被心跳文件判定误杀 → 锁 mtime(instance-lock 10s 第二心跳)新鲜时不杀(watchdog-cases +4 例)
- P11 req per-call 超时:引擎挂起时裸 fetch 无限等致 deadline 判定不可达 → AbortSignal.timeout 30s + 轮询迭代容错(挂死 33min 回合复验恢复)
- P12 事件洪峰队列化:SSE 洪峰饿死事件循环(假掉线 17min 实证)→ 读循环入队+批量让出+背压丢弃(50k 洪峰心跳 293/300 实弹,新挂 47 套件链第 47 套)
- notify outbox 按角色分文件(多角色改造补漏)
测试:tsc + 47 套件全绿;六笔修复各附实弹验证证据。
工程:test/(单测)/tests/(验收产物)双目录语义落定,二者均不入 git。
OpenCode QQ Bot 0.3.15 - notify channel + review fixes
OpenCode QQ Bot 0.3.15 - notify channel + code-review fixes
- New: openqq notify external enqueue channel (external proposal Part1 adopted). cron / CI / any process can push results to QQ without session binding:
opencode run ... --auto | openqq notify --max-chars 1200
CLI only enqueues (~/.openqq/outbox.json, file-locked atomic writes, idempotent by --id, TTL 24h, fail-closed recipients); the bot consumes and delivers through the existing delivery stack (quota, passive-to-active fallback, chunking, dedup).
- Fixed: module-load env capture family - QQ_SANDBOX / OPENCODE_TURN_TIMEOUT_MINUTES / QQ_DELIVERY_DEDUPE_FILE now read lazily, so ~/.openqq/.env works in published builds without shell exports
- Fixed: rejected not-allowlisted users now log their openid (first-config dead-end)
- Fixed: recovery anchors - attachment-only messages prefer arrival-time anchor; probe length 50 -> 100
- UX: same-text duplicate reply now includes an in-flight content digest
- Docs: README platform notes + capability parity matrix; form failure copy now points to the re-ask loop
Install: opencode plugin add @linjz/opencode-qqbot | npm i -g @linjz/opencode-qqbot
Repo: https://github.com/linjz3376/opencode-qqbot (Chinese README, review playbook in docs/)
OpenCode QQ Bot 0.3.14 - retrospective verification fixes
OpenCode QQ Bot 0.3.14 - retrospective verification fixes (fixes from community code review)
- P0: QQ_SANDBOX switch now lazily reads env at request time (�piBase()), so ~/.openqq/.env works in published builds without shell exports; sibling module-load constants (OPENCODE_TURN_TIMEOUT_MINUTES, QQ_DELIVERY_DEDUPE_FILE) lazified as well
- P1: rejected not-allowlisted users now log their openid (fixes first-time-config dead-end)
- R1/R2: recovery matching for attachment-only messages prefers a time anchor near arrival; probe length 50 -> 100 to avoid prefix collisions
- R4: duplicate-intent reply now includes the in-flight content digest
Install: opencode plugin add @linjz/opencode-qqbot | npm i -g @linjz/opencode-qqbot
Repo: https://github.com/linjz3376/opencode-qqbot
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 插件更新即可。新环境变量均为可选项,默认行为即推荐形态。