Dify 1.18.0发布：Agent可选择工作流分支，应用可打包为 .ifpkg
Dify发布 1.18.0 版本，新增Output Routes让Agent决定工作流走向、应用可打包为单个 .ifpkg文件、嵌套工作流运行可追踪；升级需同步更新API、worker、Agent Backend与Agent runtime镜像，源码部署要求Python 3.13。
AI解读：Dify 1.18.0的核心新功能是Agent Output Routes：Agent在完成任务时可以选择工作流分支，每个分支需配置选择条件并连接到下一步，只读的switch输出暴露所选路由。路由启用后，节点级默认值错误处理不可用；未启用路由时保留常规成功出口。
应用导出默认改为 .ifpkg单文件包。Workflow和Chatflow包内联Agents、Skills及其文件，导入时在目标工作区重建这些资源并重新映射引用；仍支持显式YAML导出，文件或URL导入接受两种格式。
嵌套Workflow Tool现在作为子图运行，支持协同暂停、恢复、停止和文件输出，运行历史可下钻查看子工作流内部步骤；查看源应用详情需要访问权限。官方说明嵌套用量与步骤总数仍可能不精确，尤其在暂停或停止之后。
Agent Knowledge Base以Beta形式提供，是可选择性接入的独立服务与数据库，默认Compose安装保持关闭；本地Community Edition开发需显式选择启用。经典Knowledge继续可用，启用该服务不会自动迁移全部经典数据集。
新的OpenAPI操作目录和difyctl客户端支持从命令行创建、导入导出Workflow与Chatflow、发布及版本恢复；旧的 /openapi/v1/apps/{app_id}:run路由被按模式拆分的操作取代，v2客户端不复用v1登录状态，需重新登录。
升级限制明确：/runs只接受组合v2请求，旧runtime无法读取新保存的v2快照，旧的Agent专用AskHuman工具和延迟恢复路径已移除；升级前须备份，并让旧工作流消费者退出后再接入新版本流量。
Dify发布 1.18.0，新增Agent输出路由（Output Routes）、.ifpkg便携应用包、嵌套工作流运行的追踪下钻，以及Beta阶段的Agent Knowledge Base。该版本说明由Dify发布页作者laipz8200发布，升级指南要求API、workers、Agent Backend和Agent runtime镜像一同升级。
Agent可选择工作流分支
启用Output Routes后，Agent v2节点可以在完成任务时选择一条工作流分支。每条路由需要配置选择条件并连接到下一步，例如直接解决请求或转交给专门团队；只读的switch输出用于查看实际选中的路由（#42599）。
路由启用后，节点级的默认值错误处理不可用，但支持出错时停止或走失败分支。普通Agent v2节点会边生成边流式输出文本；结构化结果、路由结果以及使用默认值错误处理的节点仍会缓冲输出（#43986）。
应用打包与嵌套工作流追踪
应用导出默认生成单个 .ifpkg包，Workflow和Chatflow包内联Agents、Skills及其文件。导入时会在目标工作区重建这些Agent并重新映射资源引用，缺失资源会在导入时报告。文件或URL导入同时接受 .ifpkg和YAML，显式YAML导出仍然保留（#42066、#42579、#42626、#42863）。
被调用的Workflow Tool现在作为子图运行，暂停、恢复、停止和文件输出由工作流引擎协同处理；源图在执行前被捕获，因此重新发布工具不会影响进行中的运行。运行历史中可打开单次工具调用，查看其内部步骤，但返回源应用详情前需要访问权限（#40277、#42819–#42822）。
Dify说明，嵌套用量与步骤总数仍可能不精确，尤其在暂停或停止之后；Console下钻与外部trace导出的范围不同。
Agent Knowledge Base与命令行工具
Agent Knowledge Base以Beta形式提供，用于创建知识空间、接入文件或数据源，并在同一处查看文档处理、元数据、检索记录和质量评估。新的Knowledge Retrieval节点和Agent集成共享受访问控制的KnowledgeFS空间，经典Knowledge继续可用。该功能是可选择性接入的独立服务与数据库，默认Compose安装保持关闭（#44165）。
/openapi/v1发布服务器操作目录，difyctl从中发现命令和输入字段，支持Workflow与Chatflow的创建、DSL导入导出、设置、环境变量、发布和版本恢复，草稿哈希用于防止并发编辑被覆盖。旧的路由 /openapi/v1/apps/{app_id}:run被按模式拆分的操作取代，脚本需改用目录中的命令表面（#42487、#42608、#43067）。
升级限制
升级前需备份数据库、向量存储数据、上传文件、Agent快照与工作区存储，以及部署密钥和环境文件。官方要求在同一维护窗口内完成单栈升级，并让进行中的运行结束后再替换旧workers与恢复消费者，避免它们在缺少新取消保护的情况下处理共享队列。
/runs现在只接受组合v2，拒绝v1请求；已有会话快照在读取时转换为v2保存，旧runtime无法读取新保存的v2快照。旧的Agent专用AskHuman工具和延迟恢复路径被移除，历史Agent表单不再恢复执行，共享的Workflow Human Input节点仍受支持（#43833）。
本地Agent沙箱需要非空认证令牌，且 1.17.1 的runtime镜像不支持新的 --require-auth-token标志，需部署匹配的 1.18.0 Agent Backend与Local沙箱镜像。源码部署要求Python 3.13、Node.js 24.22.1或更高的 24.x版本，以及pnpm 12.10.1。已有的PASSWORD_PEPPER配置必须保持不变；原本未设置pepper的安装应保持为空，升级时新设pepper不是透明迁移，需要单独的重置密码计划。
代理边界方面，捆绑的Nginx会用解析出的客户端地址替换X-Forwarded-For，Compose开启转发头处理；若前置负载均衡或Cloudflare，需在这些位置配置可信真实IP，否则访客可能共用代理的限流桶。KnowledgeFS启用前需配置独立数据库与迁移、Capability v2公共验证器、Dify签名密钥、模型配置和工作区切换门槛，且可选服务须通过 /ready而非仅 /health。