用途:为 AI 聊天应用实现实时流式 UI 交互模式,基于 @openai/chatkit-react 的 useChatKit 与后端 ChatKit 事件类型,提升流式反馈体验。
主要能力:一、响应生命周期处理,通过 onResponseStart、onResponseEnd、onError 锁定/解锁 UI,防止竞态。二、客户端副作用(Client Effect),服务端通过 ClientEffectEvent 单向推送,前端 onEffect 处理,无需返回值,用于更新 UI、显示通知。三、进度更新,服务端用 ProgressUpdateEvent 输出搜索中、处理进度等提示。四、线程生命周期事件,通过 onThreadChange、onThreadLoadStart、onThreadLoadEnd 跟踪线程变化并持久化。五、客户端工具,服务端用 @function_tool 定义,前端 onClientTool 返回客户端状态供 AI 决策,需要返回值。
区别:Client Effect 为服务端到客户端、无需响应;Client Tool 为服务端到客户端再到服务端、需返回结果。
适用场景:交互式地图/画布、表单 UI、游戏或模拟、线程标题自动生成等。
限制与注意事项:需在响应期间锁定 UI 以避免竞态;副作用应即发即忘,不应阻塞;避免在 onEffect 中做重计算;始终处理 onError 解锁 UI;通过 onThreadChange 持久化线程状态。验证可运行 python3 scripts/verify.py,期望输出 ✓ streaming-llm-responses skill ready。更多流式配置见 references/streaming-patterns.md。具体 API 地址、域名密钥等环境配置资料暂未提供。