README.md

从零构造可上线的 RAG 系统

这不是把几个框架拼起来的演示，而是一套逐步可运行、可验证、可替换的 RAG 工程连载。

每一期只解决一个核心问题，并提供代码、验收方法和常见故障排查。最终会得到一个支持文档导入、向量检索、引用回答、质量评测和持续更新的知识库服务。

系列路线

期数	主题	产物	状态
01	整体架构与项目骨架	Qdrant 服务、Python 环境、健康检查	已发布
02	Docker 部署 Qdrant	持久化、端口、安全边界	待发布
03	Python 连接 Qdrant	Collection、Point、Payload、相似度查询	待发布
04	文档解析与清洗	PDF/Markdown/TXT 统一数据结构	待发布
05	Chunk 切分策略	固定长度、重叠、结构化切分	待发布
06	Embedding 与批量入库	向量生成、批处理、幂等更新	待发布
07	检索与元数据过滤	Top-K、阈值、Filter	待发布
08	混合检索与重排	Dense + Sparse + Reranker	待发布
09	带引用的回答链路	Prompt、上下文、来源引用	待发布
10	评测、监控与上线	检索评测、接口、日志、Docker 化	待发布

最终架构

文件 -> 解析/清洗 -> Chunk -> Embedding -> Qdrant
                                            |
用户问题 -> Query Embedding -> 检索/过滤 -> 重排 -> LLM -> 答案+引用

设计原则

1. 每个模块都能单独运行和测试。
2. 原始文档、切分结果和向量记录使用稳定 ID，支持重复执行。
3. 检索质量和生成质量分开评测。
4. 示例默认本地开发；生产部署必须增加鉴权、TLS、备份和监控。

如果这个系列对你有帮助，欢迎 Star 仓库并通过 Issue 提交希望优先讲解的模块。