kita / notes
← 回到全部笔记

事件日期 阅读约 4 分钟

群总结 HTTP 422 静默落盘、空正文引用回复与合并转发递归解析

发布于

本文目录(3 节)
  1. 1. 群总结不出图:t2i_r1_device_scale: "low" 触发 HTTP 422 且错误 JSON 被当成图片保存
  2. 2. 引用消息 + @bot 空正文 13ms 空返回,以及第一版补丁误伤指令前缀
  3. 3. 合并转发聊天记录:为什么开 parseMultMsg 后内层还是空?

9 月下旬到 10 月中旬,群里陆续反馈过三件看起来互不相干的事:定时群总结偶尔只吐文字不出图、引用别人的消息再 @可不 时完全不回话、转发进群的聊天记录点名让可不总结也只会回“看不到里面写了什么”。顺着日志和适配器源码往下查,三件事都卡在消息与渲染链路的静默降级上。

1. 群总结不出图:t2i_r1_device_scale: "low" 触发 HTTP 422 且错误 JSON 被当成图片保存

9 月 20 日排查 astrbot_plugin_qq_group_daily_analysis 时,日志里没有任何异常堆栈,只看到群总结直接退回成了纯文本。

在容器里抓包复现渲染请求才发现两处叠加的问题:

  1. 插件配置里写了 "t2i_r1_device_scale": "low",而远端接口 https://t2i.soulter.top/text2img/generate 的 Pydantic schema 只允许 'normal'、'high'、'ultra' 或 None。传 "low" 时接口直接返回 HTTP 422。
  2. 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 日,我想让可不也能看懂群里转发的「聊天记录(合并转发)」。默认情况下:

  1. NapCat 的 onebot11_<qq>.json(实际挂在 Docker volume /var/lib/docker/volumes/.../_data/ 下,而非宿主机的空目录)里 parseMultMsg 默认是 false,只吐一个 forward ID;
  2. 调 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 行带层级的对话一次展开通过。

← 返回全部手记