这个版本改了什么
本次版本新增多项功能与优化项。新增功能包括：弃用/已删除的插件提示；对话日志按来源分类、标题检索、导出功能；全局变量支持拖拽排序；LLM模型支持topp、responseformat、json_schema参数；Doubao1.5模型预设、阿里embedding3预设；向量模型支持归一化配置；AI对话节点支持输出思考过程结果供其他节点引用。优化内容包括：网站嵌入式聊天窗口增加窗口位置适配；模型未配置时错误提示优化；适配非Stream模式思考输出；增加TTS voice未配置时的空指针保护；Markdown链接解析分割规则改为严格匹配模式；减少未登录用户的数据获取范围。修复问题包括：简易模式切换至非视觉模型时强制关闭图片识别的问题；o1、o3模型测试时字段映射未生效导致报错的问题；公众号对话空指针异常；多个音频/视频文件展示异常；分享链接鉴权报错后无限循环的问题。
升级前要确认的事
升级前必须完成数据库备份，确保系统数据安全，避免升级过程中出现数据丢失。
升级步骤（照做）
- 完成数据库备份。
- 更新镜像：将fastgpt镜像tag设置为v4.8.21-fix；将fastgpt-pro商业版镜像tag设置为v4.8.21-fix；Sandbox镜像无需更新。
升级后怎么验证
可通过以下场景验证升级效果：检查插件模块是否展示弃用/已删除插件提示；确认对话日志支持按来源分类、标题检索与导出；全局变量可通过拖拽调整排序顺序；配置LLM模型时可设置topp、responseformat、json_schema参数；向量模型配置页出现归一化配置选项；AI对话节点支持输出思考过程结果供其他节点引用；嵌入式聊天窗口可适配不同位置；未配置模型时弹出优化后的错误提示；测试非Stream模式思考输出正常；未配置TTS voice时无空指针异常；Markdown链接解析采用严格匹配规则；未登录用户数据获取范围缩小；切换简易模式至非视觉模型时图片识别正常关闭；测试o1、o3模型无字段映射报错；公众号对话无空指针异常；多音频/视频文件展示正常；分享链接鉴权报错后不会无限循环。
来源： FastGPT 官方来源
适用性与版本范围
本页适用于官方来源记录的 部署与升级 场景。执行变更前，需核对 FastGPT、依赖、API 与部署版本。
安全护栏
凭证与私密数据使用 [REDACTED_CREDENTIAL] 占位符。执行操作前需核对文档的环境与版本。
回滚指引
恢复变更前的技术内容权威快照、已保存配置与数据快照，再执行最小验证场景。