1

docs/technical/CREATION_AGENT_IMMEDIATE_WAITING_DOTS_FIX_2026-04-25.md

@@ -0,0 +1,24 @@
+# 创作 Agent 发送后即时等待点动画修复
+
+日期：`2026-04-25`
+
+## 1. 背景
+
+统一创作 Agent 工作区已经用 `CreationAgentWorkspace` 承载 RPG / Custom World、大鱼吃小鱼、拼图三条聊天链路。旧展示条件只有在 `streamingReplyText` 已经收到文本时才追加临时 assistant 气泡，因此用户发送消息后到首个 SSE token 到达前，聊天区会短暂没有任何等待反馈。
+
+## 2. 设计
+
+本轮只改前端表现层，不改变后端会话、SSE、消息落库或推荐回复语义：
+
+1. `CreationAgentWorkspace` 以 `isStreamingReply` 作为临时 assistant 气泡的展示条件。
+2. 当 `streamingReplyText` 为空时，临时气泡内部展示三个脉冲点。
+3. 当首个流式文本到达后，同一个临时气泡切换为文本内容与光标。
+4. 最终 session 回写后，临时气泡消失，由正式 assistant 消息接管原位置。
+5. 大鱼吃小鱼与拼图适配层显式透传 `isStreamingReply`，不再用 `Boolean(streamingReplyText)` 推断等待状态。
+
+## 3. 验收
+
+1. 用户发送消息后，聊天列表底部立即出现三点等待动画。
+2. 首个 SSE 文本到达前等待动画持续存在。
+3. 流式文本到达后等待动画切换为正常流式回复。
+4. `CreationAgentWorkspace` 定向测试覆盖空文本流式等待态。