第 1 章:对话界面为什么难做
一个输入框、一个列表、一个发送按钮——看起来比后台表单还简单。真正上手才发现,所有麻烦都发生在"字出来之后"。
学习目标
- 说出对话界面比普通表单多出的三种异步
- 记住四层结构:传输、状态、渲染、交互
- 能画出"一条 AI 回答"的完整生命周期
- 建立正确顺序:先定状态模型,再写组件
1.1 看起来的四件事
一个最小的对话界面,需求写下来只有四条:
- 用户能输入;
- 点发送后消息出现在列表里;
- AI 的回答一个字一个字出现;
- 历史消息留得住。
任何前端都能实现前三条的"静态版"。难点全在隐形的部分。
1.2 比普通表单多出来的三种异步
| 异步 | 普通表单 | 对话界面 |
|---|---|---|
| 请求 | 一次性 POST,等一个响应 | 一次 POST,但响应是长连接,随时可能断 |
| 数据到达 | 一次给全 | 分成几十上百个片段,顺序敏感 |
| 渲染 | 等数据齐了渲染一次 | 边到边渲染,每秒几十次状态更新 |
再加两个现实约束:
- 用户会中途反悔:要能"停止生成",且已出来的字不能丢;
- 失败很常见:限流、超时、断网、模型报错,每一种界面表现都不同。
一句话:普通页面处理"数据",对话界面处理"数据的到来过程"。
1.3 四层结构
四层各自的"接口"要清楚:
| 层 | 输入 | 输出 |
|---|---|---|
| 传输 | 请求参数 + 取消信号 | 片段流(text / event 对象) |
| 状态 | 片段 | 一条消息的当前快照 + 状态 |
| 渲染 | 消息快照 | 组件树 |
| 交互 | 用户动作 | 状态变更指令 |
层与层之间只传数据,不互相调用内部方法,后面每一章都在守这条规矩。
1.4 一条回答的生命周期
这张图里有三个容易漏掉的状态:pending(已发出还没收到第一个字)、aborted(用户主动停)、error(可重试)。少一个,界面就会卡在"转圈"。
1.5 本课的技术边界
| 做 | 不做 |
|---|---|
| 前端如何接收、累积、渲染 | 后端怎么实现 SSE(Lv3 的 FastAPI 课讲过) |
| 用真实接口或本地 mock | 模型效果调优、Prompt 设计 |
| React + TypeScript | 框架选型之争(Vue 同理,逻辑一样) |
| 基础组件与状态机 | 完整设计系统、主题体系 |
接口格式以 OpenAI 兼容的 chat/completions 流式响应为准——这是目前最常见的形状,换供应商时差异主要在字段名,处理逻辑不变。
1.6 先定状态,再写组件
这一课后面所有章节都遵守一个顺序:
定消息数据结构 → 定状态机 → 写传输 → 写渲染 → 最后拼交互反过来做(先画界面再补逻辑)的典型症状:
- 停止按钮要特殊处理,因为"已收内容"存在组件的局部变量里;
- 重试要从头再来,因为没记录"这次请求到哪一步失败";
- 多会话切换会串消息,因为状态挂在组件上而不是会话对象上。
本章小结
| 要点 | 说明 |
|---|---|
| 难点 | 不在界面,在"数据到来的过程" |
| 三种异步 | 长连接请求、分片段到达、高频渲染 |
| 四层 | 交互 / 渲染 / 状态 / 传输,只传数据不互相调用 |
| 五个状态 | pending、streaming、done、aborted、error |
| 顺序 | 先状态模型,再组件 |
| 边界 | 本课只管前端;后端与 Prompt 在别的课 |
下一章
浏览器到底怎么收到"一段一段的字":EventSource 为什么不够用,fetch + ReadableStream 怎么接。