11 月 4 日，Dify 发了 1.19.0，主题叫「Trace Your Workflows, Layer by Layer」。离 10 月 23 日的 1.18 只隔了 12 天，这次没加什么新节点，重点全在「出了事能不能查到」——Workflow Tool 调子流程、子流程里再调模型，这一层层的关系，现在能原样出现在 Langfuse 这类可观测工具里。
先看体量：16 万星的应用工厂
Dify 的定位没变，还是那四个字：开源应用工厂。画布编排（Workflow / Chatflow）、知识库、独立 Agent 后端、插件市场，四块拼起来，产出的不是一张图，而是一个带知识库、日志、成员权限的应用。GitHub 160,431 星、25,372 个 fork（11 月 5 日数据），仍然是这条赛道里体量最大的开源项目。
之前那篇基础篇讲过它是什么、怎么装；1.18 那版讲了 Output Routes 和应用打包。这篇只讲 1.19 的增量。
1.19 只干三件事
一、子流程里的每一步都能追
以前外部 trace 到 Workflow Tool 这一层就断了：你知道这个工具跑了 3 秒，但不知道里面调了几次模型、哪一步慢、重试了几回。1.19 把子流程里持久化的执行步骤挂到调用它的 Tool span 下面，重复调用和失败重试各占各的位置，格式化后的 prompt、响应、token 用量跟着执行树一起出去。
接出去的后端名单不短：Langfuse、LangSmith、Opik、Weave、Arize、Phoenix、阿里云、MLflow、Databricks、腾讯。有几个前提得说清楚：只对新执行生效，历史 trace 不回填；独立嵌套的 workflow run 仍然是两条 trace，用 parent ID 关联，不会硬拼成一棵树。
二、应用包把 Workflow Tool 一起带走
.ifpkg 现在会把 Workflow Tool 背后的工作流一起打包，按绑定版本走，含传递依赖，默认最多带 20 个。导入到新工作区时，已有的工具直接复用，缺的自动创建、发布、注册，再把引用重映射过去。所有应用导出统一升到 package format v2，没有 Workflow Tool 的应用也是；v1 导入和显式 YAML 导出继续支持。
三、Skill 进命令行，Agent 文件能批量传
difyctl 补了六个 Skill 命令：get skill、describe skill、get skill version、export skill、import skill、publish skill。导入不等于发布，覆盖已有 Skill 会被归为破坏性操作，操作目录和 CLI help 里都标了。另一头是 Agent 配置文件：多选批量、并行上传、原子绑定，PDF 能内联看，源码带高亮和行号，文本被截断会明确提示。
上手：这版升级比安装更费劲
新装还是老样子，起容器、访问 /install 建管理员。麻烦的是从 1.18 升上来，几个硬条件绕不开：
- Docker Compose 必须 2.35.0 以上，新版 root
.env的覆盖优先级变了 - API、worker、web、Agent Backend、沙箱镜像要同版本，插件守护进程升到 0.6.14-local
- 从 1.18 上来要跑 6 个 migration，终版是
53c10126d551 - 滚动升级时新任务默认进
ops_trace_v2队列，API、worker、Beat 必须一致；旧的ops_traceworker 要等队列排空再撤，不能直接清队列 - 源码部署换成 Python 3.13、Node 24.22.1（24.x 线）、pnpm 12.16.1
cd dify/docker
docker compose stop -t -1
git fetch --tags
git checkout 1.19.0
docker compose pull
docker compose up -d
动之前先备份：数据库、向量库数据、上传文件、Agent 快照和工作区存储、.env 和密钥，一个都别落。
实话
一，这版不让你做出更强的 Agent，只让你出错时少猜。没接 Langfuse 之类的后端，嵌套追踪对你等于零；接了但没跑多级 Workflow Tool，收益也有限。
二，v2 包是单向门。新包导进还在 1.18 的实例，可能直接被拒。团队里有人没升级，导出前先说清楚。
三，升级门槛比上一版硬。Compose 版本、6 个 migration、双队列过渡，一个人维护的自托管实例别赶在忙的时候升。
四，12 天一版，跟版要克制。1.19.0 才发一天，等 1.19.1 修一轮更稳；已经在跑多级 Workflow Tool、又接了可观测后端的团队，这版值得当天升——出问题能一眼看到是哪层子流程、哪次 LLM 调用拖的时间。横向位置还是那句：Dify 在十家平台横评里属于「卖画布」那一档，但它是这批画布里唯一自带完整应用生命周期的一块。
