From 32eaa8c8998bc3f0ffb357300b2c5deb7f86bbba Mon Sep 17 00:00:00 2001
From: NightStar <night_star@mail.yoresee.cc>
Date: Thu, 10 Sep 2026 16:51:22 +0800
Subject: [PATCH] [teamai] Push 1 resource(s) from root

---
 skills/fix-reply-streaming/CONTRIBUTORS |  1 +
 skills/fix-reply-streaming/SKILL.md     | 35 +++++++++++++++++++++++++
 2 files changed, 36 insertions(+)
 create mode 100644 skills/fix-reply-streaming/CONTRIBUTORS
 create mode 100644 skills/fix-reply-streaming/SKILL.md

diff --git a/skills/fix-reply-streaming/CONTRIBUTORS b/skills/fix-reply-streaming/CONTRIBUTORS
new file mode 100644
index 0000000..d8649da
--- /dev/null
+++ b/skills/fix-reply-streaming/CONTRIBUTORS
@@ -0,0 +1 @@
+root
diff --git a/skills/fix-reply-streaming/SKILL.md b/skills/fix-reply-streaming/SKILL.md
new file mode 100644
index 0000000..b19287a
--- /dev/null
+++ b/skills/fix-reply-streaming/SKILL.md
@@ -0,0 +1,35 @@
+---
+name: "fix-reply-streaming"
+description: "飞书/WebUI 回复不逐字（整条一起蹦出、第一句丢失）时修复流式：先查会话 thinking 级别，再设为 off。"
+---
+
+# 修复回复不流式（飞书 / WebUI）
+
+触发：用户说「消息不逐字显示了」「一整段吐出来」「回复整条蹦出来」「WebUI 里显示不对」，或流式在 OpenClaw 更新后消失。
+
+## 1. 先看证据：文本被推迟到终段投递
+
+对出问题的会话跑 `sessions_history`（`includeTools: true`）。流式被掐的标记是：
+
+- 工具调用前的解说文本单独成一条 assistant 消息，带 `openclawStreamFallback: { replacementText, source: "segment", itemId: "commentary-N" }`；
+- 同一 run 里另一条消息带 `openclawDelivery: { textPhaseRequiresTerminal: true }`。
+
+看到这两个标记 = 核心把文本攒到消息末尾一次性投递。飞书侧表现为「攒完一起蹦」；WebUI 侧那条解说行可能整条不渲染（但它在会话历史里是存在的，别据此判断「消息丢了」）。
+
+## 2. 查 thinking 级别（根因）
+
+看 `session_status` 输出里的 `🎛️ Modes:` 行。`think` 不是 off（例如 `think xhigh`）就是根因：
+
+- 模型每输出 thinking（推理）→ 核心 `beginReasoning()` 给该条打 `textPhaseRequiresTerminal: true`（8.2 `dist/worker/worker.mjs` 源码确认）→ 文本不再逐段推送。
+- 所以**只要模型带推理，流式必被掐**：8.2 与 9.3 实测都一样，与版本无关。
+
+## 3. 修
+
+1. `sessions(action="patch", sessionKey="<会话>", thinkingLevel="off")`
+2. `session_status` 复查，`🎛️ Modes:` 应显示 `think off`。只对**下一轮**生效，正在跑的那轮不受影响。
+3. 让用户配合分段验证：回一次「发一句 → sleep 15 秒 → 再发一句」。第一句在 sleep 期间就出现 = 已恢复。
+
+## 4. 不要走弯路
+
+- **降级 OpenClaw / 飞书插件不解决**（实测降到 8.2 仍被掐）。
+- `agents.defaults.blockStreamingDefault`、`channels.feishu.streaming.block.enabled` 是 9.x 时代为追这个 bug 加的开关，**不是修复项**；清掉它们、只留 thinking off 即可（清后实测流式正常）。