V4.17.0

升级说明

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

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

V4.17.0 会先阻塞启动并迁移旧版系统模型配置，迁移完成后才开放业务服务；随后在后台依次回填模型权限，以及 Dataset、评测、App、App 版本和 App 模板中的模型引用。无法匹配当前模型目录的悬空模型权限会被清理。非阻塞任务失败不会中断业务服务，可在 管理员 > 版本升级 中查看失败数据并重试。阻塞任务失败时，App 节点会保持未就绪状态；请根据节点日志修复问题后重启 App 节点。

模型引用迁移默认每批处理 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 的环境中使用。

🚀 新增内容

1. FastGPT SSO Service 新增 LDAP 成员与组织架构同步，并补充不同 SSO Provider 的独立环境变量模板和配置文档。
2. FastGPT SSO Service 新增钉钉用户与部门同步。
3. Workflow Tool 的文件上传字段支持设置为由 Agent 生成；历史文件字段仍默认保持手动上传，避免升级后行为变化。
4. 新增自动系统升级任务管理，可查看升级状态、阶段进度、失败数据和执行结果，并重试失败的非阻塞任务。

⚙️ 优化

1. 优化对话暂停体验：暂停请求写入工作流停止标记后立即返回；客户端收到确认后主动中断当前流式请求，不再等待最多 5 秒。
2. 优化暂停后的内容保留：模型仅输出思考内容、尚未生成正文时暂停，也会持久化已有思考内容，刷新后仍可查看。
3. 优化图片引用展示：图片后仅包含引用标记时，引用标记在图片下方居中显示；正文中的行内引用保持原有布局。
4. 优化生成冲突恢复：当前对话仍在服务端生成时，客户端会识别冲突并恢复原有生成流，避免新增空白消息或错误状态。
5. 优化处理中内容的交互：思考或工具调用的折叠预览支持点击展开，并直接定位到对应详情。

🐛 修复

1. 修复账号注销确认弹窗底部间距、长文本无法正确换行的问题，并优化账号注销邮件模板。
2. 将 DB_MAX_LINK 限制在 10～1000，避免连接数过低影响并发或配置过大造成资源压力；官方部署模板默认使用 20。
3. 修复关闭团队插件安装后，部分上传、URL 安装和安装确认接口仍可绕过功能开关的问题。
4. 修复禁用 XLSX XML 扫描后仍可能继续扫描文件的问题。

🛠️ 代码优化

1. 系统模型、模型权限及业务配置统一使用稳定的 modelId 引用，并通过自动升级任务兼容旧版模型名称引用。
2. 自动升级任务通过 MongoDB lease、运行 ID 隔离和心跳实现多节点互斥与失效接管；大数据任务支持分批断点续跑。