智能对话界面的流式输出与安全渲染
对话界面的重点是流状态、取消请求和不可信内容的安全渲染。模型输出应被视为外部输入。
流式状态不要直接拼接到渲染逻辑
用独立状态保存当前消息、完成消息和错误状态。请求被取消或组件卸载时，及时中止读取。
读取流的示例
const reader = response.body?.getReader(); if (!reader) throw new Error('响应没有可读流'); const decoder = new TextDecoder(); let text = ''; for (;;) { const { done, value } = await reader.read(); if (done) break; text += decoder.decode(value, { stream: true }); setDraft(text); }Markdown 渲染应关闭或严格过滤原始 HTML；代码块、链接和附件也要有明确的安全策略。
验证建议
测试断网、取消、服务端错误、超长输出和含 HTML 的输出，确认界面不会卡住或执行不可信内容。
把问题放回运行现场
涉及 消息分片、渲染节奏、取消请求、富文本与错误状态 时，先不要急着给方案命名。更实在的做法是选一条实际链路，把输入、处理中间状态和最后输出依次写下。这里的重点不是收集越多指标越好，而是每一项信息都能回答一个具体疑问。数据一旦脱离发生条件，往往只会增加解释成本。
区分稳定规则和暂时假设
消息分片、渲染节奏、取消请求、富文本与错误状态 里有些内容是长期约束，有些只是当前实现下的选择。两者混在一起，后续修改会很难判断哪些可以动。文档中可以直接标明依赖的版本、默认配置和未覆盖场景；当条件变化时，先复查这些假设，再讨论是否需要调整实现。
用小范围修改寻找原因
出现异常后，先缩小范围比先扩大监控更有效。围绕 消息分片、渲染节奏、取消请求、富文本与错误状态，可以关闭不相关功能、固定输入或减少并发，观察问题是否还存在。每次只改变一个条件，哪怕过程略慢，也能避免多个变量叠加后无法归因。确认原因前，不应把猜测写成结论。
让协作有共同参照
多人处理 消息分片、渲染节奏、取消请求、富文本与错误状态 时，最容易丢失的是上下文。保留样例、时间点、关键配置和观察到的现象，其他人才能在相近条件下复查。沟通里应明确哪些内容已经确认，哪些仍待验证；这样评审讨论会落在材料上，不会反复解释同一个术语。
为下一次维护留下入口
改动结束后，写清楚修改的位置、影响的调用方和仍然存在的限制即可。消息分片、渲染节奏、取消请求、富文本与错误状态 不需要被包装成通用经验，读者只要能据此判断适用范围就够了。若有临时规避措施，也应注明何时可以删除，避免它在后续版本里变成没人敢碰的遗留逻辑。
使用条件与限制
如果改动会影响他人使用 流式界面，提前说明兼容方式和迁移窗口很重要。使用者最需要知道的是旧调用是否还能工作、数据会不会变化、出现问题时找谁以及如何暂时恢复。把这些话写清，能减少上线后通过口头消息补充的成本。
也要承认有些问题暂时没有完全答案。对 流式界面 来说，未覆盖的负载、缺少的样本或尚未验证的平台都可以直接写明。这样的保留不会削弱文章，反而让读者能根据自身条件决定是否采用，并在补充材料后继续完善。
对于 流式界面，还要避免把开发环境中的顺利表现直接外推到真实使用条件。数据规模、设备能力、网络状况和操作顺序只要有一项变化，原先的结论就可能失效。把这些条件写入说明，后续调整时就能明确该重看哪一段，而不是重新猜测整个系统。
流式交互的说明还应保持与实现同步。配置或依赖更新后，重新确认原有前提是否成立，避免旧结论继续影响新的使用场景。
