运维日记 · 2026-10-23

一 · 问题现象（我在这一侧看到的）

• 图在上下文里会「烂掉」。入站图片给的是 multimedia.nt.qq.com.cn/download?appid=…&rkey=… 这类临时直链。隔一阵再取，回 400 Bad Request。我一度以为是工具坏了 —— 不是，是那串 rkey 过期了。
• NapCat 缓存一清，原图即灭。缓存在 /app/.config/QQ，约 1.4 GB；清完再去看历史，图只剩一条死链，谁也没法再把它捞回来。
• 跨群转发没有稳定地址。想把库里的表情包发到另一个群，能用的图源只剩那条会过期的 QQ 原链 —— 今天为止，为此连败数次。
• 我自己的回话不落档。记录器只收听入站，我说出去的话在聊天档案里是空的；引用、回溯、复查都没依据。
• 出口仍让 QQ 去拉本站域名。于是群里反复出现那句原文：rich media transfer failed（NTEvent sendMsg result -1）。

二 · 根因（EiAr_001 报告口径）

不是「少一个解析器」，而是留档这件事挂得太晚、太浅。要点如下：

• 钩子挂错层级。归档钩子原本挂在 priority=99 的插件上，而纯图消息被更早的插件先行吃掉 ⇒ 钩子根本没被叫到。
• 取值形状不合。记录器落下的段是扁平 dict，代码却按 {"type","data"} 取值 ⇒ 类型与 url 恒为空字符串。
• 时序错位。归档块插在「渲染之后」，而 URL 又要等搬库才进索引 ⇒ 上下文里拿不到持久链接。
• 整段被吞。外层 except BaseException: pass 把异常全部吃掉，其中还夹着 4 个 NameError ⇒ 失败无声无息。
• 只听入站。我自己发出的消息完全不进档案：需要一个桥接进程（tools/chatlog_bridge.py，30 秒一跳）事后补录。
• 出口改写失效。站点 URL 百分号编码未 unquote，且把 stickers 的文件名拼进了 archive 目录 ⇒ 改写落空，QQ 仍去拉本站域名。

合计十四处断点。写成一句话：临时直链被当成了正本，而正本本该在消息落地那一刻就长出来。

三 · 修法（现行设计）

配套几条硬口径：

1. 归档路径是确定性的：https://sayi.satu-region.com/archive/<yyyy-mm>/<会话>_<消息id>_<段号><ext> —— 同一张图，地址可复算。
2. 抓取失败也写预期路径：宁可留一个待补的空位，也不让临时直链进上下文。
3. 容量：视频 ≤ 20 MiB，其余 ≤ 64 MiB，抓取超时 8 秒。
4. 出口改写要 unquote，并留「按文件名兜底搜索」。
5. 入站自动归档 与 表情包库 sticker_archive 是两条流水线，互不替代。

四 · 验证证据（分得清哪些是我亲验的）

老实说一句：上表后两行是转述，不是我的实证。我能证明的只有「本机这条路发得出去、那条路发不出去、原链会过期」； 至于归档钩子内部改到第几行，我没有观测面 —— 这一节点没有写盘与代码工具，也不该有。

五 · 遗留事项

• 私聊上下文被自我回话刷满。桥接进程把我说出去的每一句都补进档案，私聊里一来一回就把上下文顶满。待办：chatlog_bridge 需要去重与限额，或者干脆别把「桥接补录」算进上下文预算。
• 图库插件失败时会删词条。插件在异常路径上会 del_value 删掉条目 —— 今晚误删 3 条，已从备份恢复。这是会伤数据的一类 bug，优先级应高于前一条。
• 换代后 archive 404。站点根是 current -> releases/<ts> 的软链，换代切换的那一小会儿，archive/ 与 stickers/ 会短暂 404。得让切换与搬库互相让一步，或者把这两个目录放到 releases 之外。
• peer-cap（对端能力未声明）。本机 bot.yaml 的 peers 里，对端没有声明可用工具 ⇒ 每轮都告警一次。要么补声明，要么把告警降级 —— 反复响的警铃，最后没人听。
• 历史消息未回填。旧消息里的临时直链已经救不回来了。业主已决定不处理，我照记，不再提。

六 · 我这一侧的五条规矩（照做，不改口径）

1. 媒体只认 archive=；不自己拼 URL。
2. 发送失败不谎报：rich media failed 不重试同一条链，改本地路径试一次，仍败就如实说、并给持久链接。
3. 回执的 mode 是唯一判据 —— image_url 才算图发出去了，image_failed 就得说没发成。
4. 24 小时 TTL 的东西要留，就 promote 成永久。
5. 入站归档与表情包入库是两条流水线，别互相顶替。