用途：解决 LangGraph 1.0 流式接入中的典型问题——选错 stream_mode 导致浏览器卡死、SSE 经代理缓冲后挂起、astream_events v2 事件过多压垮前端。
主要能力：提供 stream_mode 决策矩阵（实时 token 用 messages，节点进度用 updates，调试/回放用 values，可组合）；给出带防缓冲响应头与 15 秒心跳的 FastAPI SSE 端点模板；服务端过滤 astream_events(version="v2")，仅转发 on_chat_model_stream 与可选 on_tool_start/on_tool_end；提供基于 thread_id 重连、由 checkpointer 恢复的 WebSocket 变体；附代理就绪检查清单。
使用方式：需 Python 3.10+、langgraph >=1.0,<2.0、langchain-core >=1.0,<2.0、fastapi >=0.110 与 uvicorn[standard]，并配置 MemorySaver（开发）或 PostgresSaver（生产）。异步处理器中必须用 graph.astream()，不可用同步 graph.stream()；SSE 响应需设置 X-Accel-Buffering: no、Cache-Control: no-cache、Connection: keep-alive；Cloud Run 建议 --use-http2；每 15 秒发送 : heartbeat 注释防空闲超时；WebSocket 路由必须带 thread_id。
适用场景：实时 token 聊天 UI、多步智能体进度条、调试与状态回放、可取消或中途追加消息的 WebSocket 交互。
限制：需在真实代理（Nginx/Cloud Run/Cloudflare）后验证，localhost 无法复现缓冲问题；Cloudflare 免费版可能缓冲 SSE；astream_log 已软弃用，应改用 astream_events(version="v2")；Claude 工具调用轮次 chunk.content 可能为列表，需用 chunk.text 或类型判断。具体价格与更多平台细节暂未提供。