V4.17.0

升级说明

升级到 V4.17.0 前，请先升级到 V4.16.x，并执行完成 V4.16.x 版本要求的所有旧升级脚本。 V4.17.0 的自动升级机制只管理从本版本开始登记的新任务，不会补执行此前版本的历史脚本。

从 4.17.0 版本开始，登记到系统升级机制的任务会自动执行，并通过 lease 抢占避免多节点并发问题，同时支持心跳检测，检查脚本是否活跃。可在 管理员 > 版本升级 中查看升级脚本状态。

分批迁移任务默认每批处理 100 条记录。数据量较大时，可通过 SYSTEM_MIGRATION_BATCH_SIZE 调整为 50～1000。

Code Sandbox seccomp 兼容配置（可选）

Code Sandbox 默认继续启用 seccomp。若宿主机内核不支持应用内 seccomp，进程池初始化会失败；确认可以接受系统调用隔离能力降低后，可为 Code Sandbox 显式设置：

SANDBOX_DISABLE_SECCOMP=true

该配置只关闭 seccomp，chroot、no_new_privs 和 UID/GID 降权仍保持启用。关闭后不再从内核层阻断网络、创建进程、线程和执行二进制等系统调用，不建议在支持 seccomp 的环境中使用。

🚀 新增内容

FastGPT SSO Service 新增 LDAP 成员与组织架构同步，并补充不同 SSO Provider 的独立环境变量模板和配置文档。
FastGPT SSO Service 新增钉钉用户与部门同步。
Workflow Tool 的文件上传字段支持设置为由 Agent 生成；历史文件字段仍默认保持手动上传，避免升级后行为变化。
新增自动系统升级任务管理，可查看升级状态、阶段进度、失败数据和执行结果，并重试失败的非阻塞任务。
Agent V2 新增语音播报（TTS）配置，支持关闭播报、浏览器播报或模型播报，并可选择音色、调整语速和试听；配置样式与 Chat Agent 保持一致。

⚙️ 优化

优化对话暂停体验：暂停请求写入工作流停止标记后立即返回；客户端收到确认后主动中断当前流式请求，不再等待最多 5 秒。
优化暂停后的内容保留：模型仅输出思考内容、尚未生成正文时暂停，也会持久化已有思考内容，刷新后仍可查看。
优化图片引用展示：图片后仅包含引用标记时，引用标记在图片下方居中显示；正文中的行内引用保持原有布局。
优化生成冲突恢复：当前对话仍在服务端生成时，客户端会识别冲突并恢复原有生成流，避免新增空白消息或错误状态。
优化处理中内容的交互：思考或工具调用的折叠预览支持点击展开，并直接定位到对应详情。
统一工作台 App、Skill、Dataset、模板市场、工具、账号用量、模型看板、API Key、审计日志和 App 日志等列表的筛选交互；按页面提供类型、来源、创建者、成员、分类、时间和排序等筛选，并支持在长选项列表中搜索。
App、Skill 和 Dataset 列表新增按创建者与创建时间排序等筛选能力；历史 App 和 Dataset 创建时间由系统升级任务自动补齐。
统一表格多选、日期范围、数字输入、长列表滚动和弹窗等基础交互，改善批量操作和长内容展示体验。

🐛 修复

修复账号注销确认弹窗底部间距、长文本无法正确换行的问题，并优化账号注销邮件模板。
将 DB_MAX_LINK 限制在 10～1000，避免连接数过低影响并发或配置过大造成资源压力；官方部署模板默认使用 20。
修复关闭团队插件安装后，部分上传、URL 安装和安装确认接口仍可绕过功能开关的问题。
修复禁用 XLSX XML 扫描后仍可能继续扫描文件的问题。
修复 HTTP/OpenAPI Tool 输入项的「手动输入 / Agent 生成」模式保存后丢失，以及作为 Agent Tool 或子工作流运行时被错误重置的问题。
修复模型选择未严格区分模型类型、模型最高温度留空时校验失败，以及管理员模型目录与成员可用模型列表排序不一致的问题；同时避免服务启动阶段误清理仍然有效的成员模型缓存。
FastGPT Pro 将飞书、企业微信、钉钉和微信公众号等发布渠道收到的非法消息调整为返回明确的客户端错误，避免将请求格式问题误报为服务端故障。
FastGPT Pro 修复历史团队成员 role 字段可能覆盖当前权限计算的问题：除团队所有者外，废弃的角色值不再参与权限判断。
修复简易应用和对话 Agent 的隐藏多模态配置导致图片、音频或视频未进入模型请求的问题；工作流中有显式多模态开关的模型切换入口统一清除新模型不支持的选项，切回后不会自动恢复。
修复模型请求字段映射在同名、交换或链式映射时覆盖错误的问题；映射使用已归一化并按模型能力过滤的请求数据，重复目标字段会明确报错。
修复 MCP / HTTP Tool 定义随工作流快照过期或存储不兼容的问题，运行时读取工具定义，并兼容历史工具配置和鉴权信息。
修复 OpenAPI 导入工具未按接口定义发送参数的问题：根据原文将参数分配到 Path、Query、Header 和 JSON Body，支持路径级共享参数，并按 style / explode 序列化数组和浅对象，保留重复 Query 参数名及 JSON Body 中的原始数据类型。
修复 OpenAPI 定义中未传入的可选 Cookie 参数阻断请求的问题；必填参数缺失、实际传入但不支持的 Cookie 或不支持的参数编码仍会明确报错。
修复 ToolCall 统一关闭子工作流流式输出、导致子节点配置不生效的问题；子工作流继承父流程流式能力，并遵循自身禁流配置，简易应用生成的子应用和工作流工具节点仍强制禁流。

🛠️ 代码优化

系统模型、模型权限及业务配置统一使用稳定的 modelId 引用，并通过自动升级任务兼容旧版模型名称引用。
自动升级任务通过 MongoDB lease、运行 ID 隔离和心跳实现多节点互斥与失效接管；大数据任务支持分批断点续跑。
协作者查询接口可按需返回团队成员登录用户名，并通过批量查询避免逐成员请求。
FastGPT Pro 优化集群镜像构建缓存，使用代理缓存和带缓存的 Runner 降低重复拉取与构建开销。
修复部署脚本的访问地址与宿主机端口配置混淆问题，支持独立配置 FastGPT 和 Sandbox Proxy 的宿主机端口，避免误用反向代理的公网端口。