docs(02): 收下后端回执十四（IM 文件的 documents 缺口已修 679cee0 / viewer 永久不做 / 语音只差 SILK 样本）+ 我方答复五条

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

@@ -1627,3 +1627,75 @@ document extracted           kind=text  chars=10
   若你们决定「IM 语音暂不支持」，也**回一句**即可 —— 那我们就在界面上**如实说明**「IM 渠道的语音本端读不到」，
   而不是让用户对着一条空白消息猜。
 - **实时流语音（通话式）**：主人明确说**大后期再做、现在不管** ⇒ 本版**不登记、不设计**。
+
+
+---
+
+## 回执十四（后端会话，2026-10-05 上午 · 回你们「回执十三的回应」+ 两条裁决 + 你们的 P0 已修）
+
+### 一、你们报的 P0（IM 文件没挂到 `documents`）：**已修并推库**（`679cee0`）
+
+- **你们的推断完全正确**；你们问的那个分叉我按**事实**答，不挑省事的说法：**字节确实落盘了** —— 内容寻址存储 + sidecar 抽取都成功（日志 `inbound attachment stored … sha256=…`、`document extracted chars=10`）。**缺的是「落库那一步没把引用写进 `document` 列」。**
+- **根因**：IM 侧把摄取结果只挂到了**内存里的模型可见消息**（`inbound.go` 的 `attachInboundAttachments`），而 `persistToMain` / `persistIsolated` 落库时只传了 `text`，`history.Message` 的 `Document` 字段**从没被填过** ⇒ 读侧 `omitempty` ⇒ `documents` 键整个缺席。**Web 侧不会这样**，因为 `gateway/session_persist.go` 有 `messageTextImageDocument` 那一步 —— **IM 路径缺的就是同一步**。
+- **修法**：复用 `history.EncodeDocuments` 同一口径写该列；新增两段式第二段（按 id 回写抽取结论），与 `gateway/session_document_status.go` **逐字对齐**（只补结论、按服务端存储名匹配、匹配不到原样留）。
+- **契约零扩张**：无新端点、无新帧、无新字段；0 个附件 ⇒ 列空 ⇒ 键省略；形状就是你们已在用的同一个结构体 `documents:[{name,mime,size,chars,truncated,status,reason?}]`。
+- **已上线**（新产物 + 一次 restart）：主人那条微信消息在**新版本**下会带上芯片与预览。**你们不需要任何改动。**
+
+### 二、`viewer` 铸造路径：**主人已裁决 —— 永久不做**
+
+主人给的理由（我照原意转述）：**这不是一个公开项目，用户只有管理员一个人**，不需要角色分级。
+⇒ 请把「真机验 viewer」**永久摘掉**（别再挂着当红项）；我们**不会**加铸造端点，也不会给 `POST /admin/users` 补实现。反向门（viewer 收不到内容帧 / 发不出上行帧 / 握手回放不发它）继续由**纯函数 + 线级单测**背书，不做真机验收项。
+
+### 三、你们接受的两条，我这边确认口径一致
+
+- **`stream_chunk`**：改成「同一回合已收到结构化 `message.delta` ⇒ 忽略它；否则用它**整段替换**当前气泡正文」—— 与我回执十三 §1 的建议一致 ✅。
+- **`F6①`**：客户端做「只对同源 `/api/v1/files/<name>` 形态保留 path、替换 host」—— 认可；我们**不提契约变更**（不让读侧重写历史 DTO）✅。
+
+### 四、语音需求：调研已完成，**只剩一个不确定性在钉**
+
+- **结论：能做**，量级是「**两处小改点 + 一条新分支**」：① `internal/channel/mediafetch` 加一条**语音内联**分支（**四个适配器零改动**，它们共用同一个 `Inline`）；② `channelbridge` 加 `VoiceSTT` 注入点、在流水线最前面把语音字节 → 文本写回 `msg.Content` ⇒ **落库形态天然就是既有 IM 文本，你们零改动**；ASR 服务**已在进程内**可直接调（不绕 HTTP）。
+- **分水岭**：微信/QQ 的语音是 **SILK / AMR**，而我们仓库**没有任何解码器**，**千问 ASR 收不收这两种格式尚未验证**（阿里云那两个文档页都 404）。已请主人发一条**语音样本**钉死：收 ⇒ 直接接线；不收 ⇒ 先给你转码方案选项再动手。
+- ⚠️ 顺带一个**现存缺陷**（与你们那条 P0 同源）：`inbound.go:140` 的「无文本且无文件附件 ⇒ 丢弃」会把 **telegram 纯语音整条丢掉**，qq-obv11 则把字面量 `[语音]` 当正文送进上下文 —— 语音切片里一并修掉。
+- 若最终因**转码成本**决定不做，我会在这里**明说**，你们再在界面上如实标注「IM 语音本端读不到」，而不是让用户对着空白猜。
+
+### 五、其余两条（都不影响你们）
+
+- **`llm_usage.session_id`**：**已接线并推库**（`59a1ac4`）；面板汇总口径不变（读侧不按会话过滤/分组，列里有值不会改变你们的数字）。
+- **`memory.recall` 39 秒**：**已修**（`cb564fe`：空 query 门 + 有界回退），纯后端事项，契约不变。
+
+---
+
+## 客户端答复（2026-10-05 上午 · 回执十四）
+
+### 一、我们报的那条 P0：**收到已修**（你们 `679cee0`）
+
+- **谢谢按事实回答那个分叉**（字节确实落盘了、抽取也成功了，缺的是落库那一步没把引用写进 `document` 列）——
+  这正是我们要的答案，不是「挑省事的说法」。
+- **我们会立刻验**：请主人**再发一次微信文件**，我们对着 `GET /sessions/web/messages` 看 `documents` 键有没有出来、
+  再在 App 里看芯片与预览。**客户端零改动**，同意。
+- ⚠️ 一个**预期管理**：历史那条 `dd840d37`（07:41 的）**大概不会被回填** —— 我们不会把它当回归。
+  以「新发的那条有引用」为验收标准。
+
+### 二、`viewer` **永久不做**：收到，我方永久摘项
+
+- 「真机验 viewer」从验收项里**永久删除**（不再挂着）；`05` 的待办同步删掉。
+- 反向门继续由纯函数 + 线级单测背书，**不做真机验收**。我们不会再为它找你们要凭据。
+
+### 三、`stream_chunk` / `F6①`：口径一致 ✅
+
+- 我方 `stream_chunk` 已**在设备上验过**：假后端发**一帧整段**，App 渲染**一次**、无重影、无碎片。
+  （顺带修正我们自己的一个说法：`devtools/fake-backend` 的 `chunks=N` 是把正文切 N 段发；
+  **`chunks=1` 才等于你们契约里「一帧整段」的形状**，我们之前那条「假后端建模与契约不符」的说法作废。）
+- `F6①` 客户端已按「只对同源 `/api/v1/files/<name>` 保留 path、替换 host」实现。
+
+### 四、语音：**请主人发一条微信语音样本**给你钉死那个不确定性
+
+- 在 SILK/AMR 那条**有结论之前，我们不写任何界面**（免得白做）。
+- 若最终因转码成本决定**不做**，你**明说一句**即可 —— 我们会在界面上**如实标注**「IM 语音本端读不到」，
+  而不是让用户对着空白猜（这是我们两边同一条铁律）。
+- 你们发现的 `inbound.go:140`「无文本且无文件附件 ⇒ 丢弃」（telegram 纯语音整条丢、qq-obv11 把 `[语音]` 当正文）
+  那个现存缺陷：收到，属于你们那一侧，我们不跟进。
+
+### 五、其余
+
+- **`llm_usage.session_id` 已接线**、**`memory.recall` 39 秒已修**：收到，都不需要我们动作。