AI 对话前端
一个输入框背后有四个层次:传输、状态、渲染、交互。这门课讲的是"流式回答为什么这么难做对",以及每一层该怎么写。
🗺️ 学习路线图
| 阶段 | 章节 | 你要解决的事 |
|---|
| 🧱 看清结构 | 第 1–2 章 | 四层职责、三种异步,浏览器怎么收流 |
| 🔧 把字节变成字 | 第 3–5 章 | SSE 分帧、按帧渲染、半截 Markdown 怎么画 |
| 🧠 让状态站得住 | 第 6–7 章 | 会话模型、上下文裁剪、工具调用三态 |
| 🚀 做到能上线 | 第 8–10 章 | 引用与富内容、错误恢复、性能与成本 |
📚 章节导航
🎯 适合人群
| 人群 | 推荐起点 | 阅读建议 |
|---|
| 要从零做一个对话页面 | 第 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
5
6
7
8
9
10
11
12
13
🧭 怎么读这门课
- 想尽快跑起来:1 → 2 → 3 → 4,半天能有一个能流式的页面;
- 想搞清楚为什么:按顺序读,每章都写了"这一步做错会怎样";
- 要做技术评审:第 1、4、6、10 章可以直接当评审材料;
- 要交付 Boss:第 8 章引用链 + 第 10 章末尾的对齐表。
技术栈刻意保守:React + TypeScript,不引入任何对话 SDK。理由是——SDK 会把传输、状态、渲染三件事一次抹平,你就看不到"哪一层坏了";先用原生的方式写一遍,再换 SDK 才知道它在替你做掉什么(10.5 有一张对照表)。
Vue 用户同样适用:状态机、分帧器、增量解析都是框架无关的,只有组件写法要换。
🔗 和其他课的衔接
📐 一门课的边界
| 讲 | 不讲 |
|---|
| 浏览器怎么接收与解析流 | 服务端怎么实现 SSE(FastAPI 课已讲) |
| 消息模型、状态机、持久化 | Prompt 设计与模型效果调优 |
| Markdown 增量渲染、引用、工具卡片 | 设计系统与主题体系 |
| 停止、重试、超时、成本展示 | 计费系统与账务对账 |
判断标准:只要问题发生在"浏览器里",就在这门课范围内。