本次发布确认

Langgenius 于上海时间 2026 年 10 月 23 日 14 时 33 分发布开源应用平台 Dify 正式版 v1.18.0，对应协调世界时 2026 年 10 月 23 日 06 时 33 分。GitHub 仓库为 langgenius/dify，标签为 1.18.0，发布名称为 v1.18.0 — Smarter Agent Routing, Portable Apps, Deeper Workflow Visibility，预发布标记为假，草稿标记为假。仓库描述为可协作构建智能体工作流与 RAG 管道、支持云端与自托管部署的工作区，维护方为 Langgenius 组织。许可证为 Dify 修改版 Apache-2.0，本次发布说明未宣布许可变更，附加多租户与前端标识条件不变。对中国自托管与云端构建智能体应用的开发者有明确版本价值，需按升级指南配套验证。

关键新能力

本次变化均来自维护方当日 Release 说明：其一，智能体可决定工作流分支，新增输出路由与选择条件，只读 switch 输出标识所选分支，普通 Agent v2 节点同时支持流式文本输出；其二，可移植应用包，工作流与 Chatflow 可打包为单个 .ifpkg 文件，携带内联智能体、技能与文件，导入时在目标工作区重建并重映射引用，同时兼容文件与链接导入；其三，嵌套运行可视化，工作流工具调用改为子图运行，可从运行历史钻取子工作流单步，支持协同暂停、恢复、停止与文件输出，访问检查保护源应用细节；其四，可选 Agent Knowledge Base Beta，为智能体提供独立知识空间、文件接入、元数据与检索追踪及质量评估，共用受控 KnowledgeFS 空间，经典知识库保留；其五，开发者工具链，基于服务端操作目录的 OpenAPI 与新版 difyctl 支持工作流创建、DSL 导入导出、设置、环境变量、发布与版本恢复，草稿哈希保护并发编辑，需重新登录，旧版 v1 登录态不复用。

  • 新增智能体输出路由，按条件选择工作流分支并经只读 switch 输出标识。 新增可移植 .ifpkg 应用包，打包内联智能体、技能与文件并跨工作区迁移。 嵌套工作流工具调用改为子图运行，支持暂停恢复停止与单步钻取追踪。 新增可选 Agent Knowledge Base Beta，集中管理知识检索与质量评估，需独立服务。 新增 OpenAPI 与 difyctl v2 命令行，支持创建导入导出发布与版本恢复，需重新登录。 升级要求 API、工作器、Agent 后端与运行时镜像同版，本地沙箱须配置鉴权令牌。

适用对象与兼容性

适用对象为使用 Dify 自托管或云端构建智能体与工作流的团队，包括工作流编排、Chatflow 对话应用、知识库检索与工具调用场景，以及用 difyctl 与 OpenAPI 做批量管理的开发者。兼容与运行条件以当日说明为准：源码部署要求 Python 3.13、Node.js 24.22.1 及以上 24.x 线、pnpm 12.10.1，需刷新锁定依赖并执行数据库迁移后重建前端；Docker Compose 部署需保留数据库、向量数据、上传文件、智能体会话存储与全部密钥及环境文件，先备份再停旧栈切换至 1.18.0 标签拉取启动；difyctl 提供多平台二进制，当日附件含 darwin-arm64、darwin-x64 与 linux-arm64 等，另有校验文件，macOS 与 Linux 开发机可直接获取，标准 KnowledgeFS 引擎 worker 镜像目前仅提供 amd64。

迁移与访问条件

获取方式为 GitHub 仓库 langgenius/dify 的 1.18.0 标签页，属正式版通道，可经 Docker 标签或源码分支跟进，difyctl 需安装同版 1.18.0 客户端并重新执行登录。迁移必须同版升级 API、工作器、Agent 后端与 Agent 运行时镜像，/runs 仅接受 composition v2 并拒绝 v1 请求，旧会话快照读取时转换保存为 v2，旧运行时无法读取新版快照；本地 Agent 沙箱须配置非空高熵鉴权令牌，1.17.1 运行时镜像不支持新版必需参数；保留现有 PASSWORD_PEPPER 配置，升级期间新增胡椒值不是透明迁移，需另行制定密码重置计划；让在途运行结束后再替换旧版工作器与恢复消费者，避免旧队列处理缺少新取消保护；直接集成 Agent 后端的应用须更新请求格式，旧版 AskHuman 工具与延迟恢复路径已移除，共享工作流人工输入节点仍受支持。

限制与必要下一步

限制有四：其一，维护方未公布中国区单独说明、性能对比与完整回归范围，云端 dify.ai 的新知识库体验标注即将可用，境内网络可达性与备案要求需自行验证；其二，本次未列为安全修复，未披露 CVE 编号与受影响版本区间，不宜据此判断历史版本安全状态，打包 Nginx 默认以解析客户端地址替换转发头，直接 API 访问仍应限制为可信调用，负载均衡前需另行配置真实 IP 透传，否则可能共用限流桶；其三，嵌套用量与步骤统计在暂停或停止后仍可能为近似值，控制台钻取与外部追踪导出范围不同，知识库可选服务需独立数据库、签名密钥、模型画像与工作区切换门控，通过就绪检查方可放行；其四，修改版 Apache-2.0 附加多租户运营须书面授权、前端标识不得移除等条件，外观交互另受外观专利说明约束，不对维护持续性与商业许可结果作保证。必要下一步为：在维护窗口备份数据与密钥后于测试环境同版升级并验证输出路由分支、应用包导入导出、嵌套追踪钻取与 difyctl 登录操作，再小范围推广；继续跟随同一仓库后续发布页，不补发往日版本。