V4.17.3

升级指南

镜像更新

• AIproxy: v0.7.5
• 代码运行沙盒（fastgpt-code-sandbox）：v4.17.0，修正原 v4.17.2 标签无法拉取的问题。

升级脚本

本次升级无新增系统升级脚本，更新镜像并重启服务即可。

历史任务「回填应用资源快照」（20260916_backfill_app_resource_snapshots）新增前置依赖「迁移应用模型引用」（20260903_backfill_app_model_references）。若尚未完成这些历史任务，需先完成模型引用迁移，再执行资源快照回填，确保快照中的模型 ID 完整。

配置与接口兼容说明

• Agent 沙盒活跃实例总上限通过 AGENT_SANDBOX_MAX 配置，默认 100，应用会话与技能编辑共用额度。可通过 AGENT_SANDBOX_MAX_PER_TEAM 设置单团队上限，默认不限制。商业版可通过管理台系统配置这两个参数，并且优先级高于环境变量。
• 通用分页接口的 pageSize 超过 500 时自动按 500 处理，不再因超出该上限报错；部分业务接口仍保留更小的限制。
• OpenSandbox 新增 AGENT_SANDBOX_CPU_OVERCOMMIT_FACTOR 与 AGENT_SANDBOX_MEMORY_OVERCOMMIT_FACTOR，默认均为 1，取值须不小于 1。仅在 Kubernetes 运行态且 OpenSandbox Server 不低于 v0.2.1 时生效，按倍率降低资源预留，资源上限保持不变。修改后仅对后续新建或重建的沙盒生效，连接或恢复已有沙盒不会重新应用配置。
• 知识库批量导出接口 /api/core/dataset/exportAll 改为仅导出单个知识库，不再支持按目录整体导出；开启文件级权限时仅导出当前成员可读的文件，需适配分别请求各知识库。

🚀 新增内容

1. 商业版新增工作流辅助生成，支持通过自然语言创建或修改工作流。确认流程方案后生成候选版本，手动应用到画布并自动排版；应用后仍需检查、调试并手动保存和发布。使用时需具有应用编辑权限，并由管理员启用辅助生成与虚拟机（沙盒）能力。
2. Markdown 组件支持有限 HTML 渲染，同时优化各个组件的交互。
3. 应用对话支持按成员、应用和会话缓存输入草稿，切换会话或刷新页面后可恢复文字与已上传成功的附件引用。草稿仅保存在当前浏览器标签页，最多保留 10 份，自最后一次编辑起保留 1 小时，消息发送被正式受理后清除。
4. 创建应用、工具及知识库文件夹时支持选择是否继承父级权限。
5. 支持团队成员配置专属 AI 模型与渠道，完善多租户/成员级模型资源隔离与鉴权，并深度集成 AI Proxy。
6. 支持配置 Agent 沙盒活跃实例的系统总上限与单团队上限。
7. MCP 应用工具调用与外部渠道消息统一接入团队对话 QPM（每分钟请求数）限制，超限时返回具体额度与重试等待时间；外部渠道消息在去重后计数，避免平台重试重复消耗额度。
8. 工作流用户选择节点及表单输入中的单选、多选字段支持通过变量引用动态生成选项；动态选项为空时返回明确错误。
9. 系统插件支持名称、简介、工具集子工具、输入输出参数、密钥 Schema 及 README 的多语言展示；已有工作流节点和 Agent 固定工具保留添加时的文案语言快照。
10. OpenSandbox Kubernetes 运行态支持独立设置 CPU 与内存超卖倍率，在保持资源上限的同时降低调度预留。
11. 团队审计日志新增知识库及文件级失败训练任务批量重试、单任务重试、训练记录删除，以及切换索引模型重建索引的操作记录，支持按事件类型筛选；索引重建日志同时保留模型名称与稳定 ID，便于追溯。
12. 商业版管理台用户列表新增「全部、活跃、禁用、注销」状态筛选，默认查询活跃用户，可与用户名搜索组合使用；「注销」按当前及历史匿名用户名格式识别，仅用于筛选与展示，不改变账号实际状态。

⚙️ 优化

1. 优化工作流外部文件链接类型识别：无文件名或后缀的链接支持通过响应头与有限内容探测识别文件类型，统一 AI 对话、Agent、工具调用和文档读取的分类结果，并复用识别出的文件名进行文档解析。
2. 优化 API 文件库同步：先完成远端目录树拉取和结构差量校验，再批量补建目录、更新名称与父级，保持权限继承一致；远端请求因限流、网络或服务异常失败时中止本轮同步，避免将请求失败误判为文件删除。
3. 模型请求日志与请求记录统一清理图片、音频等 base64 内容，并保留错误名称、消息与原因；面向团队成员的请求记录不保存服务端调用栈，个人 OpenAI Key 的空响应提示也不再附带完整请求内容。
4. 优化模型原生工具调用流的兼容处理，修复并行调用参数混淆、参数先于名称到达或名称重复下发导致的解析异常，并兼容工具名的 functions. 前缀与空参数。模型以工具调用状态结束但未返回有效工具时，明确返回错误，避免误判为正常结束。
5. 系统初始化接口按登录状态过滤公开配置，模型渠道元数据与沙盒连接信息改为按需获取；登录、退出或切换账号后刷新配置，避免复用旧会话缓存。
6. 优化应用、技能、知识库及工具卡片的统一内边距与间距排版，提升视觉一致性。
7. 技能管理控制台补充关联应用标签展示与权限元数据对齐。
8. 模型请求被用户取消或探活流程中断时，日志级别调整为警告，避免计入模型服务错误；使用个人 OpenAI Key 时不再将此类中断误报为 Key 错误。
9. 系统升级任务的前置依赖未完成时，提示需先完成的具体任务名称，并按当前界面语言展示，便于按顺序执行或重试。
10. 团队成员管理中的「用户名」标签调整为「成员名」，明确其与登录账号的区别。
11. 统一通用分页参数校验，模型渠道调用日志支持每页最多 500 条。
12. 团队对话限流在配置读取或 Redis 服务运行异常时记录日志并跳过检查，避免限流服务故障阻断对话。
13. MCP 工具调用失败时在响应的文本内容中返回错误详情，便于客户端展示限流等具体原因。
14. 知识库列表接口 listV2 支持通过 withFileCount 按需返回 fileCount，统计库内所有层级的非目录集合数量，文件夹项不返回该字段。
15. 对话页支持通过 /chat?pane=aa&tab=ta 直接打开团队应用，切换页签时同步更新 URL，刷新或分享后保持当前页签。
16. 统一工作流节点尺寸与画布布局，问题分类节点的默认分类文案随当前界面语言展示。
17. 优化 Mermaid 流式渲染及流程图预览的缩放、拖拽与触控交互。
18. 工作流引用已删除或未包含在应用资源快照中的知识库时，将预期的资源缺失日志调整为警告，减少无效错误告警。
19. Mermaid 图包含换行标签时，自动适配。
20. 应用提示词编辑器补充输入指引及系统变量与应用自定义变量选择器。
21. 简易应用与 Agent 的知识库标签过滤移入搜索参数弹窗，统一条件编辑、变量选择与启用状态概览；切换知识库时自动清除无效自定义标签条件，工作流标签过滤在手动输入关闭时保留已配置条件。
22. 简化对话加载动画与沙盒状态文案，优化思考过程、工具及技能详情的折叠、滚动与标题吸顶交互；模型名称溢出时支持悬停查看完整内容。
23. 工作流辅助生成应用候选版本时，未配置凭据的工具默认关联可用系统密钥，无系统密钥的工具保持待激活状态。
24. 优化 API 文件库服务地址校验：缺少协议时兼容历史裸域名配置并默认补全 https://，表单补充完整 HTTP(S) 地址校验提示。
25. HTTP 请求节点收到非 2xx 响应时，将 error.data 数据也推送到错误消息里，便于排查。

🐛 修复

1. 修复 SeekDB 容器重启或重建时数据丢失的问题。
2. 修复定价页面计费周期开关（月付/年付）选中状态背景色异常的问题。
3. 修复 MCP 工具输入 Schema 存在递归循环引用（如 { $ref: '#' }）时导致 JSON 序列化报错的问题。
4. 修复 InvokeProcessor session getter 自递归导致调用栈溢出（Maximum call stack size exceeded）报错的问题。
5. 修复批量创建 Agent 团队成员时因无序并发导致插入异常的问题。
6. 修复 NextAPI 代理 Pro API 流式或无 Content-Type 响应（如微信登录回调）时，因未等待流结束而追加默认 JSON 包裹导致响应损坏的问题。
7. 修复复制 Agent、转换新建应用等入口可绕过创建上限的问题，并统一 Agent 创建额度、License 上限与账号资源用量的统计口径。
8. 修复 Agent 调用系统工具时使用应用所有者身份生成调用凭证的问题，改为使用实际运行成员身份，确保工具获取的用户信息正确。
9. 修复文件上传大小与数量限制在前后端口径不一致的问题，统一按团队覆盖值、套餐、系统配置和默认值依次取值，并将历史 0 值视为未配置。
10. 修复工作流判断器（If/Else）数组值与数字、布尔等非字符串引用变量比较时，「包含/不包含」结果错误的问题，统一按文本比较基础类型值。
11. 修复模板或备份导入的 CSV 数据在重解析时被当作普通文档处理的问题，保留逐行问答、自定义索引与元数据结构。
12. 修复知识库导出 CSV 时将系统自动生成的索引计入自定义索引列的问题，避免多余列及重新导入后产生重复索引。
13. 修复工作流模型引用识别不一致的问题，统一处理重复模型输入、旧版模型名称与模型 ID，避免将外部工具的同名参数误识别为系统模型配置。
14. 修复管理员编辑套餐时将未填写的可选配额转为 0 的问题，留空时沿用套餐标准值，显式填写 0 时仍保留该值。
15. 修复工作流判断器正则条件错误剥离单侧或转义斜杠的问题，仅移除成对的 /.../ 包装；手动输入和引用变量均保留正则语义，非法表达式按错误处理。
16. 修复 Agent 模型请求出错时遗漏本轮 Token 与积分消耗统计的问题，错误返回前仍累计已产生的消耗。
17. 修复 PowerPoint（PPTX）文档解析时演讲者备注顺序错乱的问题，严格按照关联关系将备注排在所属幻灯片之后。
18. 修复 Excel（XLSX）文档解析时默认系统日期与时间格式被转换为不带世纪的紧凑格式导致顺序与年代无法区分的问题，统一重写为规范的 ISO 日期时间格式。
19. 修复 parseFileExtensionFromUrl 在文件 URL 携带的查询参数中包含 % 字符时导致解析结果为空扩展名的问题。
20. 修复文件大小格式化在向上进位时展示异常（如出现 1024 KB / 1024 MB）的问题，正确进位至下一级单位。
21. 修复多团队模式下登录兜底创建个人团队时未透传事务 session，导致并发读取未提交的默认全员组而产生重复创建或权限读取异常的问题。
22. 修复 Markdown 表头超过分块长度限制时导致整个文档解析失败的问题，改为按长度拆分行内容，避免中断知识库导入。
23. 修复带 XML 声明的 SVG 等文本文件上传时被误判为类型不匹配，以及 UTF-16 文本被误判为二进制或解析为乱码的问题，统一文本识别与编码探测结果。
24. 修复工作流代码助手生成的输入输出名称与代码实际参数 key 不一致的问题，保留已有输出标识，避免破坏下游变量引用。
25. 修复多个浏览器标签页同步对话状态时反复写入本地存储的问题，保留各标签页独立的会话状态。
26. 修复飞书消息未提供话题 ID 时会话标识拼接异常的问题，未分话题的消息按群聊标识归入会话。
27. 修复应用、技能、知识库及知识库文件移动到根目录时，空父级 ID 导致 BSON 转换报错或权限更新异常的问题。
28. 修复 Doc2x 表格单元格包含竖线时转换为 Markdown 后错列的问题，并保留表格代码与公式中的 LaTeX 语义。
29. 修复 Next.js 不同模块实例间 Langfuse 与 OpenTelemetry 状态不共享，导致链路属性或处理器状态不一致的问题。
30. 修复工具版本选择器使用版本描述替代版本号的问题，统一在详情、批量更新与工作流配置中展示实际版本号。
31. 修复工作流多变量引用选择器中删除按钮无法正常悬停显示和点击的问题。
32. 修复团队成员管理错误展示「恢复」操作的问题，仅对同步模式下已禁用的成员展示。
33. 修复 OpenAPI 文档将必填 ObjectId 请求参数标为可选的问题，同步修正参数必填信息与最小请求示例。
34. 修复工作流单步调试时，上传的文档文件无法被文档解析节点识别的问题。
35. 修复技能卡片无法拖拽到文件夹的问题，拖拽后确认即可移动，批量选择模式下关闭拖拽以避免操作冲突。
36. 修复表格复制为 Markdown 时携带 CSV 转义引号的问题，并统一处理 CRLF、单独 CR 与 LF 换行，避免复制或导出后表格错行。
37. 修复知识库导出可绕过文件级权限读取内容的问题，导出表头与数据使用相同的可读文件范围。

🛠️ 代码优化

1. SSO 后端连接地址从 feConfigs.sso.url 调整至 systemEnv.sso.url，加载配置时兼容旧字段；商业版仍通过 EXTERNAL_USER_SYSTEM_BASE_URL 配置，无需手动迁移。
2. 使用无效或已删除的 MCP 应用访问 Key 时返回 HTTP 500 的问题，改为返回携带原请求 ID 的 JSON-RPC 错误，并将日志级别调整为警告。
3. 拆分应用资源提取、保存与发布授权、工作流运行时加载及前端校验职责；资源在实际执行节点按需加载，命中版本快照时复用应用授权，未命中时按实际运行成员校验权限。
4. 抽取共享 workflow-core 与 workflow-cli，统一节点、引用、条件分支、系统配置及语义校验，供画布与 AI 工作流构建复用。
5. 拆分技能调试执行逻辑与 HTTP 适配层，复用权限、工作流调度、消耗统计及失败收尾流程。
6. 补充企业微信 WebSocket 发布渠道的基础数据模型，包括机器人凭据、配置版本、连接状态、Bot ID 唯一约束及聊天和计费来源映射。
7. 工作流校验诊断码统一为共享枚举，供画布、CLI 与辅助生成复用。
8. 审计日志底层支持 system 作用域，无成员身份的系统事件可单独记录，成员事件仍要求提供成员 ID。
9. 统一 Agent Ask 与工作流辅助生成预览的结构化回答，问题与回答随独立用户消息保存，共用模型输入转换与对话持久化逻辑。
10. 工作流辅助生成的沙盒节点模板按内容缓存，减少多轮对话中的重复写入，模板文件被清理后自动补写。
11. 应用、文档、代码运行沙盒、MCP Server 等镜像的 Node.js 基础版本升级至 24.22.1，并更新 Hono 与 Vite 依赖。
12. 知识库解析任务在执行期间积分耗尽时反复报错的问题，识别额度不足并跳过本次处理，由下一轮领取任务时的团队余额检查统一暂停。
13. 修复网站知识库同步因模型配置错误未及时停止爬取，以及爬取未完成时误删历史页面的问题；因额度不足或模型配置错误提前停止、达到页数上限导致截断、页面抓取失败或无法确认爬取完成状态时，均跳过过期页面清理。任务结束日志补充完成状态、待处理及失败页数，便于排查同步异常。
14. 文件加载任务遇到预期的 DNS、网络连接或用户业务异常时，日志级别调整为警告，仍向调用方返回失败；配置占位域名及未知异常保留错误级别，减少无效告警。