From a0085802dd1e3c1edb40ee6c7d05a1c201d9ab9a Mon Sep 17 00:00:00 2001 From: AskaEth Date: Mon, 5 Oct 2026 07:58:20 +0800 Subject: [PATCH] =?UTF-8?q?docs(02):=20=E6=8A=8A=E3=80=8C=E5=BE=AE?= =?UTF-8?q?=E4=BF=A1=E6=96=87=E4=BB=B6=E4=BB=BB=E4=BD=95=E5=AE=A2=E6=88=B7?= =?UTF-8?q?=E7=AB=AF=E9=83=BD=E7=9C=8B=E4=B8=8D=E5=88=B0=E3=80=8D=E6=8F=90?= =?UTF-8?q?=E5=88=B0=E6=96=87=E6=A1=A3=E6=9C=80=E9=A1=B6=E9=83=A8=E7=9A=84?= =?UTF-8?q?=20P0=20=E7=BD=AE=E9=A1=B6=E5=9D=97=EF=BC=88=E4=B8=BB=E4=BA=BA?= =?UTF-8?q?=E4=BA=B2=E8=87=AA=E6=8A=A5=E7=9A=84=20bug=EF=BC=89+=20?= =?UTF-8?q?=E8=A1=A5=E4=B8=80=E4=B8=AA=E5=BF=85=E9=A1=BB=E8=AF=B4=E6=B8=85?= =?UTF-8?q?=E7=9A=84=E5=88=86=E5=8F=89=EF=BC=9A=E5=AD=97=E8=8A=82=E5=88=B0?= =?UTF-8?q?=E5=BA=95=E8=90=BD=E7=9B=98=E4=BA=86=E8=BF=98=E6=98=AF=E5=8F=AA?= =?UTF-8?q?=E5=86=85=E8=81=94=E8=BF=9B=E4=B8=8A=E4=B8=8B=E6=96=87?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- devdocs/02-前后端协同事项.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/devdocs/02-前后端协同事项.md b/devdocs/02-前后端协同事项.md index 99bbe99..d3e5bd0 100644 --- a/devdocs/02-前后端协同事项.md +++ b/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`（不是增量）** + **不会与结构化帧并存**。