南珂丶一梦

摘要： 系列第 2 篇。P0 在命令行把 RAG 链路跑通了，但 CLI 没法给同事演示。这篇给 RAG 套上 Web 外壳： 用 FastAPI 把「建库 / 上传文档 / 流式对话带引用」暴露成 HTTP 接口，用 Next.js 做一个能上传、能对话、能看引用的页面。 全文分 6 章（目标 → 后端 → 前端 → 联调 → 跑起来 → 选型复盘），标注 24 个真实踩过的坑和解决方案， 重点包括：CORS 不能用 *、OpenAILike 绕过模型名枚举、SSE 必须关缓存头、EventSource 不能 POST、 思考模型 reasoning 走 raw.delta、切换 embedding 模型后维度不一致必须重建索引、NEXT_PUBLIC_ 前缀、SSE 分片截断、Private Network Access 等。 技术栈：Python + FastAPI + LlamaIndex + Chroma + Next.js 15 + React 19。 阅读全文