# V4.18.0

> FastGPT V4.18.0 更新说明

Source: https://doc.fastgpt.cn/zh-CN/self-host/upgrading/4-18/4180

## 升级指南

**升级前提**：先在 4.17.x 完成所需历史迁移，再升级到本版本；4.18.x 已移除旧任务的注册与实现，不会继续执行，数据库中的历史状态和错误明细保留。

### 配置变更

* 新增 `SERVICE_AXIOS_MAX_CONTENT_LENGTH`，默认 `20` MiB，限制服务端共享 HTTP 客户端缓冲型响应的解压后大小，超限中止请求；依赖更大响应的自定义接入需调大此值。调用方显式设置的响应上限优先，流式下载仍按调用方或业务配额限制。

* `HNSW_EF_SEARCH` / `systemEnv.hnswEfSearch` 的默认值从 `100` 调整为 `200`，适用于 PostgreSQL、Milvus、OceanBase、SeekDB 和 openGauss；显式配置的值继续生效，可按召回率与查询耗时调整。

* `HNSW_MAX_SCAN_TUPLES` / `systemEnv.hnswMaxScanTuples` 不再生效，管理台移除对应设置；PostgreSQL 的扫描上限改按本次索引检索涉及的最大知识库向量行数自动设置，上限为 `2147483647`，已有部署可移除旧配置。

* 新增 `SHOW_OUTLINK_BRAND`：未配置 `PRO_URL` 时固定为 `true`；接入 Pro 后默认 `false`，可设为 `true` 启用品牌展示。前端 `show_outlink_brand` 由服务端环境派生，覆盖 `config.json` 中的同名配置。

* 商业版新增模型下架提醒短信模板 `auth.sms.MODEL_DEPRECATION`；当前短信统一使用该中文模板，不按用户语言选择，`auth.sms.MODEL_DEPRECATION_EN` 配置暂不生效。启用短信提醒前需在管理台配置中文模板 ID。

* **插件服务部署**：Docker Compose 模板补齐 `fastgpt-plugin` 的 `FASTGPT_BASE_URL=http://fastgpt-app:3000`，将 `MONGODB_URI` 指向独立的 `fastgpt-plugin` 数据库，并显式设置 `DB_MAX_LINK=100`，避免与主库集合混用；自定义部署应填写插件容器可访问的主服务地址；若插件容器日志出现反向上传文件 `401`，优先核对该地址，修正后重建插件容器并重试工具。已有部署替换模板前应核对原插件库，保留已使用的独立库连接；若需切换数据库，先备份并迁移既有插件数据。

* 默认部署的对象存储改为 RustFS，已有部署可继续使用原存储，如需切换请参考 [MinIO 迁移到 RustFS](/zh-CN/self-host/docker_minio_to_rustfs)。

* **内容审核（Moderation）插件化迁移**：旧版商业版内置的百度文本审核（`censor.BAIDU_TEXT_CENSOR_CLIENTID` / `censor.BAIDU_TEXT_CENSOR_CLIENTSECRET`）、自定义审核地址（`censor.customCensorURL`）以及单模型配置中的 `censor` 开关已废弃，统一升级为由 `fastgpt-plugin` 托管的 `moderation` 插件体系。
  * 原百度审核用户请前往 **管理后台 > 内容审核 > 审核策略配置**，配置并启用官方「百度内容安全（`baidu`）」插件。
  * 原自定义审核 URL（`customCensorURL`）用户可直接安装官方「旧版自定义审核兼容（`legacy-custom-censor`）」插件零代码迁移现有 HTTP 服务，或基于 `@fastgpt-plugin/sdk-factory` 开发原生 `moderation` 插件。
  * 详细的新旧版本对比、配置映射与开发步骤见 [内容审核升级与迁移指南](/self-host/migration/content-moderation)。

* **全新部署**：`main` Compose 模板默认 MongoDB 更新为 `8.0.34`，初始化和健康检查统一使用 `mongosh`，副本集主节点就绪后再放行依赖服务。

### 镜像更新

本版本仍在开发中，镜像 tag 在正式发布时补充。

### 升级脚本

本次脚本均为自动执行，无需手动执行。

1. 新增 **初始化知识库向量索引**（`20261022_initialize_dataset_vector_indexes`），仅 PostgreSQL 在启动后于后台自动执行，不阻塞业务：先核验并在线删除旧全局 `vector_index`，再分批统计有效知识库并投递索引维护任务。任务成功表示统计与投递完成，实际建图由全局串行队列继续执行；清理或扫描失败时，可在升级管理页修复问题后重试，沿已保存的断点继续，同名但定义不匹配的自建索引会保留并报错。
2. PG 局部索引要求支持 `halfvec`、固定向量维度在 `1–4000` 范围内，并具备在线创建、删除索引的权限及足够的内存、共享内存和磁盘资源。索引未就绪或失败期间继续精确检索，可能增加查询耗时；建图失败不会自动降低资源预算重试，排除故障后由下一次真实向量计数重新投递，缓存命中不会触发重试。
3. 新增 **回填历史对话调用渠道**（`20261104_backfill_chat_publish_source`），启动后独立在后台批量读写，不阻塞业务，也不等待普通后台长任务；分别为对话与统计记录补齐 `publishSource`，不修改旧字段、身份、消息或统计计数。历史 API、MCP 及已删除渠道可能只能恢复类型，无法补齐渠道 ID；无法识别的旧来源统一归为 `unknown`，不猜测渠道归属。此前因来源枚举失败的记录可在升级管理页直接重试，无需修改旧数据或重置进度；其他引用冲突或数据异常仍会记录失败，修复后沿断点续跑。
4. 新增 **回填 API Key 类型**（`20261104_backfill_openapi_key_type`），自动分批遍历全部密钥，将缺失的 `type` 补为 `personal`，有效 `appId` 统一保存为 BSON ObjectId；保留凭证、归属、额度及默认应用或绑定语义。运行期管理查询只支持已规范化的数据格式；迁移期间或旧实例继续写入的旧格式数据不在查询兼容范围内。首次扫描上界之后的旧格式记录不会自动补迁，需另行规范化。异常数据可在升级管理页修复后重试。

### 兼容说明

* **历史 API 密钥**：无需重新生成。缺少 `type` 的旧 Key 自动归为个人密钥，原 `appId` 仍作为默认对话目标，访问权限和个人管理方式不变；新建的应用 Key 则仅用于绑定应用，由应用管理员共同管理。
* **API Key 健康检查**：由于安全问题，`GET /api/support/openapi/health` 改用 `Authorization: Bearer <apiKey>` 请求头，不再从 URL 的 `apiKey` 参数读取凭证；已有健康探针需调整传参并移除 URL 中的密钥。
* **系统模型直连鉴权**：已有系统模型若设置了 `requestUrl` 却依赖默认 `AIPROXY_API_TOKEN` 鉴权，升级前需显式填写该端点的 `requestAuth`；未配置时，OpenAI SDK 与 Pi Agent 的直连请求不再回退默认凭证。
* **动态选择选项**：用户选择节点及表单单选、多选的变量引用选项，运行时仅保留前 `200` 个有效项，单项文本最长 `100` 个 UTF-16 码元，超出部分截断；依赖超长选项值或后续候选项的流程需调整候选数据，并核对下游匹配逻辑。
* **API 身份参数**：API 会话不再允许更换使用者，已有会话以保存的身份为准，续聊需保持相同 `customUid`；已绑定后漏传、清空或更换，以及从默认身份改为自定义身份都会被拒绝，混用使用者的接入需改用独立 `chatId`。非空 `customUid` 仅允许 API Key 调用；它与 `authProxy` 互斥，即使为空字符串也不能同时传入，已有同时传参的接入需保留一种身份。
* **会话 ID 长度**：会话管理、文件、引用和沙盒等入口统一将 `chatId` 限制为最多 `1024` 个字符；使用超长自定义 ID 的接入需调整生成规则，并核查已有超长会话及相关引用。
* **重复生成响应**：非流式 `chat/completions` 在同会话已有生成时返回 HTTP `409`，依赖原错误状态码的自定义客户端需适配冲突响应。
* **日志 CSV**：基于「使用者」列解析团队成员的脚本需适配 `ID:name` 格式（旧版为成员名），成员缺少姓名时仅输出 ID；渠道列拆分为「调用渠道」与「渠道名」，按列名解析的脚本也需适配。
* **集合删除接口**：定位参数统一为请求体中的 `id`、`collectionIds` 或 `datasetId + apiFileIds`，三种方式不可混用。旧版 `query.id` 继续兼容但已弃用，新接入应使用请求体。

## 🚀 新增内容

1. **\[工具与渠道]** 新增绑定单个应用的应用 API Key，在应用发布页与个人密钥分开管理，由应用管理员共同维护，专用于该应用的对话及对话管理，不依赖归属成员的应用权限。商业版按资源交接流程转交密钥归属，删除应用时同步清理绑定密钥。
2. **\[工具与渠道]** 对话及配套管理统一支持外部使用者标识与成员代理，可通过 `customUid` 进一步限定历史、消息、文件、引用和沙盒等操作的使用者范围；开启代理权限的个人密钥可通过 `authProxy` 按被代理成员的权限执行。
3. **\[工具与渠道]** 对话日志新增默认隐藏的「鉴权者」列，与「使用者」分开展示，便于区分接入方用户和实际鉴权成员；API 传入的 `customUid` 按原值显示为使用者，CSV 按所选列导出。日志表格按内容分配列宽，避免长 UID 挤压成员姓名。
4. **\[工具与渠道]** 免登录分享页新增适配桌面、移动和嵌入式页面的 FastGPT 标识，启用后新建链接默认展示，桌面访客可在本次访问临时关闭。团队持久隐藏需有效套餐权益，商业版支持按套餐及单条订阅控制；未保存品牌偏好的历史链接继续豁免，已关闭链接在权益失效时恢复展示，保留偏好供权益恢复后生效。
5. **\[工具与渠道]** 新增默认关闭的插件化内容审核，启用后可分别审核用户输入、模型上下文与最终输出（含流式输出），并配置疑似风险和审核服务异常时的处理方式。管理台支持插件配置、审核效果测试及全局审核记录查看，对话详情可查看本次审核记录。
6. **\[工作流与 Agent]** 工作流 Agent 节点可从模板面板添加并作为工具节点供其他 Agent 调用，知识库输入支持变量引用；独立 ChatAgent 应用也可作为工作流子应用或 Agent 工具引用，支持传入文件与交互续跑，便于组合多 Agent 流程。
7. **\[工作流与 Agent]** 新增可在工作流内直接配置的 MCP 与 HTTP 工具集节点，无需先创建独立工具应用；支持自定义子工具描述、鉴权和逐个调试，运行时读取远端最新工具定义供工具调用节点使用。
8. **\[工作流与 Agent]** 商业版工作流 Builder 支持按明确的新建或修改请求直接搭建、校验和修复工作流，用户要求先看方案时仍等待预览确认；候选交付前增加同一 Agent 上下文中的需求覆盖自检，仍由用户手动应用到画布。
9. **\[工作流与 Agent]** 商业版工作流 Builder 支持在同一会话内切换并继续独立任务，分别保存需求、方案和草稿，上下文压缩或运行中断后可按已保存资料继续任务。恢复时仍核对任务状态与画布基线，沙盒丢失时不能保证找回未保存草稿。
10. **\[工作流与 Agent]** 应用模板支持配置体验链接，商业版可管理自建及插件系统模板的链接，供模板接入方在复制前提供预览入口。
11. **\[模型与计费]** 系统模型新增「即将下架」标记，模型管理、模型及语音选择器同步展示预警；商业版管理员可创建多轮通知，按当前已发布应用与知识库的静态模型引用筛选团队，发送站内信并可选短信或邮件。支持查看失败、恢复轮次、重发和终止，截止后停止新投递，实际下架模型仍需另行操作。
12. **\[模型与计费]** 商业版团队模型可通过配置接口或模板接入自定义请求地址与鉴权，作为过渡能力支持对话、Agent、向量、重排及语音直连，编辑后保留端点配置。端点在保存和请求时执行安全校验，重定向也受限制；列表隐藏端点与鉴权信息。
13. **\[模型与计费]** OpenAI、Azure 模型渠道支持选择自动、Responses 或 Chat Completions 聊天上游协议，新建渠道默认按模型自动选择；仅影响聊天模型，上游需支持所选协议。
14. **\[模型与计费]** 模型管理新增拖拽自定义排序，支持保存前取消；root 可调整系统模型，商业版启用团队模型后，具有「安装模型」权限的成员可调整自己的模型顺序。「可用模型」按本人、共享团队、系统模型分组并在组内应用自定义顺序，JSON 配置更新保留排序，客户端的最终系统模型兜底也使用该顺序；新建或新导入的模型默认位于所属分组顶部，保留已有模型的相对顺序。
15. **\[模型与计费]** 启用权限配置的模型表格新增创建人展示，系统模型单独标识来源；成员展示页可获取最新创建人资料，外链目录不暴露成员信息。
16. **\[模型与计费]** 商业版用量支持按成员、部门（包含下级部门）或群组筛选，三种方式互斥，明细、统计图表与 CSV 导出使用相同范围。所选范围按当前组织及群组成员关系解析，具备团队管理权限的成员可查看对应成员用量，普通成员仅查看本人。
17. **\[知识库与文件]** 商业版启用知识库增强时，模板 FAQ 导入接口支持按需生成自动索引，以问题和答案共同作为输入。自动索引任务中超出处理长度上限的条目改走普通向量索引，保留条目及其输入顺序。
18. **\[知识库与文件]** 知识库搜索新增「重排候选数」，可设置为 `10–100` 条，默认 `100` 条；按融合、去重后的文本召回顺序选取候选送入重排模型，便于平衡搜索效果、响应耗时和模型负载。重排成功时，超出候选数的文本分块也不会进入权重融合，避免绕过相似度过滤。
19. **\[知识库与文件]** API 文件库支持通过 `datasetId + apiFileIds` 按外部文件或目录 ID 批量删除，自动清理对应派生目录及子文档，无需提前查询内部集合 ID；操作仍校验删除根的所有权。
20. **\[团队与权限]** 商业版团队审计日志支持按日期、成员和事件组合筛选，默认展示含今天的近 `7` 个本地自然日，可选择更早日期及停用成员。具备团队管理权限的登录成员可导出全部匹配记录的多语言 CSV，单次最多 `50000` 条，超量需缩小范围；CSV 中的日志时间按查询起点偏移展示，发起导出会写入审计记录。
21. **\[团队与权限]** 商业版用户管理接口补充所属团队、成员名和部门路径，团队成员列表补充登录用户名，便于管理端区分账号与成员身份。
22. **\[系统与运维]** 对话记录最近一次运行的调用渠道，日志区分展示渠道类型和渠道名称，支持查看渠道 ID；相关筛选、CSV 导出与商业版统计同步采用新渠道分类。

## ⚙️ 优化

1. **\[工作流与 Agent]** 修复多个子应用或工作流工具调用同一目标时，内部节点记忆互相覆盖的问题。按完整调用路径隔离内容提取、问题分类与 Pi Agent 状态，覆盖克隆应用共享后代工具、递归进入根应用等场景。
2. **\[工作流与 Agent]** 修复 Agent、工具调用及嵌套子流程的记忆未完整回传、未执行分支的历史记忆丢失，以及并发子流程用旧状态覆盖其他节点新状态的问题；仅合并子流程本次更新，保留其他有效记忆。
3. **\[工作流与 Agent]** 修复循环、并行运行中的记忆传递与失败隔离问题。循环在成功迭代间传递记忆，交互暂停保留检查点，失败迭代不提交；并行任务仅合并成功结果，失败尝试不影响重试，并按输入顺序合并，同一记忆键以靠后的成功任务为准。
4. **\[工作流与 Agent]** 统一 Agent 表单与工作流节点的工具、技能和知识库卡片及状态校验，运行、发布和单节点调试使用相同规则；失效、下线或未配置资源会明确提示，异步选择与保存保留已有配置。
5. **\[工作流与 Agent]** 商业版工作流 Builder 预览新增标题、简短概述和待确认状态，恢复待确认方案时定位到卡片顶部，后续渲染保留阅读位置；确认、修改与取消仍使用统一交互入口。
6. **\[工作流与 Agent]** 单选、多选配置的选项上限由 `50` 提高至 `200`，用户选择节点的手动选项也限制为最多 `200` 项；单项文本输入最长 `100` 个 UTF-16 码元。
7. **\[工作流与 Agent]** 统一应用、工作流和工具编辑中的按钮及模型选择器尺寸，调整帮助图标与文字的对齐，让操作区更一致。
8. **\[知识库与文件]** PostgreSQL 按知识库维护 FP16 局部 HNSW 索引，向量行数超过 `10000` 时按需建图，低于 `5000` 时移除，中间区间保留已有状态；未就绪或无索引的知识库走精确检索，各组候选统一以 FP32 距离排序，原向量存储精度不变。性能和存储开销极大降低。
9. **\[知识库与文件]** 商业版简易应用、ChatAgent 与工作流 Agent 的标签过滤移入搜索参数的「搜索过滤」页签，并补充独立开关；手动输入模式关闭时保留条件，重新开启可继续编辑，参数提示按开关状态显示是否启用；知识库或过滤条件使用变量引用时保留配置，避免误删无法在编辑期确认的标签。
10. **\[知识库与文件]** 将文件上传按身份累计的每分钟限流额度提高至原来的 3 倍，减少连续或批量上传时触发「请求过于频繁」的情况。
11. **\[知识库与文件]** 修复商业版网站同步漏抓空正文目录页的子链接，以及正文无效、入库失败或页面上限截断时误删旧集合的问题；改进重复链接去重与重定向后的相对资源解析，同步不完整时保留旧数据。提前停止或超时后按序清理并限制等待时间，取消后不再发起后续写入或重试，已开始的数据库操作按自身机制完成。
12. **\[模型与计费]** 统一移动端模型选择、语音播放、渠道绑定、模型日志与仪表盘筛选中的测试模式模型排序，将测试模式模型置后，同组内保留目录顺序。
13. **\[模型与计费]** 模型管理表格统一表头与表体列宽，按行维护编辑弹窗状态，减少大列表打开弹窗时的整表重渲染。
14. **\[模型与计费]** 优化模型和语音选择器长名称的截断与悬浮提示，避免名称撑开控件或挤占音色列。
15. **\[对话体验]** 优化对话历史侧栏状态刷新，长列表分批查询，生成中或请求失败时持续重试；隐藏标签页暂停定时刷新，资源切换后忽略迟到响应，失败时保留上次状态和已读信息。
16. **\[对话体验]** 修复长时间无输出或客户端断开后生成状态失准、恢复连接持续等待的问题。持久化对话由独立续期的 Redis 租约判断忙闲，进程退出后在最后续期后最多 60 秒过期；租约获取或读取异常时会降级，故障期间无法保证同会话互斥与状态准确。
17. **\[团队与权限]** 修复新建、导入 JSON、复制应用及转为工作流副本时，因引用不可读或已不存在的资源而整体失败的问题。初始版本只记录可读资源的授权快照，节点中仍不可用的引用在详情页标记异常，供后续调整。
18. **\[工具与渠道]** API 文档按资源、身份及分页方式分组展示参数，突出当前分支的配套字段，并修正必填标记与请求示例，便于直接核对不同接入方式。

## 🐛 修复

1. **\[工作流与 Agent]** 修复循环结束节点引用为空、不完整或来源节点被删除时，画布报错或父容器保留旧输出类型的问题；循环与并行容器统一回退通用数组类型。
2. **\[工作流与 Agent]** 修复 Agent 作为子工具或子应用追问后续跑丢失上下文、计划或回答，以及交互残留影响下游节点或下一轮循环的问题；按节点保存暂停状态，恢复后输出完整回答。
3. **\[工作流与 Agent]** 修复嵌套 Agent 已成功准备沙盒，但根会话仍无法浏览或下载文件的问题；就绪后记录会话实际启用状态，后续轮次未使用沙盒或就绪后出错不会清除此状态，系统与团队权限仍然生效。
4. **\[工作流与 Agent]** 修复同一轮父子或兄弟 Agent、工具调用节点向共享沙盒注入不同来源的同名文件时互相覆盖的问题，自动分配唯一名称并同步模型可见路径；跨节点注入同名同来源文件时复用本轮已分配名称。
5. **\[工作流与 Agent]** 修复不同节点选择技能时互相清除已部署版本及初始化状态的问题；已发布技能版本及成功状态随沙盒缓存保留，缺失目录重新部署后会清除对应旧标记，确保重新初始化。
6. **\[工作流与 Agent]** 修复并发子应用共用沙盒时因初始化锁竞争直接失败的问题，锁繁忙时有界等待重试，超时或租约异常仍返回初始化错误。
7. **\[工作流与 Agent]** 修复工作流及商业版辅助生成在准备阶段收到的停止请求被初始化清除的问题；MCP、定时触发等非 SSE 工作流执行也能响应显式停止。
8. **\[工作流与 Agent]** 修复旧 Agent 的知识库引用回退为手动选择后，残留引用值导致保存失败的问题；Agent 与知识库搜索节点的手动选择会过滤格式异常项，并保留其余知识库选择。
9. **\[工作流与 Agent]** 修复技能编辑沙盒未运行时导出失败的问题，服务端在可初始化状态下先启动或恢复沙盒，等待就绪后再打包；可编辑成员需等待沙盒就绪，只读协作者的导出入口不再受本地编辑沙盒状态限制。
10. **\[工作流与 Agent]** 修复 Agent 传递交互表单时，时间点、时间范围字段丢失已配置的时间粒度及起止限制的问题，保留原配置。
11. **\[工作流与 Agent]** 修复多行文本框在输入法组合输入及确认候选词时重置光标、干扰输入的问题。
12. **\[工作流与 Agent]** 修复工具及表单参数配置弹窗内容较多时无法正常滚动的问题。协作者权限、HTTP 鉴权配置等弹窗中的菜单不再被正文裁切或撑大滚动范围，长菜单可在内部滚动以访问底部选项。
13. **\[工作流与 Agent]** 修复 Agent 最大输出令牌和正文输出开关未完整生效的问题，关闭正文时保留必要交互及节点结果；开启异常捕获后，错误进入异常分支，不再直接拼入可见回答。
14. **\[工作流与 Agent]** 修复 Pi Agent 将旧版必填标记及内部扩展字段直接传给模型，导致工具参数 Schema 被供应商拒绝的问题；工具、沙盒及内置能力统一在模型调用前归一化。
15. **\[工作流与 Agent]** 修复工作流辅助生成时，文本编辑、知识库引用和自定义反馈的字段提示未正确翻译的问题，覆盖简体中文、繁体中文、英文和韩文；文本编辑提示现能完整说明上游输出和全局变量的引用格式。
16. **\[知识库与文件]** 修复知识库集合子树查询及权限同步缺少完整范围约束的问题，遍历和更新现在限定在当前团队、知识库内，避免异常父子引用影响其他知识库。
17. **\[知识库与文件]** 修复阿里云 OSS 流上传已知长度时仍添加分块编码、与 `Content-Length` 冲突而被拒绝的问题。
18. **\[知识库与文件]** 修复解析 `Content-Disposition` 时，带转义引号的文件名被截断的问题，正确还原文件名中的引号和反斜杠。
19. **\[对话体验]** 修复输入引导在连续输入、移动光标后中断或回填范围错误的问题；支持上下键切换、Enter 或 Tab 填充，保留前后文，并避免过期候选或输入法确认按键误触发补全。
20. **\[对话体验]** 修复同会话重复发送被拦截后，错误等待新回复而无法恢复原轮次的问题；回填被拒绝的文字和附件，刷新并恢复已有回复，兼容交互续跑及原回复已结束的情况。
21. **\[对话体验]** 修复仅有应用读取权限的成员无法将自己的会话标记为已读的问题，已读标记仍遵守会话访问范围。
22. **\[对话体验]** 修复同一轮用户消息与 AI 回复共用 `dataId` 时，管理员反馈及关闭自定义反馈误更新用户消息的问题，现在仅更新对应 AI 回复。
23. **\[对话体验]** 修复 Markdown 图片描述包含成对方括号（如 `![Image [1]](...)`）时漏识别图片的问题，图片提取与替换现可正常处理这类描述。
24. **\[对话体验]** 补齐沙盒连接及文件错误提示、技能生成状态和工具版本标签的简体中文、繁体中文、英文及韩文文案，修复部分界面显示内部键名或缺少翻译的问题。同时补齐韩文的账号注销、密码设置与相关审计、知识库标签错误和操作限流提示，问题分类节点的默认选项也使用韩文。
25. **\[对话体验]** 修复发送后刷新页面时，浏览器断流被误判为发送失败，导致已发送文字和附件重新出现在草稿中的问题。
26. **\[模型与计费]** 修复自定义模型端点未填写鉴权时，OpenAI SDK 与 Pi Agent 误用 AI Proxy 或宿主环境凭证的问题，避免将默认凭证发送到自定义地址。
27. **\[团队与权限]** 修复 API Key 过期或额度超限的错误信息包含明文 Key 的问题，错误提示不再暴露凭证。健康检查改从 `Authorization` 请求头读取密钥，减少凭证进入 URL 和访问日志的风险。
28. **\[团队与权限]** 修复只有读取或写入权限的成员仍能移动根目录资源的问题，覆盖应用、工具、知识库、技能及其文件夹，以及知识库内根级集合。
29. **\[团队与权限]** 修复工具文件夹内创建 HTTP 工具时使用错误权限位的问题，具备文件夹写入权限的协作者可正常创建，仅有日志读取权限的成员不再被误放行。
30. **\[团队与权限]** 修复审计详情把部分含冒号的名称、URL 或变更值误作翻译键的问题，系统标签照常翻译，用户内容按原值展示。
31. **\[团队与权限]** 修复账号注销确认弹窗的「取消」按钮未正确使用当前界面语言的问题。
32. **\[团队与权限]** 修复分享页可使用其他发布渠道标识加载公开应用信息的问题，现在仅接受分享渠道。
33. **\[系统与运维]** 修复 CSV 字段以空白、BOM 或制表、换行符开头时可能绕过公式转义的问题，统一加固日志、用量和审计导出。
34. **\[系统与运维]** 修复 Linux 下启用 seccomp 的 JavaScript 代码运行进程在大量输出或背压时因 io_uring 崩溃的问题，启动前回退到 epoll，并保留原有原生隔离。
35. **\[系统与运维]** 修复 MongoDB 4.x 下清除团队 AI 账号或外部工作流变量、移动知识库集合，以及部分对话反馈更新或清除操作因空更新字段而失败的问题。
36. **\[系统与运维]** 修复 OpenSandbox 将 `Pending`、`Allocated` 过渡状态误判为错误的问题，启动或复用沙盒时会继续等待运行就绪后再连接。
37. **\[系统与运维]** 修复沙盒文件元数据查询把权限、连接或命令错误误当成文件不存在的问题，查询失败会明确报错，并正确保留空文件的大小和权限信息。
38. **\[系统与运维]** 修复 OpenSandbox 批量编辑同一文件时只应用最后一处替换的问题，同一文件的多处修改现在按顺序生效。
39. **\[系统与运维]** 修复商业版管理台在数据库缺少系统配置或旧记录缺少 `systemEnv` 时，配置页与实际运行值不一致的问题；从有效的 `config.json` 初始化运行配置，页面仅补齐缺失内容，保留已有站点与套餐配置，避免保存时被默认值覆盖。
40. **\[系统与运维]** 修复日期选择器修改原日期、请求丢失毫秒及图表多查一天导致筛选边界不一致的问题，页面的单日选择、列表、统计与导出保留所选日期的完整范围，模型仪表盘默认展示昨天和今天。商业版应用图表不再因夏令时丢失统计桶，日志与用量 CSV 按请求起点偏移显示时间，避免服务器夏令时干扰。
41. **\[系统与运维]** 修复历史来源名称或异常值导致日志读取失败、筛选及来源统计不一致的问题；无法识别的渠道类型统一归为「未知」，列表、CSV 与商业版来源曲线使用相同分类。
42. **\[系统与运维]** 修复对话日志同时按使用者、反馈和会话搜索筛选时，条件相互覆盖的问题，列表与 CSV 导出现在组合应用全部筛选条件。
43. **\[系统与运维]** 修复 Langfuse 节点属性污染父级追踪、Agent 缺少模型生成记录和用量的问题；并发执行时各节点分别归集用量，避免混入其他节点的数据。
44. **\[工具与渠道]** 修复语音转文字入参校验失败时被包装为普通服务错误的问题，现在返回统一的 HTTP `400` 参数错误。
45. **\[工具与渠道]** 修复插件市场上传工具包时遗漏多语言 README 的问题，同步上传各语言文件，并为工具集及子工具保留对应的说明文档地址。
46. **\[工具与渠道]** 修复繁体中文界面中部分工具名称、简介和标签的繁体翻译为空时显示空白的问题，优先回退简体中文，仍无有效文案时回退英文。

## 🛠️ 代码优化

1. **\[工作流与 Agent]** 统一画布子应用、Agent 子应用工具与旧应用调用节点的执行流程，集中维护文件与变量过滤、记忆隔离、交互恢复、流式控制和用量归集，减少重复实现。插件运行时与调用令牌同步传递用量记录标识，便于后端关联本轮调用。
2. **\[系统与运维]** 新增通用服务端翻译加载器，按请求语言与命名空间加载并缓存资源，缺失文案回退英文或原键名，加载失败可重试；固定每个请求的翻译语言，供服务端输出边界复用。
3. **\[系统与运维]** 新增按业务归档的集成测试用例生成与执行技能，将工作流编排回归用例整理为场景矩阵，支持单页浏览与筛选及手动触发的 Node、无头 Playwright 脚本；未覆盖项和脚本失败由 AI 执行或复核，临时 HTML 报告逐项保留执行方、结果、证据及复测历史。
4. **\[系统与运维]** 新增手动触发的 GitHub Actions 已合并 PR 回移流程，默认目标分支为 `v4.17.x`，可按需修改，完成后生成草稿 PR。仓库维护技能 `fastgpt-backport-pr` 支持向显式指定的维护分支批量回补，机械冲突自动处理、逻辑冲突需人工确认；局部验证后直接推送代码，回补 `v4.17.x` 时对齐 Pro 同名维护分支，对应进行中版本的中英文文档则基于 `upstream/main` 单独提交 PR。
5. **\[系统与运维]** 完善仓库 `pr-review` 技能的审查规范，独立检查功能正确性、重复冗余、可维护性和现行仓库规范，质量问题和明确规范违规也可要求修改，并保留检索、对照实现和条款依据。审查覆盖实现方案、业务约束、安全、性能及 PR 评论、Review 正文和行内讨论；复查结合历史报告与当前完整差异，逐项核对旧问题的修复状态及新增风险。
6. **\[系统与运维]** 文档站支持按语言独立管理草稿，统一过滤路由、导航、搜索和导出；`llms.txt` 改按请求语言输出已发布内容，并保留缺少译文时的已发布内容回退。
7. **\[系统与运维]** 清理独立测评工作区配置及 Pro 中相关脚本、命令和历史资产，精简开发工具配置。
8. **\[系统与运维]** 插件市场的类型检查默认排除工作流核心与 CLI 包，减少跨工作区类型检查干扰。
9. **\[系统与运维]** 升级 Mongoose 至 `8.24.8`、插件 SDK 至 `1.2.0-beta.2`，同步适配插件流式响应类型。
