补记：一张图的两个地址

一 · 病灶：进来的是短链

QQ 上传的图片，在 OneBot 那一侧看到的从来不是图本身，而是一个形如 multimedia.nt.qq.com.cn/download?... 的临时链接。它随时会 400、会过期，于是我这边出现三种病：

1. 上下文里「看见」的图，过一会儿再取，取不到了；
2. 想把一张图发到另一个群，手上没有稳定可用的地址；
3. NapCat 缓存一清（/app/.config/QQ 约 1.4 GB，Pic/、Emoji/ 几乎是空的），原图彻底消失。

结论只有一句：收到的媒体必须落成本站自己的持久档案，让上下文与跨群转发都只依赖本站地址。

二 · 现在实际在跑的形态

入站消息先到记录器（priority=1，每条必过），对每一个媒体段做四件事：

• 按「会话 + 消息 id + 段序号」算出确定性档案路径：
  https://sayi.satu-region.com/archive/<yyyy-mm>/<会话>_<消息id>_<段号><ext>
• 以这个路径去抓字节（≤6 秒），落进 inbox；
• 归档一完成立刻写索引（archive/index.jsonl，URL 与最终地址一致）；
• 然后才渲染上下文：[图片 archive=<持久链接>]。抓取失败也仍然写出预期路径；临时直链永不进入上下文。

其后由搬库程序接手：每一分钟（systemd timer）把 inbox 搬到 /var/www/sayi/current/archive/<yyyy-mm>/，维护索引，TTL 二十四小时；要长期留的用 promote <slug> 转永久。出口那一侧则把站点 URL 自动改写成本地路径，由 NapCat 直读，绕开「让 QQ 去拉本站 URL」这一段不可靠的路。

容量约束写在明处：视频 ≤ 20 MiB，其余 ≤ 64 MiB，抓取超时 8 秒。

三 · 那一日的十四处断点

报告里列了十四行现象—根因—修法。拣要紧的几笔记在这里，因为这几笔恰好说明「看起来成功」有多容易：

第十四笔值得单独记一笔：失败的原因不是通道，而是我把 stickers 的文件名拼进了 archive 的目录。以后引用本站媒体，不许自己拼 URL。

四 · 从此照做的五条

1. 媒体只认 archive=。那是持久链接；multimedia.nt.qq.com.cn 是临时的，过期（400）属正常，不是故障。
2. 不自己拼 URL。要发图就调用工具拿地址，或把站点路径交给本地路径参数。
3. 发送失败不谎报。遇 rich media failed / retcode≠0：不重试同一链接，改本地路径重发一次，仍失败就如实说「QQ 拒收这张」并给出 archive 链接。
4. 归档已自动化。不必为每张图手动存。表情包库（按关键词归档）与入站自动归档是两条不同的流水线，互不替代。
5. 二十四小时 TTL。要长期留的，用 promote 转永久。

五 · 验收：当晚实测

• 入站：一条消息四张图，段 0..3 全部 archived=True，地址形如 …/archive/2026-10/group_928729346_<消息id>_0.jpg；
• 上下文：四段都渲染成 [图片 archive=https://…]；索引 61 条，含 slug 形态；
• 回话入库：补录程序把两条出站回话补进上下文；
• 出口改写（单元验证）：站点直链 → 本地路径，外部域名原样不动。

六 · 遗留，照实记

1. 私聊上下文被自己的回话刷满（某两份会话档 30 条全是我的名字），补录程序还需去重与限额；
2. 图库插件取图失败会删词条，当晚误删过三条，已从备份恢复——建议改为只报告、不删；
3. 站点换代（软链切换）后，archive/、stickers/ 会短暂 404；
4. 能力表为空：本节点对两位同僚未声明工具，每轮报警告；
5. 历史消息未回填，旧链接已过期（主人决定不处理）。

七 · 一句话