Starstruk Logo MarkStarstruk

v4.15.4

pingcap/autoflowv4.15.4Jul 24, 2026by FinleyGe

AI Summary

Version 4.15.4 introduces a mandatory `FE_DOMAIN` configuration and updates MongoDB index synchronization logic to prevent accidental data loss. The release includes security optimizations for workflow context management and fixes issues related to chatbox streaming, MinIO operations, and enterprise certification.

Key Highlights

  • FE_DOMAIN configuration is now required for FastGPT service startup.
  • MongoDB index synchronization is updated to be non-destructive by default via MONGO_DEPRECATE_INDEX.
  • Optimized workflow file context management to reduce security risks.
  • Fixed MinIO batch deletion issues related to XML entity expansion limits.
  • Added OpenAPI admin API documentation.

Breaking Changes

  • FE_DOMAIN environment variable is now mandatory for service startup.
  • SYNC_INDEX environment variable is deprecated in favor of MONGO_DEPRECATE_INDEX.

New Features

  • Workflow file context management
  • OpenAPI admin API documentation

Full Release Notes

## 📦 升级指南

### 配置必填的 FE_DOMAIN

FastGPT 服务启动时会校验 `FE_DOMAIN`。请将它配置为客户端访问 FastGPT 时使用的地址，该地址由协议、主机和可选端口组成。公网部署应填写客户端实际使用的公网访问地址；本地开发可使用 `http://localhost:3000`。

```bash
FE_DOMAIN=https://fastgpt.example.com
```

### MongoDB 索引同步调整

V4.15.4 起，`SYNC_INDEX` 弃用，新增 `MONGO_DEPRECATE_INDEX` 环境变量，用于控制是否清理 Schema 显式标记的废弃索引，默认值为 `true`。设置为 `false` 时只跳过废弃索引清理，不影响当前 Schema 缺失索引的创建。

FastGPT 启动时会自动执行安全的主动同步：

- 创建当前 FastGPT Schema 中缺失的索引。
- 仅删除对应 Schema 明确标记为废弃、且 name、key 和关键 options 完全匹配的 FastGPT 系统内置历史索引。
- 保留客户自建索引及其他未声明的索引。

该同步不会调用 Mongoose 的全量 `syncIndexes()`，因此不会按“未在 Schema 中声明”这一条件批量删除索引。

> **默认开启与删除边界：`MONGO_DEPRECATE_INDEX` 默认为 `true`，仅删除 FastGPT Schema 显式声明为废弃、且索引定义精确匹配的系统内置索引，不会删除客户自建索引。建议为自建索引显式设置自定义名称，不要使用 MongoDB 按 key 生成的默认名称，避免与 FastGPT 系统内置索引重名。**

> **旧索引清理说明：V4.15.4 不会把任何已有历史索引标记为废弃，因此升级到该版本时不会自动删除旧索引。后续版本会在确认安全后，通过 Schema 中的显式废弃标记逐步清理对应索引。**

如需在升级 V4.15.4 前完整删除历史过期索引，请按以下顺序操作：

1. 先升级并启动一次 V4.15.3。
2. 设置 `SYNC_INDEX=true`，重启服务并等待索引同步完成。
3. 确认索引同步成功后，再升级至 V4.15.4。

V4.15.3 的索引同步会删除所有未在当时 Schema 中声明的索引，其中可能包含客户自建索引。执行上述步骤前，请先备份数据库并检查现有索引；如需保留自建索引，请记录其定义并在同步后重新创建，或不要使用 V4.15.3 进行全量清理。

`MONGO_DEPRECATE_INDEX=false` 会跳过未来版本可能声明的废弃索引清理，但不会跳过缺失索引的创建。

## 🚀 新增内容

## ⚙️ 优化

1. 工作流文件上下文管理，减少重复签发以及避免潜在安全问题。
2. 优化思考 Icon 动画。

## 🐛 修复

1. chatbox 流输出时候，不应该展示系统工具的错误。
2. 完整运行详情，纯文本的工具响应 UI 可能会被 Markdown 错误解析，格式错乱。
3. 切换向量模型后，训练任务会触发但已有数据的向量未重建。
4. 修复 MinIO 按前缀批量删除大量对象时，可能因 XML 实体展开限制失败的问题，并增加请求超时保护。
5. 修复企业认证银行账号校验问题。
6. 修复 Agent V2中工具列表和提示词矛盾的问题。
7. 修复部署脚本 `.yaml` 中的语法问题

## What's Changed
* fix(dataset): translate image parse node response by @c121914yu in https://github.com/labring/FastGPT/pull/7331
* fix Pro auth errors as UserError by @c121914yu in https://github.com/labring/FastGPT/pull/7334
* feat(openapi): 补全 admin API 文档并修复 pg/template 兼容问题 by @ctlaltlaltc in https://github.com/labring/FastGPT/pull/7333
* chore: upgrade turbo deps by @xqvvu in https://github.com/labring/FastGPT/pull/7335
* fix: respect configured chat upload limit by @xqvvu in https://github.com/labring/FastGPT/pull/7336
* fix(ui): agent creation preview image overlaps on the text by @Nixieboluo in https://github.com/labring/FastGPT/pull/7337
* fix(certification): remove close button by @shortlight5980 in https://github.com/labring/FastGPT/pull/7338
* feat: bind homepage visitor id after authentication by @c121914yu in https://github.com/labring/FastGPT/pull/7319
* v4.15.1 docs: clarify WeCom redirect migration by @FinleyGe in https://github.com/labring/FastGPT/pull/7340
* fix(ci): allow trusted fork checkout in pro workflows by @DigHuang in https://github.com/labring/FastGPT/pull/7342
* chatbox tip by @c121914yu in https://github.com/labring/FastGPT/pull/7341
* docs: add v4.15.4 release notes by @c121914yu in https://github.com/labring/FastGPT/pull/7343
* fix(deploy): fix v4.15 compose template yaml syntax and install.sh re… by @liouxy in https://github.com/labring/FastGPT/pull/7344
* fix: add .js extension to dayjs plugin imports for ESM compatibility by @ctlaltlaltc in https://github.com/labring/FastGPT/pull/7348
* fix(dataset): rebuild vectors when embedding model changes by @c121914yu in https://github.com/labring/FastGPT/pull/7359
* fix(ui): restore loading star orbit by @DigHuang in https://github.com/labring/FastGPT/pull/7360
* feat: add workflow file context by @c121914yu in https://github.com/labring/FastGPT/pull/7346
* fix(certification): remove bank account length verification by @shortlight5980 in https://github.com/labring/FastGPT/pull/7369
* fix(agent): recognize internal runtime tools by @YYH211 in https://github.com/labring/FastGPT/pull/7367
* fix(storage): avoid MinIO XML entity expansion limit by @xqvvu in https://github.com/labring/FastGPT/pull/7356
* fix: make mongo index sync non-destructive by @xqvvu in https://github.com/labring/FastGPT/pull/7313
* build(deps): bump next from 15.5.18 to 15.5.21 by @dependabot[bot] in https://github.com/labring/FastGPT/pull/7372
* docs(release-notes): finalize V4.15.4 release notes by @FinleyGe in https://github.com/labring/FastGPT/pull/7374

## New Contributors
* @Nixieboluo made their first contribution in https://github.com/labring/FastGPT/pull/7337
* @liouxy made their first contribution in https://github.com/labring/FastGPT/pull/7344

**Full Changelog**: https://github.com/labring/FastGPT/compare/v4.15.3...v4.15.4