⏰ 发布：2026-09-13
⭐ 版本：v1.17.1（2026-09-10 发布）
🆓 费用：免费开源
用 Dify 搭知识库的朋友注意了，这版修复集中在你最容易踩的坑上：CSV 前导零变浮点、Notion 表格丢列、PDF 解析崩溃，全都是入库错误但不报错的那种。另外自建部署有一个必须先做的事，往下看。
📦 v1.17.1 - 2026年9月10日
这次更新一句话：知识库抽取类 bug 集中修复，工作流 Human Input 节点补齐多个状态机缺陷，知识库 API Key 可以按库绑定权限了。自建用户升级前必须先处理 Weaviate，这个最要紧。
⚠️ 升级前必读：Weaviate 要分步升
内置向量数据库 Weaviate 从 1.27.0 跳到 1.39.2，跨了 12 个小版本。官方明确说跨版本直接升级不受支持：拉了新镜像直接重启，向量搜索可能悄悄坏掉且无法恢复。用内置 Weaviate 的自建部署必须按官方升级指南分步操作；新部署、外接 Weaviate、用其他向量库的不受影响。
🔥 更新内容
1. 知识库 API Key 按库绑定
以前的服务 Key 是整个工作区级别的，给第三方接入一个 Key 等于把所有知识库都交出去了。现在可以在知识库的 API 面板里把 Key 绑定到单个库，越权访问其他库直接返回 403。已有的 Key 保持工作区权限不变，升级不影响现有接入。
2. 工作流节点支持键盘移动
画布上挪节点再也不用手滑了。节点、多选、评论标记都能用方向键移动，按 Shift 大步走，持续移动在松键时才生成一条撤销记录。只读模式和容器边界约束照常生效。
3. 插件市场改版
插件作者有了公开主页，市场首页重做：轮播、置顶搜索、目录标签、按语言和标签筛选，手机端支持滑动布局。Bundle 不再混在插件分类里。
4. 表单字段名长度可配置
Markdown 表单字段名 128 字符的硬编码上限改成了配置项（MARKDOWN_FORM_FIELD_NAME_MAX_LENGTH），默认值不变。
🐛 修复了什么
知识库抽取（升级后需重新导入受影响文档）：
这批 bug 的共同点是改了文档内容还不报错，索引里的脏数据不会自动修复：
1. CSV 单元格被 pandas 类型推断祸害：前导零编号 00123 变成 123.0，空单元格变成字符串 nan，NA/NULL 变成缺失值。现在全部按文本读取。
2. Notion 表格行丢列或多列：单元格里的富文本段落被拆成多列，混合格式直接把表搞坏；空单元格被跳过导致整行左移。现在一个单元格对应一列。
3. Notion 属性在第一个格式变化处被截断：标题里后半段加粗，入库就只剩前半段。现在所有段落拼接完整。
4. .xls 含双引号的单元格损坏整行；URL 加载的 PDF 直接抛断言错误；内置网页抓取器返回 Python 数据结构而不是网页文本。
5. 其他：分段部分更新丢附件、非法 Markdown 图片链接卡住索引队列、删除内容后对象存储留孤儿文件、文本预览被误判为二进制。
模型与上传：
1.15 之前升级上来的模型不可用问题修了，不再需要手动命令；文件上传数据源不再请求多余授权。
工作流与 Human Input：
1. Human Input 修了一串状态机问题：表单完成后工作流看起来卡住、节点不能放进 Iteration/Loop、超时边触发错分支、同一次运行第二次暂停后无法恢复。
2. Workflow as Tool 只暴露第一个 End 节点的输出；Loop 布尔中断条件永不匹配；触发器入口的工作流还能被手动调用；一个坏掉的 LLM 节点把整个编辑器拖挂；含旧版 Agent 节点的工作流无法发布。
Agent 与对话：
1. Chatflow Agent V2 在多轮之间失忆；推理模型的回复整个渲染成 thinking 状态；Agent 应用上传的图片被变成 shell 下载命令；推荐问题可能卡几分钟；E2B 沙箱运行报 502。
其他：
MySQL 下创建文档报文件不存在的假警报；大图协作时 socket 断开；撤销删除 webhook 触发器节点后 URL 变化。
✅ 适合哪些人
✅ 用 CSV / Notion 喂知识库的人：这批修复就是为你做的，升级后重新导入受影响文档
✅ 工作流里用 Human Input 的：五个状态机 bug 一次清掉
✅ 给第三方开放知识库 API 的：按库绑定 Key，权限收敛到单个库
⚠️ 自建 + 内置 Weaviate：先按升级指南分步升 Weaviate，再升 1.17.1
🛠️ 快速上手
内置 Weaviate 的自建部署，严格按官方升级指南分步操作（不要直接 pull 重启）：
# 官方升级指南（务必先读）
https://github.com/langgenius/dify/releases/tag/1.17.1
# Docker 部署升级（外接向量库/新部署适用）
git checkout 1.17.1
docker compose pull
docker compose up -d升级后重新导入之前用 CSV / Notion / .xls 导入的文档，索引里的旧脏数据不会自动修复。
❓ 常见问题
Q：直接 pull 新镜像重启会怎样？
A：内置 Weaviate 跨 12 个小版本升级不受支持，向量搜索可能永久损坏。必须分步升级。
Q：CSV 编号 00123 之前入库变成 123.0，升级后会自动修复吗？
A：不会。抽取逻辑只对之后的导入生效，索引里的脏数据要重新导入文档才能纠正。
Q：已有的知识库 API Key 会失效吗？
A：不会。老 Key 保持工作区级权限，想收敛权限就新建按库绑定的 Key。
写在最后
这个版本像一次大扫除：没有 flashy 的新功能，但把知识库数据完整性和工作流状态机这两块地基上的裂缝补了。数据类的 bug 最阴险，因为你不看日志根本不知道它发生过。用 CSV 导过数据的朋友，升级完记得把重要文档重新导一遍。
🔗 GitHub：https://github.com/langgenius/dify
#Dify #知识库 #工作流自动化