附录A · 速查

📖 动手时开着的那一页。不重讲原理，只给「该选哪个」和「别踩哪个」。

⚠️ 上线前的逐条体检在 16 · 上线前检查单，这里不重复。

🧭 一、决策速查：该选哪个

通道：怎么把生成结果送到浏览器

⚠️ 浏览器端别用 EventSource —— 带不了 Authorization header。用 fetch + ReadableStream（10 章）。

异步：长任务怎么跑

向量存哪

⚠️ 决定性问题不是数据量，是 ⭐ 「向量和业务数据要不要保持一致」（07 章）。

认证

部署

🗓️ 这里不点平台名字——名字每年都在换，要记的是判据（01 章第六节那五条）： 常驻进程 / 单请求超时 ≥ 5 分钟 / 不缓冲响应体 / 能设环境变量 / 自带 HTTPS 域名。 ⚠️ Serverless 默认踩掉前三条，AI 应用上它多半会栽（14 章）。

⚠️ 二、常见陷阱清单（按会咬到你的顺序）

💸 成本类（最贵）

🔒 安全类

⏱ 超时与并发类

🌊 流式类

🗄️ 数据类

📦 部署类

📐 三、AI 应用该看的四个指标

⚠️ 四个都要看 p95/p99，不是平均值。

🔤 四、SSE 帧格式（全板块统一）

data: {"type":"delta","text":"你"}

data: {"type":"delta","text":"好"}

data: {"type":"usage","in":120,"out":8}

data: {"type":"error","message":"upstream timeout","trace_id":"a1b2c3d4e5f6"}

data: {"type":"done"}

⚠️ 每帧后面是空行（\n\n）。⭐ 一开始就分帧，以后加东西（用量、工具状态、错误）不用重写前端。

⭐ 帧类型放在 JSON 负载的 type 里，不用 SSE 的 event: 行 —— 前端是 fetch + ReadableStream 手动解析（EventSource 带不了 Authorization），而 event: 行只对 EventSource 有意义，手动解析器只能多写一套状态机或整行丢掉。放进负载，一行 JSON.parse 拿到全部信息，解析路径只有一条。

⚠️ 两个容易写错的地方：结束帧是 {"type":"done"} 不是 [DONE]（后者不是合法 JSON，会让统一的 JSON.parse 抛 SyntaxError）；错误帧字段名是 message 不是 code（前端拿它是要直接显示给人看的）。⚠️ message 里别塞异常原文（05 · 10）。

⭐⭐ 错误帧必须带 trace_id，这条在流式里最容易漏：非流式出错时 trace_id 在那个 500 的 JSON 里；⚠️ 流式的状态码在第一个字发出去时就定死成 200 了，那个 JSON 根本不会发出来，所以它只能作为错误帧的一个字段送过来，前端也要专门接住并显示。分工是 ⭐ message 给人看（一句人话）、trace_id 给你查（日志里对应完整细节）——03 章立的原则、16 章的验收项，都要靠它在流式这条路上也成立。

🗂 五、哪个概念在哪一章

🔗 六、跨教程速查