做 RAG 应用检索质量决定上限。整理了快速开发实战中六个见效最快的优化点https://pan.quark.cn/s/4b129497e7841. 清洗优先于切分页眉页脚、目录页、乱码不清洗后面全白搭2. 元数据带上章节标题、页码存进 metadata过滤和展示都靠它3. query 改写用户口语化提问先改写成检索友好形式多路查询效果更稳4. top-k 不是越大越好k 太大会引入噪音5~8 配 rerank 是常见甜点区5. 引用溯源回答里带出处既方便核对也能压幻觉6. 建立bad case闭环线上坏例回流到评测集持续迭代。课程从零到一搭生产级 RAG代码结构和踩坑记录都比较实在适合想快速上线的团队参考。