Dify v1.14.0 版本主要围绕团队协作能力、HITL(人工审核)流程扩展、MCP 协议支持以及底层架构优化进行更新。以下是本次版本的主要变更内容。
一、工作流多人协作
本次版本引入了工作流实时协作功能。同一工作空间的成员可以同时编辑同一个工作流,画布变更会实时同步,并显示在线成员的操作位置。
该功能在自部署环境中默认关闭。如需启用,需在环境变量中配置:
ENABLE_COLLABORATION_MODE=trueSERVER_WORKER_CLASS=geventwebsocket.gunicorn.workers.GeventWebSocketWorkerNEXT_PUBLIC_SOCKET_URL=wss://your-domain.com
二、HITL Service API
v1.14.0 为 HITL(Human-in-the-Loop,人工审核)节点提供了 Service API 支持。此前 HITL 仅能在控制台界面操作,现在可以通过 API 以编程方式接入人工审核流程,便于将审核环节集成到外部业务系统中。
三、MCP 协议与插件优化
• MCP 工具元数据同步:MCP 工具更新后,UI 会自动刷新元数据,避免配置不一致。
• MCP Server URL 修复:修复了 URL 中重复的 `/v1` 路径导致 OAuth 授权失败的问题。
• MCP Schema 类型映射:修正了 `checkbox` 和 `json_object` 类型的发布逻辑。
• 插件策略持久化:优化了插件的自动升级策略,修复了本地安装器和文件输入行为,增强了租户范围的 API 端用户查找。
四、前端架构与交互改进
• UI 组件库迁移:前端组件持续迁移至 `@langgenius/dify-ui` 统一组件库,新增 PreviewCard、Meter 等基础组件,统一设计令牌。
• Prompt 编辑器:输入 `/` 可触发变量过滤,支持键盘上下键在变量列表中快速切换。
• Go To Anything(Cmd+K):优化了性能,支持跳转到最近使用的项目和应用子页面,修复了动态导入导致的快捷键失效问题。
• 交互与无障碍:优化了日期时间选择器、模型选择器滚动条的可见性,修复了 GitHub OAuth 登录时邮箱为空时的异常。
五、基础设施与性能优化
• 工作流性能:优化了 Graph 初始化性能,工作流加载和解析速度有所提升。
• Docker 健康检查:为 `api`、`worker` 和 `worker_beat` 容器增加了健康检查配置。
• Celery Worker:默认并发数从之前的值提升至 4,修复了缺失的队列配置。
• PostgreSQL:应用数据库路径的默认 `max_connections` 提升至 200。
• Redis:支持自定义 Key 前缀,并增加了操作重试逻辑。
• TiDB:修复了 TiDB 状态变更时的端点更新问题,优化了 Qdrant 端点与 TiDB 认证绑定的迁移。
• Markdown 渲染:新增 `ALLOW_INLINE_STYLES` 环境变量,允许在渲染的 Markdown 中使用内联 CSS。
六、可观测性与计费
• Langfuse 集成:支持上报 Time-To-First-Token (TTFT) 指标,便于监控模型首字响应延迟。
• 探索页分析:新增 Banner 曝光追踪和应用卡片预览事件追踪。
• 计费系统:接入 Quota v3,优化了基于 Meter 的用量展示,提升了计费 API 异常时的处理稳定性。
七、安全加固
• 修改邮箱流程:修复了 GHSA-4q3w-q5mc-45rq 中提到的 Token 阶段校验不严的问题。
• 越权访问(IDOR)修复:加强了数据源绑定、数据集和 API 的租户所有权校验。
• 代码架构迁移:大量接口迁移至 SQLAlchemy 2.0 的 `select()` 语法和 Pydantic `BaseModel`,提升类型安全;部分遗留控制台 API 标记为废弃。
八、升级指南
Docker Compose 部署:
# 1. 停止服务docker compose down# 2. 备份数据tar -cvf volumes-$(date +%s).tgz volumes# 3. 更新代码git fetch --tagsgit checkout 1.14.0# 4. 重新启动(自动执行数据库迁移)docker compose up -d
源码部署:
# 1. 停止 API Server、Worker 和 Web Frontend Server# 2. 更新代码git fetch --tagsgit checkout 1.14.0# 3. 更新依赖并执行数据库迁移cd apiuv syncuv run flask db upgrade# 4. 重启服务
更多信息请参考 GitHub Release 页面和官方文档。
GitHub: https://github.com/langgenius/dify
文档: https://docs.dify.ai
夜雨聆风