FastGPT v4.16.2 发布：升级需删旧 Worker 配置并迁移权限与 Milvus 全文检索

版本与升级要点

FastGPT 发布 v4.16.2（2026-09-03）。官方说明此次因分支选择错误而重新选择分支发布。

1. 删除旧 Worker 配置

该版本移除 PARSE_FILE_WORKERS、PARSE_FILE_WORKER_MEMORY_LIMIT_MB、HTML_TO_MARKDOWN_WORKERS、TEXT_TO_CHUNKS_WORKERS，升级时应从 .env 或 Docker Compose 的 environment 中删除，无需替代变量。

• 文件解析 Worker 上限依据 Node.js 检测到的可用 CPU 并行度自动设定，并考虑容器 CPU 配额与进程亲和性，最少保留 1 个；实际并发还受解析内存调度限制。
• HTML 转 Markdown 与文本切块 Worker 上限取可用 CPU 并行度与 5 的较小值。任务启动前检查安全预留外的可调度内存，不足时排队；完成后立即重试一次，仍不足则每 30 秒检查，最长等待 30 分钟。空闲 Worker 超 60 秒回收，最多长期保留 1 个。

2. 镜像更新

fastgpt-app、fastgpt-pro、fastgpt-code-sandbox 的镜像 tag 均为 v4.16.2，fastgpt-plugin 为 v1.1.2。

3. 商业版权限迁移

需先以 dry-run 调用 /api/admin/4162/initPermission，确认 migration.errors 为空或处理完异常后再正式执行。teamConcurrency 控制同时处理的团队数，范围 1–1000，默认 100；同一团队内 App、Dataset、Agent Skill 依次处理，单类失败写入 migration.errors 并继续。返回结果含 cleanup 与 migration 两部分统计。dry-run 的迁移预览基于清理前数据，若命中无效权限，正式执行后统计可能不同。正式迁移可重复执行，完成后再次 dry-run 应使 cleanup.danglingPermissionCount、migration.updatedResourceCount 与 migration.errors 均为 0。

4. Milvus 全文检索

使用 Milvus 时须先将其升级到 2.5.16 或更高版本；FastGPT 会自动切换到 Milvus BM25 全文检索并使用 modeldata_v2 集合。版本过低、无法识别或 BM25 校验失败时，FastGPT 会终止启动，不回退到 MongoDB 全文检索。旧 modeldata 集合存在且有数据时，可调用 GET /api/admin/4162/milvus 将旧向量与 MongoDB 索引文本合并迁移，无需重新生成嵌入。使用 PG、OceanBase、SeekDB 或 openGauss 时无需此步骤。

新增与优化

新增韩语支持、账号注销、技能切换版本时的覆盖提示；Milvus 场景支持基于 modeldata_v2 单表的 BM25 全文检索；文档解析新增 DOC、WPS、DOCM、PPT 系列、XLS 系列及 ODT、ODS、ODP、RTF、EPUB 等格式，内嵌图片提取后上传对象存储并保留引用，未识别图片回退为文本。所有节点支持工具调用。

工具调用异常判断改为识别相同工具与相同参数的连续调用超过 5 次；Agent 工具报错时保留完整响应并同步展示。商业版工具执行失败不收取调用费或 Token 费用。另修复模板市场头像、系统工具重装、空知识库 CSV 导入、孤立套餐导致列表失败、发票列表校验等问题。