docs(05): 锚点补记十八——W47 静默按事故复位（清零点收进一个纯判据、事故=队列空到空），含为什么不选「只在成功时清零」与三条验收体验

devdocs/05-开发进度与交接.md

@@ -1208,3 +1208,28 @@ curl -s -X PATCH "$BASE/api/v1/sessions/$SID" -H "Authorization: Bearer $TOK" \
 > **不是我方本地状态的 bug**（我方与 `devdocs/03:141`「thinking / tool_call：仅 WS 实时有」逐字一致）。后端**其实已经把工具调用落进 `flow_graphs`**，缺的是「取出来给聊天端」。
 > 已登记进 `02`（`b8399b5`）：要可选字段（`omitempty`，缺席=老行为逐字不变）、覆盖面对齐 `turnId`、**归属要明确**、允许开独立端点。
 > 我方接线点：目前 `ToolCard` 在「已落库消息」那条渲染路径上是**不可达代码**（渲染器签名里没有 tools 参数）——字段一到即可接。
+
+> ## ★★ 锚点补记十八（2026-10-06 · W47 队列静默改为「按事故复位」）
+>
+> ### 状态
+> `android` = **合并提交见下**；分支提交 `ce50bd2`；主树 **1158 测试 / 0 失败 / 0 错误**。W47 worktree 已清。
+>
+> ### 主人裁决
+> 「静默持续到某次补发成功（A）vs 每批结束复位（B）——**哪个从体验上更好就用哪个**」。**判定：B**，但把 B 改准成「**按事故复位**」。
+> **为什么不选 A（原实现）**：A 只在「某次补发**成功**」时清零 ⇒ 若一个坏网络时段的队列最后**以回滚/被收编结束**（而不是以成功结束），静默会**一直挂着**；之后连接恢复、再断一次、用户又发消息时**永远得不到解释**。那不是减少噪音，是**把解释永久关掉**。
+>
+> ### 改了什么
+> - `ui/chat/SendQueue.kt` 新增纯函数 **`queuedResendFailuresAfterDelivery(failures, sent, drained) = if (sent || drained) 0 else failures`** —— 清零点判据的唯一出处（与 `queuedSendNoticeAllowed` 同一写法）。
+> - `ChatViewModel.forgetQueuedNoticeIfDrained(sent)` 从「只清 `queuedNoticeTold`」改成**同时按新判据复位 `queuedResendFailures`**；`dropQueuedSend` 里原来那行 `if (sent) queuedResendFailures = 0` 删掉，改为出队后调它 ⇒ **两个清零点收在同一个函数里**。
+> - **阈值仍是 3**、「一批从空到非空只说一次」仍由 `queuedNoticeTold` 负责、`withoutQueuedSend` 等队列操作**一行未动**。
+>
+> ### 「事故」的界定与验收体验（已写进 KDoc）
+> **事故 = 队列从空到非空、再回到空的那一段**（与 `queuedNoticeTold` 的「一轮」同口径）。结束就复位，**不管它是怎么结束的**。
+> - **一次事故内**连发几条 ⇒ 只有**一次**横幅（重试本身不产生横幅）；
+> - **事故结束后**再遇新事故 ⇒ 计数已复位 ⇒ **会重新解释**，不会永久闭嘴；
+> - **长期断网**不停发 ⇒ 消息**堆在队列里、队列不清空** ⇒ 不算新事故 ⇒ **不会每条都弹横幅**；
+> - **静默 ≠ 丢弃**：计数只进告知判据，`silence never touches the queue` 那条用例继续通过。
+>
+> ### 未做
+> - **设备验证**（任务书禁碰 adb）：「一次事故一次横幅」的体验只由纯函数单测 + KDoc 钉住。若要设备验收，用 `ws_block_proxy.py` 造场景即可。
+> - 项目没有 `ChatViewModel` 单测装置，所以复位判据提成纯函数来钉（与 W43 同一做法）；清零点被调用这件事靠既有架构保证。