Dify 1.19.0发布：外部追踪可下钻到嵌套工作流工具内部步骤
Dify发布 1.19.0，外部追踪新增被调用Workflow Tool内部的执行步骤层级，应用包格式统一为v2，Skill可通过OpenAPI与difyctl管理；历史追踪不会被回填。
AI解读：Dify 1.19.0的核心变化是嵌套工作流追踪：外部追踪现在会包含被调用Workflow Tool内持久化的执行步骤，子步骤显示在调用它的Tool span之下，嵌套与重复调用保持原层级。该功能建立在 1.18.0 的Console下钻能力之上。
新追踪适用于新的执行，历史追踪不会被回填；独立嵌套的工作流运行仍是单独trace，通过parent标识关联。升级指南要求滚动部署时让API、worker、Beat就新追踪队列ops_trace_v2保持一致，旧追踪worker需等旧队列积压处理完再切换。
应用导出统一使用包格式v2，并会带上Workflow Tool背后的工作流及其传递依赖，默认最多打包 20 个工具工作流；导入时复用目标工作区已有工具，缺失的会重建、发布并重新映射引用。旧版v1导入仍受支持。
Agent文件支持多选或拖放后并行上传，成功上传以一次原子批量绑定；预览支持内联阅读PDF、源码语法高亮和截断提示。Skill Hub方面新增Export/Import/Publish等命令，导入不会自动发布。
升级限制包括Docker Compose需 2.35.0 或以上、源码部署使用Python 3.13与Node.js 24.22.1及以上、从 1.18.0 升级执行六个迁移至 53c10126d551，以及提取修复只影响新处理内容、已存重复PDF资产不会被清理。
Dify发布 1.19.0。按发布说明，这一版让外部可观测性工具能看到被调用Workflow Tool内部的执行步骤：子步骤挂在调用它的Tool span下，嵌套和重复调用保留层级，并可查看格式化后的提示词、响应与token用量。该能力延续 1.18.0 在Console中加入的下钻功能。
嵌套追踪覆盖到哪一层
发布说明称，新外部追踪包含被调用Workflow Tool内持久化的执行步骤，从外层工作流一路到嵌套的LLM调用；Langfuse、LangSmith、Opik、Weave、Arize、Phoenix、阿里云、MLflow、Databricks、腾讯等提供方通过共享接口统一投递，可重试的导出会用确定性标识重发同一追踪单元。
范围有两项明确限制：更丰富的层级只适用于新执行，历史追踪不会回填；独立嵌套的工作流运行仍是分开的trace，通过parent标识关联。滚动升级时新任务默认进入ops_trace_v2队列，API、worker、Beat必须一致，自定义队列列表需包含新队列；旧追踪worker应留在ops_trace，直到旧生产者及其排队、活动、预定和重试任务全部结束。
- 子步骤显示在调用它的Tool span之下，保留嵌套与重复调用的层级
- 追踪凭据改为只写；更改目标主机、端点或URL需重新输入密钥
- 追踪配置按app/provider保留一条并加唯一索引，重复时保留最近更新行，降级索引不会恢复被删行
应用包与Skill管理
应用导出现在一律使用包格式v2，包括不含Workflow Tool的应用；包内会带上被调用Workflow Tool背后的工作流及传递依赖，默认上限为 20 个工具工作流。导入时目标工作区已有的工具直接复用，缺失的工具会被重建、发布并重新映射引用，这需要工具管理权限和足够应用配额。旧版v1导入与显式YAML导出仍可用，但YAML不携带打包的工具工作流依赖；发布说明提醒先升级接收端再导入新包，旧导入器可能拒绝v2包。
Skill方面新增六条difyctl命令，覆盖列出、查看详情、列出版本、导出草稿或已发布版本、从本地文件导入以及发布草稿。说明明确导入不等于发布，覆盖已有Skill被归为破坏性操作；导入时SKILL.md名称须与目标匹配，可选的draft_hash校验使用秒级时间戳，无法识别同一秒内的修改。
- difyctl get/describe skill、get skill version、export skill、import skill、publish skill
- 这些操作要求账号调用者、对应工作区权限且已启用Skills
- 实验性包 @dify/openapi-content-mapper提供按OpenAPI推断的类型化调用，发布说明称尚未迁移生产Console或Marketplace调用
升级前的硬性条件与影响范围
发布说明给出多项部署约束：Docker Compose最低 2.35.0；源码部署使用Python 3.13、Node.js 24.22.1或 24.x中更高版本、pnpm 12.16.1，且pnpm不再代为安装Node.js，需要单独安装。从 1.18.0 升级执行六个迁移，终点为 53c10126d551；组件需同版本一起升级，内置插件守护进程为 0.6.14-local。
数据层面的影响被单独列出：EPUB、EML、DOCX、CSV、Markdown或Notion提取修复只影响新处理的内容，受影响的已存文档需重新导入或重建索引；重复PDF预览修复只阻止新增重复资产，不清除已存重复项。新增的存储清理索引会扫描数据并占用I/O，中断留下的无效索引应先排查再重试。
- Agent文件支持并行上传和一次原子绑定，Composer并发保存保留最新文件
- 预览覆盖已配置文件、Skill成员和工作目录文件，PDF无法加载时提供下载
- Gunicorn keep-alive默认 10 秒；Cloud配额显示区分不限次数与零容量