FastGPT v4.16.1 升级要点：沙盒镜像与工具 Schema 存储迁移

FastGPT 发布 v4.16.1，本次更新既包含新功能，也要求升级时完成两项配置与数据迁移。

升级注意事项

Agent Sandbox 镜像：启用 Agent Sandbox 时，需在 fastgpt-app 和 fastgpt-pro 中同步检查 AGENT_SANDBOX_OPENSANDBOX_IMAGE。4.16.1 使用完整运行态镜像地址，默认配置为非 root 镜像 fastgpt-agent-sandbox:v0.3.1；若沙盒需要安装 apt 依赖，必须切换为 root 镜像 fastgpt-agent-sandbox-root:v0.3.1，并可选配 AGENT_SANDBOX_APT_MIRROR 指向 apt 镜像源。

JSON Schema 存储迁移：迁移必须严格按版本顺序执行。先在 4.16.0 中执行 initHttpToolSchema 脚本，把手动 HTTP 工具的历史数组参数转换为标准 JSON Schema；升级到 4.16.1 后再执行 initToolJsonSchemaStorage。4.16.1 会检查 4.16.0 处理过的 HTTP 工具应用及历史版本，如果这些数据仍包含旧数组类型，接口将拒绝执行，以免旧数据被直接转成字符串。迁移只涉及 MCP/HTTP 工具应用及其历史版本，不处理普通工作流应用。正式执行前，可先用 dryRun: true 调用该接口检查 total.changedDocumentCount，确认后再改为 dryRun: false 执行。

新增与优化

• 新增第三方发布渠道，支持多模态文件、音频转录和引用（如有）。
• 支持团队安装系统插件；原文注明为进程模式，存在一定安全风险，未来版本计划支持 serverless 隔离运行。
• 沙盒支持自定义 apt 源。
• S3 key 命名不再使用原文件名，以避免名称过长。
• MCP/HTTP 的 JSON Schema 改为 String 类型存储，以避免自定义对象与 Mongo 规则冲突。

修复

本次修复涉及以下问题：工作流全局变量字段名过长溢出；AgentV2 调用子工作流时，流输出内容未禁用；团队邀请链接可重复接收同一团队邀请；使用记录日期选择器多显示一天。代码层面还补全了 devapi 接口文档，优化了插件系统并发初始化与日志，并修复了插件运行错误被抛为系统错误、以及 Node.js 版本高于 v25 时 --allow-net 策略未设置导致的问题。