FastGPT V4.8.13版本升级操作与环境变量变更说明

版本核心变更概述

本次V4.8.13版本核心变更为环境变量调整，同时包含多项功能新增、优化与修复。新增功能包括：数组变量支持多选，可按选择顺序合并多个数组或对应单一数据类型；AI对话与工具调用节点直接支持接收文件链接，插件自定义变量支持文件上传类型；对话记录新增时间显示；工作流校验错误时自动跳转至错误节点；循环节点新增下标值；部分对话错误提醒支持翻译；对话输入框支持拖拽文件上传；对话日志来源可显示分享链接或API具体名称；分享链接支持配置是否展示实时运行状态。优化内容涵盖合并多个system提示词为单条、优化知识库上传文件报错提示、减少全文检索子查询次数、适配旧版浏览器的findLast方法修改、Markdown组件自动空格优化、工作流上下文拆分提升性能、语音播报兼容处理、csv读取自动识别编码等。修复问题包括Dockerfile中pnpm安装支持代理、BI图表生成无法写入文件且优化解析支持数字类型数组、分享链接首次加载标题显示不正确等。

升级操作步骤

请按照以下流程完成版本升级：

提前做好数据备份
更新镜像：将FastGPT官方镜像tag设置为v4.8.13-fix，商业版（fastgpt-pro）镜像同样使用该tag；Sandbox镜像无需更新
添加环境变量：为fastgpt和fastgpt-pro镜像添加环境变量FE_DOMAIN=http://xx.com，变量值为FastGPT前端访问地址，注意末尾不要添加/，该变量可自动补齐相对文件地址的前缀
调整文件上传编排：当前版本仍兼容旧版编排，但未来两个版本将移除兼容代码，需尽快调整。尤其嵌套应用的文件传递，未来将不再自动传递，必须手动指定传递的文件，具体可参考官方文件上传变更说明

使用注意事项

使用本版本时需注意以下边界与易错点：首先，FE_DOMAIN环境变量的格式要求严格，末尾不可添加斜杠，否则可能导致文件地址前缀补齐异常。其次，旧版文件上传编排的兼容期仅剩两个版本，逾期未调整将出现功能异常，尤其是嵌套应用的文件传递需手动配置，无法依赖自动传递逻辑。另外，新增的数组变量多选功能仅支持选择多个数组或对应单一数据类型，不符合格式的选择将无法正常合并；循环节点的下标值需在对应工作流节点中调用，无法直接全局使用。最后，本次修复的问题仅针对对应场景，例如Dockerfile的pnpm代理支持仅影响自建镜像编译流程，不影响已部署的容器运行。