从改示例开始,不要直接改生产项目。 以RAG为例,先回答解析的数据从哪来、切分由谁触发、引用留下什么记录。
文档切分、向量检索、引用和回答。适合有内部知识库的问答;不适合没有文档治理和权限控制的场景。
形态与技术栈:向量库、Embedding、LLM。主要模块:解析、切分、向量化、检索、重排、回答、引用。
从“看懂”到“会改”,先改示例,不要直接改生产项目。RAG 可以从一个参数、一个样式或一条数据开始。
改之前先备份或提交版本;改之后对比输出,确认只变了你想变的部分。没有版本控制,就不要做“大改”。
练习分三层:改输出、加一个输入、换一个数据源。每层保留可回退的版本,别一次把三层混在一起。
验收看 召回率、引用准确、首字延迟、越权拦截;改动前后各跑一次,记录差异。失败先回退到上一个能跑的版本,再定位。
按顺序跑一遍
把学习路径按 解析 → 切分 → 向量化 走一遍。第一站看概念解决什么问题,第二站跑一个最小例子,第三站自己改一个输入;最后在 引用 留一条可复跑的记录。节点之间对不上,先回到上一节,不要硬往下学。
这条路径里,最容易被跳过的是 切分 的动手练习和 向量化 的输出核对;跳过这两步,后面只能靠背答案。
容易翻车的地方
- 切分碎
- 召回差
- 引用错
- 越权
练习前先演练
假设你已经跑通一个最小例子,现在要判断能不能独立完成。先不要看答案。第一步,在 解析 里用自己的话复述概念;第二步,在 切分 里改一个输入,观察输出变化;第三步,在 向量化 里故意写错一次,看报错能不能定位。
这个场景的重点不是学得多,而是 召回率、引用准确、首字延迟、越权拦截 有没有可复现的记录。只靠“看懂了”判断,换一个例子就说不清是概念、环境还是输入的问题。
复跑时重点看 召回率、引用准确、首字延迟、越权拦截:只要有一项只能靠截图证明,就先补笔记和练习记录,不要进入下一节。RAG 的问题通常不在内容少,而在概念、练习和排错三处没有留下可复核的记录。
最后留一个检查:把这次 解析 到 引用 的路径写成十行以内的操作记录,隔一天自己按记录复跑一次。如果能在不看原文的情况下走通,说明概念和例子都够清楚;如果走不通,先补记录,不要急着学下一章。
把结果记下来
- 版本/笔记:记录资料版本、环境版本和笔记位置。
- 练习入口:解析、切分、向量化 各一个可跑例子。
- 核心流程:从输入到输出,写清每一步做了什么、结果是什么。
- 指标:召回率、引用准确、首字延迟、越权拦截 各记一次练习结果。
- 卡点:报错原文、解决过程、下次怎么避免。
- 复习:隔天、隔周各复跑一次,记录是否独立完成。
练习前先问自己
- 这次练习的目标是什么?
- 环境能不能重复建起来?
- 例子能不能不看原文独立跑通?
- 报错能不能定位到具体一层?
- 下一步练什么,什么时候复习?
学习记录按 解析、切分、引用 三块列:学了什么、怎么练、卡在哪。每项要能指到真实例子或报错;RAG 后面复习、换环境和加难度,都靠这张记录减少重复。
权限和数据
文档分级、权限、注入、输出审核。上线前把这几项写成检查项,不要等出事再补。
最后一遍检查
- 路径:解析、切分和向量化各跑一个最小例子。
- 环境:版本、依赖和安装来源记下来,换电脑能重建。
- 笔记:命令/配置、报错/解决、自己的理解各留一条。
- 安全:练习环境和真实环境分开,凭据、域名和客户数据不混用。
- 版本:代码和笔记有版本控制,改坏能回退。
- 数据:示例数据可重置,不把真实数据留在练习目录。
- 指标:召回率、引用准确、首字延迟、越权拦截 各记一个基线。
- 兼容:目标浏览器、设备或系统版本各测一次。
- 排错:保留完整报错、版本号和最近改动,能复现。
- 记录:复习时间、卡点和下一步写进笔记。
这次不做什么
RAG 的效果一半在文档。切分要保留标题和上下文,检索要能过滤权限;回答必须带引用,不能把相似内容当答案。
RAG 的这次二次开发,先解决入口、权限和数据里的一个具体问题,不要顺手改支付、会员和服务器底层。范围越小,回滚越快;范围写清楚,后面才好判断值不值得继续投入。
参考
参考:https://developer.mozilla.org/zh-CN/docs/Web;https://git-scm.com/doc;https://code.visualstudio.com/docs。
再核对一次:长上下文、关键词检索、人工客服 之间的差异不只是界面。许可证、数据迁移和升级成本要一起看,否则换一套源码可能比改现有系统更贵。
把 召回率、引用准确、首字延迟、越权拦截 写成可复现的记录:什么时候测、用什么数据、结果多少。没有记录,下次出问题只能凭感觉。
这次的范围只围绕 RAG 的二次开发,不顺手改支付、会员和服务器底层;范围越清楚,回滚越容易。

