Starstruk Logo MarkStarstruk

v4.15.4

krahets/hello-algov4.15.4Jul 24, 2026by FinleyGe

AI Summary

This release focuses on FastGPT deployment configuration updates, specifically introducing a mandatory FE_DOMAIN setting and a safer MongoDB index synchronization mechanism using a new environment variable. It also includes various UI improvements and bug fixes for chatbox streams and storage.

Key Highlights

  • Requires FE_DOMAIN configuration for FastGPT startup to ensure correct client access.
  • Introduces MONGO_DEPRECATE_INDEX to safely clean deprecated indices without deleting customer-built ones.
  • Optimizes workflow file context management to reduce security risks.
  • Fixes chatbox stream output errors and MinIO XML entity expansion limits.
  • Improves agent creation preview UI and restores loading animations.

Breaking Changes

  • FE_DOMAIN is now required to start the FastGPT service.
  • SYNC_INDEX environment variable is deprecated in favor of MONGO_DEPRECATE_INDEX.

New Features

  • Admin API documentation completion and pg/template compatibility fix.
  • Bind homepage visitor ID after authentication.
  • Add workflow file context management.

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