11 月 4 日,Dify 发了 1.19.0。
距离 10 月 23 日的 1.18.0,只隔了 12 天。
这个节奏放在任何一个开源项目上都算激进。更值得注意的是这一版的内容——它几乎没给你加任何新东西。没有新节点,没有新玩法,主题只有一句:「Trace Your Workflows, Layer by Layer」。
一周过去,我翻了发布说明、社区 issue、还有第三方监测的下载数据。结论先说:这是一版"运维友好、产品克制"的更新,但它的门槛也悄悄抬高了,急着升的人不多。
一、一周的下载情况:热度在,但升级意愿不高
先说能拿到的数据。Dify 官方从来不单独公布某个版本的镜像下载量,所以我们只能看几个侧面:
GitHub 侧:
-
Star 数从 11 月 5 日的 160,493 涨到 11 月 12 日的 161,006,一周净增约 500。 -
Fork 25.5k。 -
90 天内发了 4 个版本,1.19.0 是第 4 个。 -
近 30 天提交 980 次,149 位贡献者,其中 83 位是新人。
下载侧:
第三方监测(HVTracker)给出的口径是:npm + Docker + PyPI 合计,7 天下载 25,907,951 次。
这个数字很唬人,但得说清楚它的性质——它是全渠道聚合、包含所有版本和依赖包,不是"1.19.0 被拉了多少次"。拿它当"1.19.0 火了"的证据是不成立的。
真正值得看的是社区氛围。
一周下来,GitHub 上关于 1.19.0 的讨论,绝大多数不是"这个功能太好用了",而是"升级之后这里报错了""这个版本还能不能回退"。而且到 11 月 14 日,1.19.1 还没发。
按 Dify 过去的习惯,大版本之后十来天出补丁是常态。这次没出,说明要么问题不算严重,要么还在修。对自托管用户来说,这就是个明确的观望信号。
一句话概括这一周:热度是平台的,不是版本的。 大家在用 Dify,但不急着用 1.19。
二、这版真正的亮点:把"黑盒"打开了一层
虽然是"运维版",但对踩过坑的人来说,这三个功能是真的有用。
亮点 1:嵌套 Workflow Tool 能一路追到底(头号更新)
以前的痛点是:你调了一个 Workflow Tool,外部 trace 里只显示"这个工具跑了 3 秒"。至于这 3 秒里它调了几次模型、哪一步慢、重试了几回——完全看不到,那是个黑盒。
1.19 把子流程里持久化的执行步骤,挂到了调用它的 Tool span 下面。子步骤出现在父 span 里,嵌套和重复调用都保持层级。格式化后的 prompt、响应、token 用量、trace 链接,都跟着每次 LLM 调用一起出去。
接出去的后端名单不短:Langfuse、LangSmith、Opik、Weave、Arize、Phoenix、阿里云、MLflow、Databricks、腾讯。
三个前提得说清楚,不然你会白高兴:
-
只对新执行生效,历史 trace 不回填。升级前的问题,照样查不到。 -
独立嵌套的 workflow run 仍然是两条 trace,用 parent ID 关联,不会硬拼成一棵树。 -
你没接任何可观测后端,这个功能对你等于零。
所以这条的判断很简单:接了 Langfuse 这类后端、并且工作流里有多级 Workflow Tool 的团队,这版值得当天升。 其他人可以先放着。
亮点 2:应用包会把 Workflow Tool 一起带走
之前导出一个 .ifpkg,Workflow Tool 背后的工作流是不跟着走的。换到另一个工作区导入,工具全断了,得手动一个个重建。
现在 .ifpkg 会把被调用的 Workflow Tool 按绑定版本一起打包,含传递依赖,默认最多带 20 个。导入时,目标工作区已有的工具直接复用,缺的自动创建、发布、注册,再把引用重映射过去。
但这里有个单向门,必须提醒:
所有应用导出统一升到了 package format v2。v2 包导进还在 1.18 的实例,可能直接被拒。 团队里只要还有一个人没升级,你导出的包他打不开。
官方建议是先升目标环境再导入。翻译成人话:导出前先在群里问一句"都升了吗"。
亮点 3:Agent 文件能批量传,PDF 直接看
这个功能小,但用起来最舒服。
Agent 配置文件支持多选、拖拽、并行上传,成功的上传一次性原子绑定,并发保存时保留最新文件。
预览也补了:PDF 内联渲染,源码文件带语法高亮和行号,文本被截断会明确标出来。PDF 加载不出来时给下载入口。
以前调 Agent,改五个配置文件得点五次、等五遍,现在一次搞定。
附带一个:Skill 进了命令行
difyctl 补了六个 Skill 命令:get skill、describe skill、get skill version、export skill、import skill、publish skill。
需要账号调用方身份、对应的 workspace 权限、并且开启 Skills 才行。
一个坑:导入不等于发布。 而且导入覆盖已有 Skill 被归类为"破坏性操作",操作目录和 CLI help 里都标了。手快的人容易把线上 Skill 冲掉。
三、一周里暴露出来的问题,有几条挺要紧
这部分是重点。有些是 1.19.0 自身的,有些是这一周才被翻出来的。
问题 1:MCP 工具报错了,工作流却记成成功(最需要警惕)
11 月 12 日,社区报了 issue #46107。
现象:MCP 工具明确返回 isError: true,Dify 把它当成普通工具输出处理了,MCPTool._invoke 不抛异常,而是生成一条文本消息。
后果很严重:
-
工具节点被记成"成功" -
失败分支不触发 -
重试策略不执行 -
默认值兜底不走 -
Agent 把这个调用当成正常的观察结果
错误文本本身还在,但流程控制里的失败信号丢了。
报告者用 mock server 复现了:数据库工具返回连接被拒 + 错误标记,Dify 那边一切照常,像没事一样往下走。
对应的修复 PR #46108 已经提了,思路是检查 isError 后抛 ToolInvokeError,走和插件/内置工具统一的错误处理路径,同时保留服务端返回的文本,让 Agent 有机会自己修正。测试也加了,覆盖"带文本的错误结果"和"只有非文本内容的错误结果"两种。
但截至 11 月 14 日,这个 PR 还是 open 状态,等 code owner review,没合。
如果你有依赖 MCP 工具、并且靠失败分支做降级的流程,这一条现在就得自己防:在 MCP 节点后面加一层显式的结果校验,别指望 Dify 帮你判失败。
问题 2:混合检索的加权分数,把两种分数混着算了
11 月 10 日的 issue #45953。
混合检索的 Weighted Score 路径,可能把全文检索的相关性分数(BM25、ts_rank 这类)直接当向量余弦相似度用了。
社区给了一个测试案例:向量权重 0.6、关键词权重 0.4。
-
文档 A:实际余弦相似度只有 0.30,但 BM25 给了它 7.4 分 → 融合分 4.84 -
文档 B:分数 0.892
结果 A 排到了 B 前面。
作者明确说了,这只是测试用例,不代表所有后端真实的分数分布。但这个量级差得有点离谱——0.30 相似度的东西压过 0.892 的,说明两套分数根本没在同一个尺度上。
修复 PR #45954 的思路:给全文检索结果打来源标记,去重时优先用向量检索那份,语义分数从存储的向量或文档 embedding 重算。reviewer 提醒说 embedding 缓存未命中会多一次模型调用,作者补了"向量权重为 0 时跳过 embedding 计算"的逻辑。
同样,截至 11 月 14 日还是 open,没合。
实际影响:如果你开了混合检索 + 加权分数,又觉得"召回结果有时候怪怪的",这可能就是原因。在修复落地前,建议先用固定查询集测一下纯全文命中的场景,看看排序是否合理。
问题 3:Agent 节点上传的图片,没传给视觉模型
issue #45434,对应 PR #45745。
Workflow/Chatflow 里的 Agent 节点,用户上传的图片没有被送到模型那边。等于你给了图,模型压根没看见。
这个对做多模态应用的团队是硬伤。修复合了没?PR 编号比上面两个小,状态需要你自己在仓库确认——但这个问题本身值得先自查一遍。
问题 4:清空节点列表,反而删了整个数据集索引
issue #45988:clean(node_ids=[]) 传一个空列表进去,预期是"什么都不删",实际把整个数据集索引删了。
这个属于典型的边界条件翻车。空数组、空字符串、null 这类"什么都没传"的情况,逻辑上最容易被写成"那就全清吧"。
教训很直接:任何带 clean、delete、reset 语义的接口,先用空参数试一次。 别在生产知识库上试。
问题 5:沙箱硬编码凭证,CVE 已经挂出来了
11 月 5 日,CVE-2026-123135 公开:api/configs/feature/__init__.py 里的 Sandbox Run Handler 存在硬编码凭证问题。
影响范围写的是 up to 1.18.0 / 2.0.0-beta.2。
CVSS 评分各口径不一:VulDB 给 2.1(LOW),CNA 声明 5.3(MEDIUM),CVSS 3.1 是 6.3。EPSS 只有 0.00214,实际被利用概率不高。
但"硬编码凭证"这四个字,对自托管用户从来不是小事。升级到 1.19.0 至少能让你离开这个明确列出的影响范围——这也是这周少数几个"支持升级"的理由。
顺带一个信号:2.0 beta 已经在跑了
CVE 的影响版本里出现了 2.0.0-beta.0/1/2。
也就是说,1.19 刚发,2.0 的 beta 已经在测试线上了。结合 12 天一版的节奏,你能感觉到这个项目的推进速度——1.x 的每个小版本,都更像是在给 2.0 铺路,而不是在给你加功能。
四、升级前,这五道关你得先过
这是这版最容易被低估的部分。从 1.18 升上来,不是 pull 加 up 就完事。
第一关:Docker Compose 必须 2.35.0 以上。
注意,上一版(1.18)的要求还是 2.24.0。这次直接跳到 2.35.0。很多服务器上装的还是 2.20 出头,一升就报错。
先查,不够就先升 Compose。
第二关:所有镜像必须同版本。
API、worker、web、Agent Backend、沙箱镜像,版本号必须一致。插件守护进程单独升到 0.6.14-local。
混版本是这版最容易出的问题——agent_backend 和沙箱的协议是紧耦合的,一个 1.18 一个 1.19,直接握手失败。
第三关:6 个 migration,终版是 53c10126d551。
跑完确认版本号对上了,再往下走。
第四关:双队列过渡,别急着清。
滚动升级时,新任务默认进 ops_trace_v2 队列。API、worker、Beat 三个必须配置一致,否则任务一边进新队列、一边没人消费,trace 就丢了。
关键:旧的 ops_trace worker 要等队列排空再撤,不能直接清队列。 直接清 = 升级期间那批 trace 全丢。
第五关:root .env 的覆盖优先级变了。
新版改了变量覆盖顺序。如果你之前在 docker/envs/ 下面放过定制配置,升级后要重新确认一遍生效顺序,不然你以为改了的配置其实没生效。
另外,源码部署的同学注意:Python 换到 3.13,Node 24.22.1,pnpm 12.16.1。
五关过完,你才拿到一个能正常跑的 1.19.0。
五、所以,到底升不升
给个明确的分档判断,别含糊:
建议立刻升:
-
已经接了 Langfuse / LangSmith 这类可观测后端 -
工作流里有多级 Workflow Tool,出问题时只能靠猜 -
还在 1.18 及以下,想离开 CVE-2026-123135 的影响范围
这三类人,1.19 的价值是实打实的——出问题能一眼看到是哪层子流程、哪次 LLM 调用拖的时间。
建议等 1.19.1:
-
单人维护的自托管实例 -
生产环境跑着关键业务,没有回滚预案 -
依赖 MCP 工具做核心链路
理由很实在:MCP 错误处理和混合检索这两个 PR 都还 open 着,等它们合了再升,能省一轮折腾。
建议先别动:
-
团队里有人还在 1.18 及以下,并且要用 .ifpkg传应用——v2 包是单向门 -
工作流里没有多级 Workflow Tool,也没接可观测后端——这版对你几乎零收益
写在最后
Dify 这一年的版本线,其实有一条很清楚的主线。
1.16 到 1.18,它在拼命把 Agent 做出来——独立后端、沙箱、路由、知识库。功能上是加法,节奏很猛。
到 1.19,画风突然变了。它不加东西了,开始回头补"出了事能不能查到"。
这个转向我觉得是对的,但也说明一个现实:Agent 平台走到今天,瓶颈已经不在"能不能做出来",而在"做出来之后你敢不敢放到生产上"。 而敢不敢,取决于可观测性、取决于错误处理、取决于一个失败的工具调用会不会被静默吞掉。
1.19 补了追踪这一层,但这一周暴露的问题恰恰说明——错误处理那一层,还没补完。 MCP 的 isError 被当成功、空列表删全库、混合检索分数混算,本质上都是同一类问题:边界情况没兜住。
所以对这版的判断是:方向对了,火候没到。
追踪能力值得你现在就去接;但要不要立刻把生产环境搬上去,我的建议是再等一个补丁版本。毕竟这一版最讽刺的地方在于——它花了一整个版本来教你"怎么把问题看清楚",而它自己的问题,恰好还没修完。
往期经常博文
Dify v1.18.0 发布:Agent 开始自己选路了
Dify 憋了半年,下一个版本或将彻底重构:从 RAG 2.0 到图引擎重写,它到底在憋什么大招?
Dify v1.18.0 安装避坑指南:少填这一个 Token,Agent 死活起不来
Dify 的下一步:从工作流工具到 Agent 操作系统,它想做什么?
Dify社区群:嗨聊吧
欢迎扫码加入嗨聊吧!

