v4.12.0

labring/FastGPTv4.12.0Aug 12, 2025by c121914yu

AI Summary

A major commercial feature release introducing log dashboards and a simplified chat page, alongside a significant permission model refactoring.

Key Highlights

  • Commercial version now supports application log data dashboards.
  • Simplified chat page allows direct model/tool chatting without app setup.
  • Permission model refactored to use Role mapping Permission pattern.
  • Requires an upgrade script for commercial users to initialize log permissions.

Breaking Changes

  • Permission model refactored to Role mapping Permission pattern.
  • Requires execution of upgrade script `/api/admin/initv4120` for commercial users.

New Features

  • Commercial app log dashboard.
  • Simplified chat page (no app needed).
  • Role mapping Permission model.
  • Per-app chat log view permissions.

Full Release Notes

## 更新指南

### 1. 更新镜像:

- 更新 FastGPT 镜像tag: v4.12.0
- 更新 FastGPT 商业版镜像tag: v4.12.0
- 更新 fastgpt-plugin 镜像 tag: v0.1.9
- mcp_server 无需更新
- Sandbox 无需更新
- AIProxy 无需更新

### 2. 执行升级脚本

该脚本仅需商业版用户执行。

从任意终端,发起 1 个 HTTP 请求。其中 `{{rootkey}}` 替换成环境变量里的 `rootkey`;`{{host}}` 替换成**FastGPT 域名**。

```bash
curl --location --request POST 'https://{{host}}/api/admin/initv4120' \
--header 'rootkey: {{rootkey}}' \
--header 'Content-Type: application/json'
```

**脚本功能**

1. 初始化团队成员的应用对话日志权限。

## 🚀 新增内容

1. 商业版支持应用日志数据看板。 @newfish-cmyk 
2. 商业版支持简易对话页,可直接选择模型和预设工具进行聊天,无需进行应用搭建。 @xqvvu 
3. 对话页,增加团队应用快速切换。 @xqvvu 
4. 权限表调整,采用 Role 映射 Permission 模式。 @FinleyGe 
5. 应用可单独分配对话日志查看权限。 @FinleyGe 

## ⚙️ 优化

1. 优化 3 处存在潜在内存泄露的代码。 @c121914yu 
2. 优化工作流部分递归检查,避免无限递归。 @c121914yu 
3. 优化文档阅读 Worker,采用 ShareBuffer 避免数据拷贝。 @c121914yu 
4. 批量进行向量生成和入库,减少网络操作。 @c121914yu 
5. 知识库搜索,多 query 合并计算,减少数据库操作。 @c121914yu 
6. 选择知识库交互优化。 @colnii 
7. 登录页 UI 调整。 @c121914yu 
8. 工作流中,更严格检测工具集是否可被添加。 @c121914yu 
9. 对话日志导出,仅导出选中的表头,并修复部分表头无法导出的问题。 @newfish-cmyk 

## 🐛 修复

1. Doc2x API 更新,导致解析失败。 @c121914yu 
2. 工作流中,团队应用目录也可以被加入工作流。 @c121914yu 
3. 工作流,数组选择器 UI 缺陷。 @c121914yu 
4. 成员同步存在权限未完成删除问题。 @FinleyGe 

## 🔨 工具更新

1. 系统工具可返回 citeLinks 响应值,从而在对话框实现引用链接展示。

## What's Changed
* fix: missing build mcp image args by @503612012 in https://github.com/labring/FastGPT/pull/5366
* 4.11.2 dev by @c121914yu in https://github.com/labring/FastGPT/pull/5368
* Fix: action by @c121914yu in https://github.com/labring/FastGPT/pull/5369
* perf: memory leak by @c121914yu in https://github.com/labring/FastGPT/pull/5370
* feat: move robots.txt to toc.mdx by @dreamer6680 in https://github.com/labring/FastGPT/pull/5372
* Update dataset.mdx by @Deepturn in https://github.com/labring/FastGPT/pull/5381
* fix dataset list item tag margin by @newfish-cmyk in https://github.com/labring/FastGPT/pull/5380
* fix: build mcp image proxy by @503612012 in https://github.com/labring/FastGPT/pull/5379
* fix: doc preview action;update doc by @c121914yu in https://github.com/labring/FastGPT/pull/5383
* fix docker file by @c121914yu in https://github.com/labring/FastGPT/pull/5385
* update doc search engine by @c121914yu in https://github.com/labring/FastGPT/pull/5386
* 更新 4112.mdx by @c121914yu in https://github.com/labring/FastGPT/pull/5387
* fix: mcp not response output by @c121914yu in https://github.com/labring/FastGPT/pull/5388
* Update dataset.mdx by @Deepturn in https://github.com/labring/FastGPT/pull/5391
* fix: doc path by @c121914yu in https://github.com/labring/FastGPT/pull/5393
* chore(deps): bump transformers from 4.52.1 to 4.53.0 in /plugins/model/llm-Baichuan2 by @dependabot[bot] in https://github.com/labring/FastGPT/pull/5397
* fix: old mcp tool compatible by @FinleyGe in https://github.com/labring/FastGPT/pull/5399
* doc by @c121914yu in https://github.com/labring/FastGPT/pull/5401
* fix: max tokens config by @c121914yu in https://github.com/labring/FastGPT/pull/5409
* Perf: llm parse paragraph by @c121914yu in https://github.com/labring/FastGPT/pull/5420
* refactor: permission role & app read chat log permission by @FinleyGe in https://github.com/labring/FastGPT/pull/5416
* test: Add unit test for projects/app/src/service/support/mcp/utils.ts by @gru-agent[bot] in https://github.com/labring/FastGPT/pull/5423
* chore: fix admin permission edition & resource move by @FinleyGe in https://github.com/labring/FastGPT/pull/5433
* V4.12.0 features by @c121914yu in https://github.com/labring/FastGPT/pull/5435


**Full Changelog**: https://github.com/labring/FastGPT/compare/v4.11.1...v4.12.0