文章目录前言一、RAG检索拉胯锅从来不在向量库在切块1. 三个切块参数各司其职缺一不可2. 标准排查顺序先上游后下游二、前端流式打字乱码、缺字不懂buffer必踩坑1. 网络分包根本不按消息边界走2. buffer缓冲区专治半包粘包3. 页面打字效果和DOM无关靠响应式变量三、会议纪要自动化靠固定边界杜绝模型瞎编1. Skill本质是划定全套数据边界2. 固定输出模板消除不确定性四、两个高频翻车工程细节踩一次记一辈子1. 工厂方法不能当成构造函数new调用2. 前端绝对不能存放模型密钥五、万能四层排错框架快速定位AI项目故障收尾P.S. 挖到宝藏AI教程全程通俗易懂风趣幽默零基础轻松入门传送门https://blog.csdn.net/qq_34419312前言很多人以为做AI项目难点是调模型、写Prompt真上手踩坑才懂九成bug都栽在数据分界这件小事上。我日常维护三套AI数据链路RAG知识库、前端流式对话、会议自动纪要踩过的坑凑起来能开个吐槽专场今天掰开揉碎聊聊边界这件事。一、RAG检索拉胯锅从来不在向量库在切块搭知识库流程大家都熟网页抓取文档→文本拆分小块→向量化存入向量库→检索喂给模型。绝大多数人排查顺序完全颠倒上来就调向量检索参数纯属白费功夫。上次新人找我说知识库检索全是无关内容折腾一下午改向量相似度阈值越调越乱。我让他打印拆分后的chunk数组控制台空空如也零个文本块。根源是网页动态渲染没适配抓取器他愣是在下游排查半天相当于水管堵了不去查进水口搁那拧水龙头。1. 三个切块参数各司其职缺一不可constsplitternewRecursiveCharacterTextSplitter({chunkSize:400,chunkOverlap:100,separators:[。,,]})constchunksawaitsplitter.splitDocuments(documents)chunkSize控制单块文本长度块太大杂信息混在一起检索跑偏块太小单条信息残缺回答不全。separators优先按中文句号、感叹号切分不会一句话拦腰斩断比单纯按字符切割人性化太多。之前图省事删掉分隔符纯按400字符硬切一段完整退款流程被劈成两半用户问退款步骤模型只返回前半段后半关键操作直接消失产品拿着截图过来问责我当场反省参数不能乱删。chunkOverlap是相邻块的重叠上下文两块内容共享一小段文字避免语义被切断完美解决分段丢失信息的问题。2. 标准排查顺序先上游后下游固定流程确认网页正常抓取Document文档→打印检查切块结果→最后调试向量检索。控制台出现空数组问题百分百出在抓取、页面渲染、选择器别一头扎进向量库死磕。二、前端流式打字乱码、缺字不懂buffer必踩坑大模型流式返回用SSE协议浏览器拿到的不是规整JSON是一段段二进制字节流这里藏着最多隐形坑。1. 网络分包根本不按消息边界走服务端推送完整JSON消息TCP传输时会随机拆分、合并也就是常说的半包、粘包。同事做对话页面没写缓冲逻辑直接读到数据就JSON.parse用户提问十次有三次回答半截断句比如“你好世界”拆成“你好”和“世界”分两次送达第一次解析直接报错丢弃页面只显示一半文字测试小姐姐反馈界面像断气一样。一次reader.read()读取到的数据既可能是半条消息也可能一次性塞好几条完整消息没有任何规律。2. buffer缓冲区专治半包粘包consttextbufferdecoder.decode(value,{stream:true})constlinestext.split(\n)bufferlines.pop()??核心逻辑特别简单每次读取字节拼接进缓存按换行分割所有完整消息最后一段没有换行代表数据不完整存进buffer等下一轮读取拼接。比起解析失败再缓存按行分割残片的写法稳定很多不会丢失任何一段增量文本。3. 页面打字效果和DOM无关靠响应式变量很多新手误以为模型直接操控页面DOM实际是不断累加delta增量文本更新Vue响应式变量变量变动自动触发页面刷新。三、会议纪要自动化靠固定边界杜绝模型瞎编不少人做纪要功能直接丢整段文稿给模型自由生成结果离谱到离谱凭空编造参会人、乱填截止时间、遗漏关键行动项。业务部门开需求评审会自动纪要凭空加了一条下周上线的任务压根没人提对接人找过来对线我一看Prompt没做字段约束模型爱脑补的老毛病犯了之后直接封装标准化Skill彻底根治。1. Skill本质是划定全套数据边界一套成熟纪要Skill会锁定多层规则过滤口头禅、重复废话只保留有效事实文本区分会议议题、决策内容、待确认观点三类信息行动项缺少负责人、截止时间强制留空禁止模型自行编造2. 固定输出模板消除不确定性处理链路原始会议文稿→降噪提纯事实→按主题归类讨论内容→抽取行动项字段→填充标准化纪要模板。把重复工作固化成流程不用每次依靠模型自由发挥输出内容可控、可校验不会出现幻觉内容。四、两个高频翻车工程细节踩一次记一辈子1. 工厂方法不能当成构造函数new调用写初始化向量库代码顺手写new MemoryVectorStore.fromDocuments控制台抛is not a constructor报错卡了半小时才反应过来fromDocuments是静态工厂方法不是构造器不能new。正确调用方式直接await执行constvectorStoreawaitMemoryVectorStore.fromDocuments(chunks,embeddings)最终写法以对应版本官方API文档为准别凭直觉写代码。2. 前端绝对不能存放模型密钥把API Key用VITE环境变量暴露给Vue前端打包后密钥明文存在浏览器产物里用户抓请求头就能直接窃取安全漏洞巨大。安全链路标准流程Vue前端发起请求→自家后端服务→大模型厂商接口密钥统一托管在后端。之前实习生图省事前端存key上线半天就收到服务商402余额不足报错查到是密钥泄露被恶意调用扣了不少账户余额之后这条规范直接写进项目开发规范。五、万能四层排错框架快速定位AI项目故障不管是检索空白、流式断字、纪要错乱统一按四层顺序排查少走八成弯路输入层网页、请求文本、原始文稿是否正常获取有没有空数据边界层文本切块、SSE换行分割、JSON消息边界是否处理正确转换层字节解码、JSON解析、向量嵌入、接口调用格式是否匹配外部层密钥有效性、账户余额、模型名称、依赖包版本、接口权限优先检查上游原始数据再往下排查先看HTTP状态码再调试业务解析代码避免在错误层级浪费大量时间。收尾RAG知识库、前端流式对话、自动化纪要看着是完全不相关的三类AI功能底层核心逻辑一模一样。所有AI应用稳定性的根源都是把杂乱无章的原始数据切割成边界清晰、可校验、可复用的标准化片段。能吃透切块逻辑、理解buffer缓冲作用、用固定流程约束模型输出才算真正落地生产级AI应用而不只是简单调用模型API。P.S. 挖到宝藏AI教程全程通俗易懂风趣幽默零基础轻松入门传送门https://blog.csdn.net/qq_34419312