V4.15.0-beta4(进行中)

📦 升级指南

‼️重要更新，插件服务更新到 v1.0.0-beta1 版本，系统工具运行方式有较大调整。

镜像变更

• 更新 fastgpt-app(fastgpt 主服务) 镜像 tag: v4.15.0-beta4
• 更新 fastgpt-pro(fastgpt 商业版) 镜像 tag: v4.15.0-beta4
• 更新 fastgpt-plugin 镜像 tag: v1.0.0-beta1
• 更新 aiproxy 镜像 tag: v0.6.0

插件服务升级

本次插件服务将系统工具从旧的内置工具源码与运行时缓存机制，升级为独立插件包的上传、安装、版本管理和 local-pool 运行机制。

• 升级后需要使用官方系统工具 zip 包重新导入系统工具。
• 模型配置和 workflow 模板保持兼容，无需专项迁移。
• 插件服务建议连接新的 MongoDB 数据库，保留旧插件服务数据库和对象存储数据，便于回滚和审计。
• 插件服务生产环境需设置强 AUTH_TOKEN，避免继续使用默认 token。

插件服务可继续复用原 MongoDB 实例，但需要修改数据库名，让新版插件数据写入新库。参考环境变量如下：

fastgpt-plugin:
  environment:
    MONGODB_URI: mongodb://myusername:mypassword@fastgpt-mongo:27017/fastgpt-plugin-v1?authSource=admin

🚀 新增内容

1. 系统工具支持以独立 .pkg 插件包方式安装。
2. 系统工具支持上传官方 zip 包批量导入。
3. 插件服务支持插件上传确认、URL 安装、版本列表、删除和 disabled 清理。
4. 插件版本支持通过 pluginId、version 和 etag 唯一识别。
5. 插件服务启动时会自动注册 active 插件到 local-pool 运行时。
6. 应用/知识库增加虚拟列表渲染。
7. 增加单独的 openapi 文档，区分 devapi 文档。
8. 导出工作流模板，同时导出名字和介绍。

⚙️ 优化

1. 系统工具运行迁移到 local-pool，支持进程池、队列、超时、重试退避和运行指标。
2. 支持插件级 runtime config。
3. 插件运行入口支持从对象存储拉取，并缓存到本地文件目录。
4. 输入引导配置增加校验，避免错误配置了自定义词库地址。
5. 工作流数组引用类型增强校验，避免刚好与二维数据冲突。
6. 知识库被删除后，应用编排时优雅提示。

🐛 修复

1. 模型获取多模态文件链接异常。

🛠️ 代码优化

1. 插件服务从旧 runtime 结构调整为 pnpm workspace monorepo，拆分为 HTTP 服务入口、领域模型、用例、API adapter、基础设施、SDK 和 CLI。
2. 将 app API 接口全部用 zod schema 编写并生成文档。