Dify v1.17.0 版本更新说明

用途与本次变化

根据来源，Dify v1.17.0 为一次功能与安全并重的版本更新，主要变化包括：

Agent 与沙箱能力

• Agent 的 shell/代码执行除本地沙箱外，可运行在 E2B 云沙箱上，后端通过 DIFY_AGENT_RUNTIME_BACKEND 选择；新增 docker-compose.e2b.yaml 提供 E2B 相关栈配置。
• 构建时 Home 快照：Agent 构建（发布）时会捕获沙箱 home 目录（已安装包、准备文件、工作状态），后续运行从该快照恢复。
• 工作区级 Skill 管理：Skill 被描述为带代码与工具定义、可复用且可版本化的能力，具备草稿 → 发布 → 版本的流转，并配套 Web 界面。
• 上下文感知的历史压缩：按模型有效窗口分层压缩（先清理旧工具结果，再摘要较早历史），以避免超出上下文窗口。
• 非视觉附件不再在 Agent 对话中被静默丢弃，LLM 节点与 Agent 可将图片文件传给多模态模型。

工作流与编排

• 可复用 LLM 环境变量：可一次性定义提供方/模型/模式/参数配置，并在任意 LLM 节点引用，引用可随 DSL 导入导出、代码片段、RAG 管道和协作编辑保留。
• 人工输入支持在 Loop 与 Iteration 节点内部使用，可在刷新页面后暂停与恢复。
• 统一追踪（需显式开启 OPS_TRACE_UNIFIED_ENABLED）在核心侧组装完整父子 span 树，仅将传输委托给轻量适配器；首批提供 Phoenix 与 LangSmith 适配器，默认关闭。新增 GenAI span 覆盖 LLM TTFT、Agent ReAct 步骤、工具调用和失败 LLM 节点。

安全与认证

• 可选 Cloudflare Turnstile 验证码用于登录与邮箱验证码登录。
• 增强邮箱验证码校验（尝试次数限制与令牌过期），引入短时 Agent 授权令牌。
• 引入 KMS 提供方抽象，支持 Azure Key Vault 的密钥供给、加解密与轮换配置。
• 数据集、文档、RAG、会话、工作区凭据与 OAuth 客户端等资源更一致地绑定所有者与应用范围。
• 出站 HTTP 连接阶段限时 5 秒，Agent/绑定下载与运行超时可配置。

检索、模型与部署

• TiDB Vector 可启用全文与混合检索（TIDB_VECTOR_ENABLE_FULLTEXT_SEARCH，默认关闭）。
• 新增 ODT（OpenDocument Text）文档提取支持、工具插件的 date / date-picker 参数类型、老挝语（lo-LA）支持。
• 控制台全局 ⌘K / Ctrl+K 命令面板可跳转到应用、Agent、Skill、知识库、插件或工作流节点。
• APP_MAX_EXECUTION_TIME 与 WORKFLOW_MAX_EXECUTION_TIME 默认值由 1200 秒提升到 3600 秒。
• 大量可访问性改进：为多个交互控件使用真实 button 语义、为纯图标操作补充可访问名称、修正 ARIA 状态等。

适用场景

• 需要为 Agent 提供可复现文件系统环境，或在云沙箱中执行代码的部署。
• 需要在多个 LLM 节点间统一模型与参数配置、避免逐节点漂移的工作流。
• 需要在循环/迭代流程中嵌入人工审核或审批的自动化场景。
• 需要统一父 span 追踪并接入 Phoenix 或 LangSmith 的可观测性需求。
• 需要加强登录防护、密钥托管与资源访问控制的部署。

限制与待核实事项

• 来源文本被截断，未提供完整的变更清单与全部 PR 细节。
• E2B 沙箱、统一追踪、Turnstile、Azure Key Vault、TiDB 全文/混合检索等能力均为可选或需显式配置，具体启用方式与前置条件需参考官方文档。
• 该版本包含新数据库迁移，需执行 flask db upgrade；若部署由 1.15.0 之前的版本升级且未应用过迁移，来源提示需额外运行一次遗留模型类型迁移，且该迁移不包含在 flask db upgrade 中。
• 环境变量变动较多，其中 EDITION 重命名为 DEPLOYMENT_EDITION，若已设置需同步修改；EDITION、ENTERPRISE_ENABLED、AGENT_BACKEND_RUN_TIMEOUT_SECONDS 等被移除或替换。
• 未在本次整理中进行实际安装、升级或运行验证，上述迁移与升级步骤均来自来源描述。
• 具体版本号、行为与兼容性以官方发布说明为准。