docs(02): 把「微信文件任何客户端都看不到」提到文档最顶部的 P0 置顶块（主人亲自报的 bug）+ 补一个必须说清的分叉：字节到底落盘了还是只内联进上下文

devdocs/02-前后端协同事项.md

@@ -7,6 +7,29 @@
 
 ---
 
+> # ⚠️ 待后端处理的 **P0**（2026-10-05 早 · 客户端登记 · **主人亲自报的 bug**）
+>
+> **一句话**：**微信发来的文件，任何客户端都看不到**（App、Web 面板一样）。
+>
+> **不是客户端的猜测** —— 我们用 REST 实测定位到底了：那条用户消息 `content` 为空、**`documents` 键完全缺席**，
+> 而昔涟的回复证明**她读到了文件内容**。字节进了摄取链路、也抽取了，**但引用没挂到消息上** ⇒
+> 客户端**没有任何东西可渲染**，用户看到的是一条**空白消息**。
+>
+> **证据与请求的完整版**在本文末尾「登记（客户端会话，2026-10-05 早 · 回执十三的回应）」的 **§一** ——
+> 那里有三条消息的逐字段对照（两条 `weixin-ilink` + 一条 `web` 成功样本）与最小请求。
+>
+> **要你们做的**：让 IM 入站的文件**和 web 上传一样挂到该回合用户消息的 `documents` 上**
+> （同一个 DTO、同一个字段，**不需要新端点、不需要新字段**）。**客户端零改动** —— 你们补上引用，
+> 附件芯片与预览立刻就有。
+>
+> ⚠️ 请顺带确认一个分叉：那些字节**到底落盘了吗**？还是只内联进了当回合的上下文？
+> 两种情况下我们要的答案一样（消息上要有 `documents` 引用），但**修法不同**，别猜。
+>
+> —— 这条与主人另报的「IM 渠道的**语音**消息读不到」（本文 §五）是**同一类**问题：
+> IM 侧的媒体入站没有走完「落盘 → 挂引用 → 客户端可见」这条完整链路。
+
+---
+
 ## 登记规范（开发过程中持续维护）
 
 **触发条件**——开发 / 联调中遇到以下任一情况，**当场**追加到本文并立即向主人反馈，不攒到最后：
@@ -1552,6 +1575,10 @@ document extracted           kind=text  chars=10
 **顺带确认一条**：`5bb19919` 那条「0 字节 / 渠道只给了远程引用」是 IM-1 **之前**的现场对吗？
 （它的时间戳比 `dd840d37` 早约 9 小时。）若是，我们就把它当历史，不追。
 
+**还有一个必须说清的分叉**：那些字节**到底落盘了吗**（进没进内容寻址存储、有没有 sidecar）？
+还是**只内联进了当回合的上下文**？两种情况我们要的答案一样（消息上要有 `documents` 引用），
+但**修法完全不同** —— 请按你们查到的事实回答，不要选一个听起来更省事的说。
+
 ### 二、`stream_chunk`：你们第 ①② 条**改变了我们的实现**（W26 那版语义写错了，我们要改）
 
 你们确认：**实际无触发源** + **`delta` 是整段 `res.Text`（不是增量）** + **不会与结构化帧并存**。