性能问题先量再改,没有基线的优化只是感觉。 放到AI应用/知识库上,先看文档解析和切分怎么接,不要从整站功能清单开始。
把大模型、知识库、检索和业务表单组合起来的应用源码。适合有明确业务问答和内容沉淀的场景;不适合没有数据权限和评测方案就上线的项目。
形态与技术栈:Python/Node、向量库、LLM API、对象存储。主要模块:文档解析、切分、向量化、检索、回答、引用、权限。
先定指标:回答命中率、引用准确、首字延迟、越权拦截。没有基线,不要谈优化。
AI应用/知识库 的瓶颈通常在三处:入口/路由、数据查询、模板/渲染或工具自身索引。先用日志和耗时拆开,再改。
- 单请求看总耗时和首字节。
- 低并发逐步加,记录 5xx 和资源水位。
- 把慢查询/慢调用单独列出来。
- 改一项、复测一项,不要一次改五处。
优化后要看长尾和错误率,不要只看平均值;性能改动同样要能回滚。
从入口到结果
把主线按 文档解析 → 切分 → 向量化 走一遍。第一站看数据从哪来,第二站看谁有权改,第三站看结果写到哪;最后在 权限 留一条能查的记录。节点之间对不上,先停下来补接口,不要继续加功能。
这条主线里,最容易被跳过的是 切分 的权限和 向量化 的结果校验;跳过这两步,后面只能靠人工补。
常见故障点
- 切分不当
- 答非所问
- 引用缺失
- 数据越权
一次小步验证
假设你已经在测试环境跑通了 AI应用/知识库,现在要决定是否上线。先不要全量。第一步,在 文档解析 里用一条真实数据走完整流程,记录输入、输出和耗时;第二步,在 切分 里改一个错误输入、断开一个依赖或收回一项权限,看错误提示和日志能不能对上;第三步,在 向量化 里核对结果,确认没有重复写入、没有越权、没有残留临时文件。
这个场景的重点不是功能多,而是 回答命中率、引用准确、首字延迟、越权拦截 这几项有没有可复现的记录。只靠“看起来正常”判断,上线后一出问题就说不清是数据、权限还是代码。
复跑时重点看 回答命中率、引用准确、首字延迟、越权拦截:只要有一项只能靠截图证明,就先补日志和检查项,不要直接全量。AI应用/知识库 的问题通常不在功能少,而在入口、权限和数据三处没有留下可复核的记录。
最后留一个检查:把这次 文档解析 到 权限 的流程写成十行以内的操作记录,交给没有参与的人按记录复跑一次。对方如果能在不追问你的情况下走通,说明入口、权限和文档都够清楚;如果走不通,先补记录,不要急着加功能。
验收记录怎么写
- 版本/提交:记录实际部署的版本号或压缩包名。
- 测试入口:文档解析、切分、向量化 各一条 URL/命令。
- 核心流程:从入口到结果,写清每一步的输入、输出和状态码。
- 指标:回答命中率、引用准确、首字延迟、越权拦截 各记一个基线值。
- 异常:失败时的提示、日志位置、影响范围和恢复时间。
- 回滚:备份路径、恢复命令、验证人。
五个判断
- 这次是试用、灰度还是正式全量?
- 上线后谁负责日常维护和故障响应?
- 授权/许可证是否覆盖当前用法和二次分发?
- 核心数据能否导出,换系统时能不能带走?
- 出现严重故障时,多长时间能恢复到可用状态?
交接表按 文档解析、切分、权限 三块列:改什么、为什么改、怎么退。每项要能指到真实路径或字段;AI应用/知识库 后面升级、迁移和换人,都靠这张表减少来回确认。
先守住的边界
数据分级、提示词注入、输出审核、调用日志。上线前把这几项写成检查项,不要等出事再补。
交付前逐项看
- 功能:文档解析、切分和向量化各走一次,不只点首页。
- 授权:许可证、使用范围、二次分发和去版权限制写清楚,商用与自用分开。
- 数据:核心数据有导出,最近记录能按 ID、时间和状态对上。
- 权限:管理入口、上传目录和配置文件分开;生产用最小权限。
- 性能:回答命中率、引用准确、首字延迟、越权拦截有基线,峰值不抖。
- 安全:数据分级、提示词注入、输出审核、调用日志逐项核过。
- 备份:文件、数据库/配置和密钥各一份,至少一次恢复演练。
- 兼容:目标浏览器、设备或系统版本各测一次。
- 日志:入口、应用和数据日志按同一时间对齐。
- 记录:版本、路径、验证时间、回滚方式写进交付记录。
适用范围
AI 应用不要先追求“能聊”。先定知识边界、引用来源和越权拦截;没有评测集,回答听起来顺但不一定对。
AI应用/知识库 的这次性能,先解决入口、权限和数据里的一个具体问题,不要顺手改支付、会员和服务器底层。范围越小,回滚越快;范围写清楚,后面才好判断值不值得继续投入。
参考
参考:https://opensource.org/licenses;https://owasp.org/www-project-top-ten/。
再核对一次:Dify、FastGPT、自研 RAG 之间的差异不只是界面。许可证、数据迁移和升级成本要一起看,否则换一套源码可能比改现有系统更贵。

