dify 1.17.1版本更新全解析：注意Weaviate升级风险与新特性

发布日期：2026年9月12日 版本：1.17.1

重要提示：在启动dify 1.17.1之前，使用内置Weaviate的自托管部署必须进行手动、分阶段的升级。此次内置Weaviate服务将从1.27.0升级至1.39.2，跨越12个小版本，直接跳过任何中间版本将不被支持。如直接拉取镜像并重启，可能会导致向量检索功能受到永久性损害。新部署、使用外部Weaviate或其他向量数据库的环境不受此影响。

dify 1.17.1是一次全面的稳定性更新，新增了知识库API密钥范围控制、支持工作流节点和评论通过键盘移动、插件市场创作者主页、Markdown表单字段名称长度配置等功能。同时，该版本还解决了知识库文档解析、模型供应商迁移、工作流人机互动、Agent会话记忆、服务API分页、OpenAPI合约、并发死锁等多项问题。特别是知识库修复了多个“内容在没有报错的情况下被误索引”的问题。对受影响的CSV、Notion、Excel、PDF、网页抓取和Markdown文档，升级后需重新导入，已建立的索引文本不会自动修复。 球友会

一、升级注意事项：内置Weaviate需分阶段升级 此次升级中，内置Weaviate版本由1.27.0提升至1.39.2，由于跨越了12个小版本，必须按照升级指南完成手动分阶段升级后才能启动dify 1.17.1。忽视该要求直接拉取新版本可能会导致向量搜索功能受到无法逆转的损害。以下情况不受影响： - 新部署的dify环境 - 使用外部Weaviate的环境 - 使用其它向量数据库的环境

二、新增功能：知识库API密钥范围授权 以前，知识库服务API密钥是按整个工作区授予的，一个密钥可访问租户中所有知识库。在dify 1.17.1中，知识库API密钥支持绑定到特定知识库，创建密钥时可在API访问面板中选择授权范围： - 工作区范围 - 当前知识库范围 绑定到特定知识库的密钥只能访问该库的数据，尝试访问其他库会返回403错误。旧密钥保持原有权限，升级后不会影响现有集成。

三、新增功能：工作流支持键盘移动 之前，工作流画布上的节点和评论只能通过鼠标拖动，现在这些对象可以使用方向键移动，包括：单个节点、多节点选择、评论标记、草稿评论等。 按住Shift键可实现更大步伐的移动，并且连续移动时仅会生成一条撤销记录。 球友会

四、新增功能：插件市场创作者主页与首页改版 插件作者可以拥有公开的创作者主页，访问路径为：/marketplace/creator/，其主页将展示所创建的内容。插件市场首页也进行了重新设计，增加了多个新功能，包括顶部视觉区域、横幅轮播和搜索功能等。

五、新增功能：Markdown表单字段名称长度可配置 原来Markdown表单字段名长度限制为128个字符，现可通过环境变量调整最大长度，以满足自动生成字段名较长的需求。默认值仍为128，其字符校验规则保持不变。

六、知识库修复：CSV内容不再误推断 之前，CSV单元格内容在索引前经过pandas的类型推断，可能造成多种错误。此次更新后，CSV内容将不再被错误索引和篡改。 球友会