dify 1.17.1版本更新：全面提升与注意事项

发布日期：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自带Weaviate的自托管环境，必须按照升级指南完成手动分阶段更新，才能启动dify 1.17.1。如果忽略此要求，直接启动新版本可能会静默破坏向量搜索功能，并可能造成永久损害。以下情况不受此影响： • 新部署的dify环境 • 使用外部Weaviate的环境 • 使用其他向量数据库的环境

二、新增功能：知识库API密钥按范围授权 以前，知识库服务的API密钥是基于整个工作区授权的，一个密钥可以读取和写入租户中的所有知识库。这意味着一旦某个集成获得了访问某个知识库的权限，实际也就相当于可以获取工作区内所有知识库的访问权。在dify 1.17.1中，知识库API密钥现在支持绑定至特定知识库。创建密钥时，可在知识库的API访问面板中选择授权范围： • 工作区范围 • 当前知识库范围 绑定到特定知识库的密钥只能访问该知识库的数据，若试图访问其他知识库，则会返回403错误。对于不携带知识库ID的接口，比如列出所有知识库的接口，绑定型密钥也无法访问。已有的旧密钥不会被自动调整，仍持有工作区范围的原有权限。升级后对现有集成和调用逻辑不会造成影响。

三、新功能：工作流节点与评论支持键盘移动 此前，工作流画布上的节点和评论只能通过鼠标拖拽来移动。现在，工作流中的以下对象可以通过方向键来进行移动： • 单个节点 • 多节点选择 • 评论标记 • 草稿评论 • Note节点 • Iteration节点 • Loop节点 按住Shift键用方向键可进行更大步幅的移动。连续的按键移动时，系统将在松开按键后统一提交位置变更，因此连续移动只会记录一条撤销，而非每按一次方向键就生成一条撤销记录。只读模式、容器边界限制及协作更新规则也会被正确遵守。

四、新功能：插件市场创作者主页及首页改版 插件创作者现在拥有公开的创作者主页，访问路径为：/marketplace/creator/，主页展示了他们创建的内容，并提供发布者侧边栏信息。侧边栏的帮助菜单中新增了Creator Center入口，方便访问创作者相关页面。插件市场首页也经过重新设计，增加并调整了以下内容： • 顶部主视觉区域 • 横幅轮播 • 吸顶搜索 • 目录标签页 • 标签筛选 • 语言筛选 • 移动端堆叠与滑动布局 此外，Bundles不再与插件分类混合展示。

五、新功能：Markdown表单字段名长度可配置 之前，Markdown表单字段名称的长度限制被硬编码为128个字符。在某些自动生成字段名较长的场景中，固定长度限制可能无法满足需求。现在可以通过环境变量进行上限调整：Docker部署使用：MARKDOWN_FORM_FIELD_NAME_MAX_LENGTH，直接部署Web前端时使用：NEXT_PUBLIC_MARKDOWN_FORM_FIELD_NAME_MAX_LENGTH，默认值仍为128。字段字符验证规则及原型污染防护机制保持不变。

六、知识库修复：CSV内容不再被错误推断与篡改 此前，CSV单元格在经过pandas类型推断后被索引，这导致多个内容错误问题，例如带前导零的编码等问题。