群总结 HTTP 422 静默落盘、空正文引用回复与合并转发递归解析
本文目录(3 节)
9 月下旬到 10 月中旬,群里陆续反馈过三件看起来互不相干的事:定时群总结偶尔只吐文字不出图、引用别人的消息再 @可不 时完全不回话、转发进群的聊天记录点名让可不总结也只会回“看不到里面写了什么”。顺着日志和适配器源码往下查,三件事都卡在消息与渲染链路的静默降级上。
1. 群总结不出图:t2i_r1_device_scale: "low" 触发 HTTP 422 且错误 JSON 被当成图片保存
9 月 20 日排查 astrbot_plugin_qq_group_daily_analysis 时,日志里没有任何异常堆栈,只看到群总结直接退回成了纯文本。
在容器里抓包复现渲染请求才发现两处叠加的问题:
- 插件配置里写了
"t2i_r1_device_scale": "low",而远端接口https://t2i.soulter.top/text2img/generate的 Pydantic schema 只允许'normal'、'high'、'ultra'或None。传"low"时接口直接返回 HTTP 422。 - AstrBot 的
download_image_by_url()在下载渲染结果时没有检查 HTTP 状态码,直接把 422 返回的 JSON 报错正文写进了临时.jpg文件。后续发送图片时底层校验文件头失败,才触发文本兜底。
先把插件配置里的缩放档位改回 "high"(并在后续把自定义 HTML 模板渲染切到了容器内本地 Chromium),422 假图落盘的问题就消失了。
2. 引用消息 + @bot 空正文 13ms 空返回,以及第一版补丁误伤指令前缀
9 月 26 日,群里有人引用一条长消息并 @可不(后面不打任何字),或者引用一张守望先锋结算图直接 @可不,日志显示从收到事件到 Prepare to send 只有 13ms,什么都没发出来。
读 aiocqhttp_platform_adapter.py 的解析逻辑可以看到:OneBot 事件进来时,at 段如果目标是机器人自身会被跳过,reply 段只会被塞进 message 组件链,不会往 event.message_str 里写任何字。于是当用户只引用不打字时,event.message_str 是空字符串 "",后续流程直接判定为空消息跳过。
我第一版修得太猛:只要检测到 Reply 段,就调 get_msg 取回原消息文本,无条件拼成 [引用 XXX 的消息: ...] 塞到 message_str 最前面。结果刚重启,群友引用消息发 /b50 或其他带前缀的插件指令时全挂了——因为插件的 msg.startswith("/") 被前面的 [引用...] 顶掉了。
第二版把条件收紧成 pending_quoted_text 延迟回填:
- 只有当遍历完所有消息段后,
message_str.strip()仍然为空,且被引用消息里没有图片等媒体附件时,才把引用的文本写入message_str; - 如果用户自己打了字(哪怕是
/b50或“帮我看看”),保持原message_str不动,避免破坏任何插件的前缀匹配; - 针对守望先锋战绩插件
astrbot_plugin_overstats,单独给(group_id, user_id)加了 30 分钟的最近查询战网号缓存——用户在查完一次战绩后,直接引用战绩图追问详情时,不需要每次重输BattleTag#1234。
同一天还顺手把群复读机 astrbot_plugin_group_repeater 敛了一遍:排除含 @、引用、语音和图文混排的消息,图片比对时剥离腾讯 CDN URL 的过期签名 query,并用 _covered[group_id] 记住当前已复读的指纹——同一句话跟过一次后,除非群里有人插了别的话,否则第 3、第 4 个人继续刷屏时绝不二次跟风。
3. 合并转发聊天记录:为什么开 parseMultMsg 后内层还是空?
到了 10 月 21 日,我想让可不也能看懂群里转发的「聊天记录(合并转发)」。默认情况下:
- NapCat 的
onebot11_<qq>.json(实际挂在 Docker volume/var/lib/docker/volumes/.../_data/下,而非宿主机的空目录)里parseMultMsg默认是false,只吐一个forwardID; - 调 OneBot 的
get_forward_msg接口只能拿到顶层消息,一旦遇到转发套转发,NapCat 直接返回「消息已过期或者为内层消息」。
我把 NapCat 的 parseMultMsg 改成 true,并写了独立插件 astrbot_plugin_forward_reader 挂在 OnWaitingLLMRequestEvent 上(赶在 build_main_agent 和记忆写入前把展开的记录追加进 event.message_str)。
但第一版放上去实测,群里引用一条三层嵌套的合并转发并 @可不 说“总结一下”,日志里一行输出都没有。拿真实 msg_id=597191676 在容器里 dump 出 get_msg 的返回值才抓到两个真凶:
- 转发在被引用的消息里:用户常常是「先看到别人发的合并转发,再去引用那条转发
@可不」。此时主消息里只有reply段,没有forward段。必须先沿着reply.data.id调一次get_msg,再从被引用消息的message数组里找forward。 content里装的不是node,而是完整消息对象:文档里常把转发内容写成{"type": "node", "data": {...}},但 NapCat 开启parseMultMsg后塞进forward.data.content的其实是形如{"sender": {...}, "message": [...], "raw_message": "..."}的完整消息对象列表,内层嵌套的forward就藏在子项的message数组里。
把 _content_to_records 改成按项分派(同时兼容完整消息对象、node 包装、段数组与最大 6 层递归防环),再用刚才那条三层嵌套的真实群消息跑回放,15 行带层级的对话一次展开通过。