FastGPT v4.17.2 发布:知识库训练链路重构与索引状态管理
FastGPT v4.17.2 于 2026 年 10 月 9 日发布,升级 fastgpt-app 与 fastgpt-pro 镜像至 v4.17.2。本次更新重构知识库数据落库与训练链路,引入 parsed→indexing→indexed 三态索引状态,并新增两个需手动触发的数据迁移脚本。此外还优化了控制台 CSR 迁移、任务队列失败保留策略,并修复工作流条件判断器、Markdown 图片解析等多处问题。
升级方式
需要将 fastgpt-app(主服务)与 fastgpt-pro(商业版)镜像 tag 更新为 v4.17.2。
本次升级附两个手动触发脚本,可在「管理员 > 版本升级」中查看与执行,均不阻塞服务启动:
- 20261008_migrate_chunk_training:将存量旧版 chunk 训练任务转换为关联正式数据行的新模式。须确认所有旧版本 App 与 Pro 实例已停止、旧任务租约过期后再执行。
- 20261009_migrate_dataset_rebuild_status:依赖上一个脚本完成,将历史数据行中旧版
rebuilding标记与过渡状态迁移到新的indexStatus体系。
知识库训练链路变化
- 解析分块、图片导入、备份或模板导入在解析完成后即落库为可见数据行,全流程绑定唯一
dataId;训练完成后向量与索引写回同一条数据,避免长训练周期无数据和孤儿数据。 - 数据索引新增三态流转(
parsed→indexing→indexed),待索引数据不被检索召回,前端只读,后端拦截编辑、删除及改索引操作;训练失败的数据可直接编辑或删除。 - QA 拆分一对多时源数据复用为首条拆分项,其余叶子节点新建预落库数据,入队、写入与源任务清理在同一数据库事务内完成。
- 模型切换与同义词重建仅对
indexed数据触发;同义词重建复用未变更的向量数据。 - 训练弹窗可按处理模式分类查看阶段进度。
其他新增与优化
知识库与文件列表搜索可限定在当前目录及其子树,根目录下仍检索全量内容,底层含成环与深度/节点数截断保护。控制台、账号中心、管理后台与定价页迁移为客户端渲染并启用浅路由;语言包合并为单一 chunk 预加载。BullMQ 后台任务失败保留策略由按时间过期改为保留最新 10,000 条,重试改为 5000ms 指数退避。模型探测达到最大重试次数后错误信息附带模型名;修复数字单位进位(如进位到 1 亿、1M);检索融合去重结合 imageId 保留不同图片;filename* 编码损坏时回退到常规 filename。
修复项
- 条件判断器 If/Else 的「包含/不包含」与「正则」条件对非字符串值处理异常,现先转字符串匹配;空正则判定为不匹配。
- 无 License 时管理员菜单通过路由白名单过滤,避免未授权子项暴露。
- 系统工具「从插件市场安装」恢复正确路由
/config/tool/marketplace。 - 知识库列表滚动翻页重复加载;成员同步回填离职兜底信息。
- 聊天引导词计数接口补全应用读权限校验;隐藏应用同团队普通成员不再默认拥有聊天日志权限。
- Markdown 图片语法遵循 CommonMark 分离 destination 与 title;分页参数在省略 pageSize 时保留 offset 与 pageNum。
来源与核对说明
- labring/fastgpt ↗https://github.com/labring/FastGPT/releases/tag/v4.17.2
本文经 AI 整理及独立自动校对,未做运行验证;自动校对仍可能遗漏问题,请以原始资料为准。
这篇内容对你有帮助吗?
点赞人数由服务器记录,收藏保存在当前浏览器。
继续阅读
Tutti v0.2.31-rc.4 预发布:README 突出 Tutti VM →
Logfire v5.1.1 修复无组织账户的项目初始化与 HTTP 连接保活 →