
2025年6月16日,dify发布了全新版本v1.4.3。此次更新重点围绕系统稳定性提升、功能完善以及用户体验优化展开,涵盖了LLM节点增强、插件支持拓展、界面交互改进等多个方面。本文将为您全面解读dify 1.4.3版本的更新内容、升级指南和具体改进措施,助力开发者和运维人员顺利完成升级,并最大化利用本次版本带来的新功能和改进。
一、dify 1.4.3全新亮点概览
本次v1.4.3版本主要致力于解决多个实际使用中的问题,优化操作流程,并扩展对最新插件和工具的支持,具体优化点如下:
1. LLM节点功能增强
针对之前存在的结构化输出参数丢失问题进行了修复,使得LLM节点的输出更加稳定和完整,从而提升任务处理的准确性和灵活性。
2. 新增对Gemini LLM插件0.2.x版本的支持
通过这一更新,用户能够在Agent应用中无缝集成最新版本的Gemini插件,拓展了系统的兼容性和功能覆盖范围。
3. Markdown按钮交互修复
解决了Markdown格式消息发送异常的问题,保证用户在进行富文本编辑和发送时体验流畅无阻。
4. 登录限制优化
在用户重置密码后,自动清除登录速率限制,避免了误判导致的访问受阻问题,有效提升了账户安全管理体验。
5. 程序界面和文档链接更新
新增应用信息中的作者名称字段,提高应用透明度。同时,统一和本地化文档链接的获取方式,修复错误路径,方便用户快速定位所需技术资料。
6. 文档索引绑定修正
确保文档索引操作严格绑定到对应的会话,有效避免了索引操作脱离上下文带来的错误,提高文档管理的准确性。
7. 会话面板宽度调整优化
对会话面板的模态框宽度调整逻辑进行了优化,改善界面响应速度和交互体验,提升了整体UI的流畅度。
8. 持续集成测试强化
在CI流程中增加了使用Docker Compose运行Oceanbase的VDB测试,提升了测试的全面性和自动化水平。
9. 代码维护与重构
删除了若干废弃代码,优化了SQL数据库查询逻辑,减少冗余,保持代码库整洁高效。
二、详细更新内容解析
1. 核心功能修复及增强
1.1 结构化输出参数修复
在之前版本中,LLM节点结构化输出存在部分参数缺失,导致复杂数据处理时信息丢失,影响自动化流程的准确性。1.4.3已修复此问题,确保输出内容完整且符合标准格式,提升模型响应质量。
1.2 支持Gemini LLM 0.2.x插件
随着Gemini系列插件的迭代更新,为保持兼容性并利用其新功能,dify 1.4.3引入了对0.2.x版本的支持,使用户能享用更先进的模型能力和优化的性能表现。
2. 用户体验改进
2.1 Markdown按钮消息发送问题修正
Markdown按钮无法正常发送消息是用户反馈较多的问题,本次修复保证了通过该按钮发送的消息均能正确到达,改善了编辑器交互体验。
2.2 登录速率限制自动重置
密码重置后登录限制不清除的问题,可能阻碍用户立即访问系统。此问题解决后,系统会自动重置相关限制,确保用户操作连续性和便利性。
3. 文档与界面优化
3.1 应用信息丰富化
新增“author_name”字段,方便管理员和终端用户了解应用开发者信息,提升应用管理的透明度。
3.2 文档链接本地化支持
通过统一的文档链接获取方法,支持多语言本地化环境,修正了部分错误链接路径,有助于国内外用户快速定位所需资源,降低使用门槛。
4. 系统架构及测试
4.1 文档索引绑定Session
确保文档索引过程严格对应当前会话上下文,防止跨会话数据干扰,增强系统运行的逻辑严谨性和数据安全性。
4.2 会话面板模态框调优
对模态框宽度调整逻辑进行了修正,使其响应更加智能和灵活,不论屏幕尺寸如何变动,都能保持良好的视觉和操作体验。
4.3 持续集成测试改进
新增了基于Docker Compose的Oceanbase VDB测试,允许在CI流水线中模拟更真实数据库环境,提升整体代码质量保障。
三、升级指南详解
dify 1.4.3支持两种主流部署方式:Docker Compose和源码部署。下面将分别说明详细升级步骤,确保平滑过渡。
1. 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
后台启动系统,完成升级。
2. 源码部署升级步骤
步骤1:停止服务
结束API服务器、Worker及Web前端服务进程。
步骤2:切换到指定版本分支
.
git checkout 1.4.3
检出1.4.3版本代码。
步骤3:更新Python依赖
.
cd api
uv sync
确保依赖库版本与新代码匹配。
步骤4:进行数据库迁移
.
uv run flask db upgrade
执行数据库schema升级,保证系统数据库结构与新版本兼容。
步骤5:重启服务
依次启动API服务器、Worker及Web前端,完成整个升级过程。
四、开发视角的技术改进重点剖析
1. 数据库查询优化
更新了工作流执行仓库中的序列号查询逻辑,采用数据库内置的最大值函数,避免高频查询造成性能瓶颈。
2. 环境变量扩展
新增环境变量S3_USE_AWS,明确区分是否使用AWS S3服务,便于插件守护进程根据不同场景启动和配置。
3. 代码库清理
通过自动化工具删除废弃代码片段,提升代码整洁度和维护效率,减少潜在隐患。
五、总结与展望
dify 1.4.3版本的发布,明确体现了项目团队对产品稳定性和用户体验的高度关注,并针对当前用户反馈的关键问题进行了精准打磨。同时增加的新功能支持和开发工具优化,为未来功能拓展奠定了坚实基础。