2026年1月16日，Dify 最新版本 v1.11.3 正式发布。本次更新聚焦于性能优化、功能增强与整体用户体验提升。无论是后端运行效率，还是前端交互体验，都进行了全面升级与修复。以下是这次版本更新的详细说明。

---

🚀 新功能介绍

MCP工具增强

该版本为 MCP 工具新增了对 embeddedResource 的支持。MCP 工具现在可以直接在界面中展示，实现更快的访问与更高效的使用。

批量操作能力扩展

文档批量操作功能新增了 “重新索引” 操作。此项功能让数据集处理更加灵活，有助于优化索引重建流程和数据检索性能。

智能体与工作流增强

新增了 AgentMaxIterationError，让智能体和工作流在处理复杂任务时更稳健。此外，对应用模式检查机制进行了改进，让智能体与工作流的运行更加可靠。

OAuth集成升级

前端登录流程新增了 oauth_new_user 参数，用于区分首次使用 OAuth 登录的用户。这一改进有助于提供更灵活的账户接入体验。

PDF内容提取增强

RAG 提取器现在支持从 PDF 中提取图片。这意味着不仅文本信息可以被识别，PDF 中的图片内容也能一并被索引与利用，极大提升多模态信息提取的能力。

存储与归档增强

系统新增了归档存储客户端和相关配置选项，让文件归档和备份更加高效与安全，为企业级数据管理提供更广泛支持。

国际化与翻译支持

版本新增了初步的 RSC 翻译支持，为全球化用户提供更完善的国际化体验，进一步拓展 dify 在多语言环境中的兼容性。

---

🛠️ Bug修复与性能优化

Redis与缓存优化

该版本采用 Redis 管道技术优化缓存删除逻辑，显著提升了缓存清理的速度与可靠性，有助于避免超时和数据残留问题。

UI/UX修复

修复了页面因权限错误崩溃的问题，调整了按钮大小闪烁的现象，解决多项界面微交互问题，确保用户在系统中得到平滑稳定的体验。

数据操作改进

修复了数据集访问错误，强化了批量操作的错误处理能力，使数据导入导出更加安全可靠。

性能稳定性

在高负载场景下，系统会自动释放运行时状态引用，以防止潜在的内存泄漏问题。这对长期运行的系统性能稳定性有极大帮助。

安全性增强

修复了可能影响机器人集成与 Celery 操作的 CORS 与 SSL 问题，从底层强化了系统安全性与数据传输稳定性。

国际化更新

针对韩语翻译进行了全面优化，确保国际化内容更加准确。

---

🔧 底层架构改进

持续集成与构建优化

完善了 GitHub Actions 与构建流程，使系统在版本发布过程中更加稳定、可靠，减少了构建失败与停机风险。

代码与查询优化

从 SQL 查询到数据处理逻辑，多个底层模块进行了优化，显著提升整体稳定性与运行效率。

这一系列底层改进使 dify 的后端操作更加顺畅、安全，并为后续功能拓展打下了坚实基础。

---

🧭 升级指南

Docker Compose 部署方式

1. 备份自定义配置文件（可选）：

   cd docker
   cp docker-compose.yaml docker-compose.yaml.$(date +%s).bak
   

2. 获取最新代码：

   git checkout main
   git pull origin main
   

3. 停止服务：

   docker compose down
   

4. 备份数据：

   tar -cvf volumes-$(date +%s).tgz volumes
   

5. 升级服务：

   docker compose up -d
   

注意事项

如果升级过程中出现数据库连接错误：

failed to connect to `host=db_postgres user=postgres database=dify_plugin`: hostname resolving error

请改用以下命令：

docker compose --profile postgresql up -d

具体说明请参考官方文档说明。

---

源码部署方式

1. 停止 API 服务、Worker 和 Web 前端。
2. 获取最新代码：

   git checkout 1.11.3
   

3. 更新 Python 依赖：

   cd api
   uv sync
   

4. 运行数据库迁移：

   uv run flask db upgrade
   

5. 重启 API 服务、Worker 和前端服务。

---

📋 本次更新的主要变更概览

本次更新包括数百项改动与优化，以下为其要点总结（删去了编号与个人署名）：

• 使用 Redis 管道删除缓存以增强性能。
• 修复成员列表权限更新导致的页面崩溃问题。
• 引入组件重构指南与工具。
• 优化数据验证逻辑，确保先验证再保存。
• 改进国际化加载逻辑。
• 修复被删除工具匹配逻辑及 UI 样式闪烁问题。
• 调整元数据筛选逻辑，使其在重命名后保持有效。
• 新增 MCP 工具直接展示功能。
• 支持并发批处理配置。
• 修复数据集标签错误与访问异常。
• 修复 Redis 锁使用错误。
• 新增透明边框防止按钮闪动。
• 数据集批量操作新增重新索引功能。
• 支持腾讯云 COS 自定义域名配置。
• 优化多模态模式下知识检索节点的稳定性。
• 新增结构化日志（JSON）输出支持。
• 改进错误处理机制与缓存一致性。
• 修复 Celery Redis SSL 调用错误。
• 优化模型总积分系统。
• 改进国际化文件加载逻辑与命名空间。
• 改善模板渲染的转义与 base64 编码处理。
• 增强 OAuth 登录时前端标识支持。
• 优化 App 模板创建权限与 XSS 过滤逻辑。
• 改进 Markdown 转义、Unicode 格式与数据库参数化设置。
• 新增 PDF 图片提取与归档存储客户端。
• 改进 Graph runtime 状态释放与高负载内存管理。
• 优化 OAuth 登录刷新与令牌并发处理。
• 提供统一的国际化 JSON 校验规则与多语言同步机制。
• 支持模型总积分与信用池管理功能。
• 增加文件加密、解密与安全存储机制。
• 修复工作流执行状态异常与应用模式检测错误。
• 前端迁移至 Serwist，用于渐进式 Web 应用支持。
• 优化 Node.js 运行环境、ESLint 规则与构建安全版本限制。
• 优化多种性能参数，包括 Redis、PostgreSQL、Celery 与 Graph 引擎。
• 改进系统事件管理与日志存储策略。
• 新增国际化翻译自动同步工作流。
• 增强数据集创建交互，包括步骤预览与嵌入处理组件。
• 修复刷新令牌死锁问题与 SSE 流空值错误。
• 优化系统启动脚本与超时逻辑设置。
• 优化数字格式处理精度与可用性。
• 改进用户登录刷新、令牌验证与缓存失效机制。
• 对 Docker、CI/CD、迁移文件、国际化、模型字段等进行综合整理。
• 最终完成系统版本提升与标识更新，将 dify 正式升级到 v1.11.3。

---

✨ 总结

代码地址：github.com/langgenius/dify

dify 1.11.3 版本的发布，标志着这个智能工作流与 AI 应用编排平台进入了一个更加成熟与稳定的阶段。本次更新从系统架构到底层引擎，从前端用户体验到国际化支持，几乎涵盖了产品的所有维度。