From 40dac87dda8b70f2a4d6902ef23335839420936f Mon Sep 17 00:00:00 2001
From: AskaEth <i@yeij.top>
Date: Mon, 5 Oct 2026 22:26:09 +0800
Subject: [PATCH] =?UTF-8?q?docs(05):=20=E8=A1=A5=E8=AE=B0=E4=BA=8C?=
 =?UTF-8?q?=E5=8D=81=E5=9B=9B=E9=99=84=E2=80=94=E2=80=94=E6=9C=AC=E8=BD=AE?=
 =?UTF-8?q?=E4=B8=A4=E4=B8=AA=E5=86=B3=E5=AE=9A=EF=BC=88P1=20=E4=B8=BB?=
 =?UTF-8?q?=E5=8A=A8=E6=B6=88=E6=81=AF=E6=B6=88=E8=B4=B9=E6=88=91=E6=96=B9?=
 =?UTF-8?q?=E6=8E=A5=E3=80=81tool=5Fexecution=20=E9=80=89=20a=20=E5=B9=B6?=
 =?UTF-8?q?=E8=A6=81=20toolCalls[]=20=E5=9B=9E=E7=9C=8B=E9=9D=A2=E5=B8=A6?=
 =?UTF-8?q?=E8=BE=93=E5=87=BA=EF=BC=89=E4=B8=8E=E6=8E=A8=E9=80=81=E6=9A=82?=
 =?UTF-8?q?=E4=B8=8D=E6=8E=A5=E7=9A=84=E5=8F=A3=E5=BE=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 devdocs/05-开发进度与交接.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/devdocs/05-开发进度与交接.md b/devdocs/05-开发进度与交接.md
index 8460e4c..62cc7f0 100644
--- a/devdocs/05-开发进度与交接.md
+++ b/devdocs/05-开发进度与交接.md
@@ -1369,3 +1369,8 @@ curl -s -X PATCH "$BASE/api/v1/sessions/$SID" -H "Authorization: Bearer $TOK" \
 >
 > ### 已派单核实
 > **只读排查**（`agent-8qtm01gd`）就为这两条取证并给出建议：问题一的「帧画的 vs 历史拉的会不会被按 id 合并成一条」（以及最小修法），问题二的「`.start`/`.update`/`.end` 三档各自是否解析 / 是否消费」以及**只发 start/end 时工具卡够不够用**。
+
+> ### 附：本轮回后端的两个**决定**与一个新 P1（补记二十四处）
+> **① P1（我方接）：主动消息实时看不到。** 核实结论：`proactive_message` 帧我们**只解了错的 id**（`messageId`，而落库行是另一个 `id`；`ignoreUnknownKeys` 把新 `id` 静默丢弃），且**整帧零消费**（`ChatViewModel.onEvent` 无该分支）⇒ **「显示两次」不会发生，但「实时看不到她主动说的话」是真缺口**（只能等重连/重开/切会话拉历史）。修法位置已定（`WsEvent.ProactiveData` 补 `id`/`createdAt` + `ChatViewModel` 加分支，**按已落库 assistant 行并入 `mergeMessages`**，**必须自己钉死主会话**——该帧壳**不带 `sessionId`**，否则会窜进每个次级会话）。
+> **② `tool_execution` 口径：选 (a)**（只认 `.start`/`.end` 按 `id` 关联；**不要他们补 `.update`**）。取舍已明确：**没有 `.update` ⇒ 工具卡的结果区是空的**（`ToolCallState.output` 只由 `.update` 的 delta 追加）⇒ **我们真正要的是他们已认领的「持久化 `toolCalls[]` 回看面」**，并请求把输出/摘要一并带上。
+> **③ 移动端推送：暂不接**（等主人自建）。并已告知他们：他们建议的「应用内提示」`message_persisted{proactive:true}` 在我们这边**零实现**（`PersistedData` 只读 `message`；客户端无任何 Notification 代码）⇒ **那条建议目前不产生任何效果**，别当兜底。