1.17.1 中已确认的变化
- 知识库 API 密钥可以限定范围:新密钥可以只访问指定知识库。现有密钥在升级后继续保持原有工作区范围。
- 旧模型类型迁移进入数据库升级:从 1.15 以前版本升级的安装,不再需要 1.16.1 和 1.17.0 发布说明中的独立手动迁移命令。
- 数据库包含三项迁移:其中一项模型类型迁移不可逆,升级前应备份数据库。
- 知识库解析修复:发布说明列出了 CSV、Notion 表格、PDF URL 和旧版 XLS 内容提取问题的修复。受影响的文档需要在升级后重新导入,已建立的索引不会自动修复。
- 工作流与智能体修复:发布说明记录了 Human Input、工作流工具输出、Agent 会话记忆和大工作流协作连接等问题的修复。
升级前的判断顺序
- 检查 Docker 环境中的
VECTOR_STORE。 - 如果使用带现有数据的内置 Weaviate,先完成官方分阶段迁移。
- 备份数据库、Docker 数据卷和本地修改过的配置。
- 阅读 1.17.1 发布说明中的环境变量和数据库迁移部分。
- 使用明确的 1.17.1 标签,不要把当前主分支自动当作目标版本。
升级后的基本检查
- 确认所有预期容器处于健康状态。
- 运行一次已知模型请求。
- 用固定问题检查知识库是否仍能返回预期文档。
- 完整运行一个已发布的代表性工作流。
- 验证新建的限定范围知识库密钥不能访问未选择的知识库。
如果需要单独的测试服务器,可先查看在 Hetzner VPS 上部署 Dify。有关 MCP 的当前配置路径,请查看Dify MCP 指南。