dootask/resources/ai-kb/zh/concept/ai-assistant/streaming.md

id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, negative, last_verified

id	title	type	feature	scope	locale	aliases	related_tools	related_pages	prerequisites	negative	last_verified
ai-assistant.streaming.concept	AI 助手流式输出	concept	ai-assistant	end-user	zh	AI 流式回答 边写边出 AI 一边打字一边显示 SSE 流 AI 实时输出				不支持 WebSocket 推送，固定走 SSE 不支持手动重试单条；流断后该 message 标记 error，需重新发送 同会话并发流会被前一个的发送动作清掉	v1.7.90

AI 助手流式输出

定义

AI 助手通过 SSE（Server-Sent Events） 接收上游 LLM 的逐 token 输出，每收到一个 chunk 就追加到当前 message 的 rawOutput，呈现 ChatGPT 般「边写边出」的效果。

数据流

1. POST api/assistant/auth → 拿 stream_key
2. EventSource ai/invoke/stream/{stream_key}
3. 监听三类事件：
   • append → 追加（entry.rawOutput += chunk）
   • replace → 整段替换（entry.rawOutput = chunk）
   • done → 流结束（entry.status = 'completed'）
4. 断流 / 异常 → handleStreamFailed

事件类型

事件	用途
append	普通增量 token（最常见）
replace	整段替换（工具结果回填、思考链重写）
done	流结束，payload 含 error 字段表示上游报错

状态机

每条 AI message 4 个状态：

• waiting → 已发出但首个 chunk 未到
• streaming → 正在接收 chunk
• completed → done 正常收到
• error → 上游错误、连接失败、用户中断

并发与归属

• 每个流绑定 owner = {sessionKey, sessionId, localId}
• 用户切到其他会话后，原流仍后台跑，结束时写回原会话存储
• 发新问题前会清掉同会话的所有活跃流，防止两段对话错位

中断恢复保护

• 关浮窗 / 页面崩溃后，下次加载会话发现 message 仍是 streaming/waiting 则归一为 error
• 避免「永远转圈」（sanitizeResponsesForPersist）

滚动行为

• 视图在最底部时新 chunk 自动 scrollToBottom
• 用户向上翻历史时（距底 > 20px）不强制下拉

不支持

• 不支持 WebSocket
• 不支持 chunk 级别撤销
• 不支持自动重试断流

相关

• ai-assistant.stop.howto
• ai-assistant.modal.concept
• ai-assistant.session-save.howto