Skip to content
Lv5AI 对话前端进度 1 / 10

第 1 章:对话界面为什么难做 ​

一个输入框、一个列表、一个发送按钮——看起来比后台表单还简单。真正上手才发现,所有麻烦都发生在"字出来之后"。


学习目标 ​

  • 说出对话界面比普通表单多出的三种异步
  • 记住四层结构:传输、状态、渲染、交互
  • 能画出"一条 AI 回答"的完整生命周期
  • 建立正确顺序:先定状态模型,再写组件

1.1 看起来的四件事 ​

一个最小的对话界面,需求写下来只有四条:

  1. 用户能输入;
  2. 点发送后消息出现在列表里;
  3. AI 的回答一个字一个字出现;
  4. 历史消息留得住。

任何前端都能实现前三条的"静态版"。难点全在隐形的部分。


1.2 比普通表单多出来的三种异步 ​

异步普通表单对话界面
请求一次性 POST,等一个响应一次 POST,但响应是长连接,随时可能断
数据到达一次给全分成几十上百个片段,顺序敏感
渲染等数据齐了渲染一次边到边渲染,每秒几十次状态更新

再加两个现实约束:

  • 用户会中途反悔:要能"停止生成",且已出来的字不能丢;
  • 失败很常见:限流、超时、断网、模型报错,每一种界面表现都不同。

一句话:普通页面处理"数据",对话界面处理"数据的到来过程"。


1.3 四层结构 ​

从上到下:交互 → 渲染 → 状态 → 传输交互层输入框、发送、停止、重新生成、滚动跟随、快捷键、移动端软键盘这一层只做"意图",不碰数据流渲染层Markdown 增量解析、代码高亮、引用角标、工具卡片、错误态、加载态这一层只做"把状态画出来",不知道数据从哪来状态层(最容易做错)消息模型、流式片段如何累积、生成中/完成/中断/失败 四态、多会话、持久化这一层决定了"停止"能不能保留内容、"重试"该从哪开始传输层HTTP 请求、SSE 分帧、缓冲区、断线、取消(AbortController)数据向下依赖最常见的错误:把四层揉成一个大组件,改一个交互要动数据流,加一种消息类型要改传输。

四层各自的"接口"要清楚:

层输入输出
传输请求参数 + 取消信号片段流(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 怎么接。

本文阅读--次|全站访问--次|访客--人