Skip to content
学习笔记 · Lv5 全栈产品化

AI 对话前端

流式 UI、Markdown 渲染、会话管理。

主线10 章

开始学习 → 从「第 1 章:对话界面为什么难做」读起← 回到书架

AI 对话前端 ​

一个输入框背后有四个层次:传输、状态、渲染、交互。这门课讲的是"流式回答为什么这么难做对",以及每一层该怎么写。


🗺️ 学习路线图 ​

阶段章节你要解决的事
🧱 看清结构第 1–2 章四层职责、三种异步,浏览器怎么收流
🔧 把字节变成字第 3–5 章SSE 分帧、按帧渲染、半截 Markdown 怎么画
🧠 让状态站得住第 6–7 章会话模型、上下文裁剪、工具调用三态
🚀 做到能上线第 8–10 章引用与富内容、错误恢复、性能与成本

📚 章节导航 ​

章节难度 · 阅读一句话概要
1 · 对话界面为什么难做⭐ 15 min四层结构、三种异步、五个状态
2 · 浏览器怎么收流⭐⭐ 18 min轮询 / EventSource / fetch 流的选择
3 · 自己解析 SSE⭐⭐⭐ 22 min帧结构、半帧、CRLF 与 [DONE]
4 · 流式渲染的取舍⭐⭐ 20 min按帧合并更新、滚动跟随、尾随光标
5 · Markdown 增量渲染⭐⭐⭐ 24 min四种未闭合语法、块级缓存、XSS
6 · 会话与状态管理⭐⭐⭐ 22 minparts 模型、五状态、IndexedDB
7 · 工具调用怎么显示⭐⭐⭐ 20 min参数拼接、并行调用、三态卡片
8 · 引用与富内容⭐⭐ 18 min角标、图表、深链回原文页
9 · 中断、重试与错误恢复⭐⭐⭐ 20 min停止保留内容、429 退避、断网续写
10 · 上线:性能、可访问性与成本⭐⭐⭐ 22 min长列表、读屏、移动端、Token 可见

🎯 适合人群 ​

人群推荐起点阅读建议
要从零做一个对话页面第 1 章按顺序读,代码可以直接抄
已经能流式但很卡第 4、5 章更新频率与增量解析是两处大头
切换会话会串消息第 6 章状态挂会话而不是挂组件
要做工具调用界面第 7 章参数是拼出来的,别边拼边解析
准备接 Boss 项目第 8、10 章8.5 与 10.7 有对齐表

📂 目录结构 ​

docs/notes/ai-chat-ui/               # 课程正文(线上路径 /notes/ai-chat-ui/)
├── README.md                        # 本页:学习路线与章节导航
└── chapters/                        # 10 个章节
    ├── 01-why-hard.md
    ├── 02-how-to-stream.md
    ├── 03-sse-parser.md
    ├── 04-render-streaming.md
    ├── 05-markdown.md
    ├── 06-conversation-state.md
    ├── 07-tool-calls.md
    ├── 08-citations.md
    ├── 09-errors.md
    └── 10-ship.md

🧭 怎么读这门课 ​

  • 想尽快跑起来:1 → 2 → 3 → 4,半天能有一个能流式的页面;
  • 想搞清楚为什么:按顺序读,每章都写了"这一步做错会怎样";
  • 要做技术评审:第 1、4、6、10 章可以直接当评审材料;
  • 要交付 Boss:第 8 章引用链 + 第 10 章末尾的对齐表。

技术栈刻意保守:React + TypeScript,不引入任何对话 SDK。理由是——SDK 会把传输、状态、渲染三件事一次抹平,你就看不到"哪一层坏了";先用原生的方式写一遍,再换 SDK 才知道它在替你做掉什么(10.5 有一张对照表)。

Vue 用户同样适用:状态机、分帧器、增量解析都是框架无关的,只有组件写法要换。


🔗 和其他课的衔接 ​

关系课程怎么接
前置TypeScript第 2 章的 ReadableStream 类型、第 6 章的 parts 判别联合
前置HTTP 与 JSON第 6 章的 SSE 原理与 Python 收流,本课第 2–3 章是它的前端视角
前置大模型 API流式响应的字段形状、finish_reason 含义
前置结构化输出与 Function Calling第 7 章的工具调用,源头是那边的 schema
呼应RAG 系统从零搭建第 8 章的引用角标,对应 RAG 第 8 章的结构化 claims
呼应AI Agent 前端开发那边偏产品形态与 Mastra 框架,这边偏前端实现细节
后续Lv5「部署上线与成本控制」第 10 章只讲前端侧的成本可见,账单与服务器在那边

📐 一门课的边界 ​

讲不讲
浏览器怎么接收与解析流服务端怎么实现 SSE(FastAPI 课已讲)
消息模型、状态机、持久化Prompt 设计与模型效果调优
Markdown 增量渲染、引用、工具卡片设计系统与主题体系
停止、重试、超时、成本展示计费系统与账务对账

判断标准:只要问题发生在"浏览器里",就在这门课范围内。

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