Dify 1.16.0 发布：Dify Agent 测试版与 GPT-5.6 兼容调整

版本变化概览

来源为 Dify 1.16.0 的发布说明。该版本的主要变化包括：

• Dify Agent（Beta）：引入基于 Linux 沙箱运行的 Agent 形态。提供通过 UI 创建 Dify Agent 的构建器，可设置基础提示词、上传 Skills 与文件、接入 Dify 生态中的工具和知识；另提供一个用于构建 Dify Agent 的助手，可通过对话配置 Linux 沙箱环境、安装所需包并创建新的 Skills 和文件。同时支持在 Dify Workflow 中使用已有 Dify Agent 或临时创建内联 Agent，将任务输出传递给下一节点，并可发布为 Web 应用。来源提示：Dify Agent 服务只应提供给可信、非恶意用户。
• Agent App（开放测试）：默认对所有用户启用，包含内置的代码执行与 shell 命令沙箱、允许 Agent 调用工具和 API 的 skill 系统、用于在工作区内管理和复用 Agent 的 agent roster，以及在 workflow agent 节点中引用新 Agent。
• 工作流 AI 生成增强：移除低价值的 "Ideal output" 字段，用基于工作区上下文的 AI 生成建议替换静态示例，节点配置生成并行化；新增可配置超时 WORKFLOW_GENERATION_TIMEOUT_MS（默认 180s）。
• MCP 协议升级：workflow-as-MCP server 支持 MCP 协议 2025-06-18，包含版本协商与结构化工具输出，并向后兼容旧客户端；MCPClient 连接可通过占位符（例如 {{request.headers.X-Custom-Auth}}）在运行时注入动态 HTTP 请求头。
• Web 应用自定义：Chatbot、Agent、Chatflow Web 应用可自定义聊天输入占位文本（上限 64 字符）；应用描述显示在聊天与文本生成应用界面，并提供可折叠视图。
• 工作流可靠性与运维：工作流运行归档可导出；Celery 热关闭时中止活动运行；Redis 连接支持 TCP keepalive 与更广的重试覆盖；模型提供商可接收 app_id 用于成本归属；OAuth 与 SSO 登录流程更可靠地保留重定向 URL。

OpenAI GPT-5.6 兼容性提醒

来源说明：OpenAI 插件此前默认使用 Chat Completions API，该 API 已被 OpenAI 弃用，对新模型系列支持变差。新版 GPT-5.6 系列在 Chat Completions 下存在许多参数组合限制，来源强调这并非 Dify 系统问题。新配置的默认 API 类型已从 Chat Completions 改为 Responses，但此前已保存自定义 API key 的用户会保留旧默认设置，可能出现看似来自 Dify 的错误。若此前配置过自定义 OpenAI API key，建议检查 API 类型设置，在使用 GPT-5.6 或更新模型时切换为 Responses。

修复与改进要点

修复涉及工作流草稿导入引用丢失、失败后节点结算、重试详情可见性、HITL 恢复状态；SSE 流因 Unicode 分隔符损坏、流完成后 agent 最终答案被清空、会话标题被空值覆盖；登录后与认证重定向的开放重定向漏洞；编辑者权限（可查看日志、不再查询账单订阅、不再管理成员）；自定义模型删除时缓存未清理、插件供应商缓存击穿；以及文档批量删除死循环、PostgreSQL 18 原生 uuidv7() 支持等。

性能与架构方面：消除高级聊天工作流运行列表和 TokenBufferMemory 的 N+1 查询；通过懒加载 Vite 插件与 console contract 分片加快前端启动；缓存设置状态、用 zstd 压缩 Redis 中大插件模型对象；控制台 API 端点迁移到生成的 OpenAPI 契约；前端控制台契约迁移到生成的类型；升级到 TypeScript 7 与 Vite+ 工具链等。

安全增强包括：关闭一个 SQL 注入漏洞并加强 SQL 查询安全与元数据键校验；修复 API 工具 schema 获取中经 httpx.get 的 SSRF 绕过；阻止登录后与认证重定向的开放重定向；Chatflow API 检查 workflow_id 与沙箱方案；Agent HOME 目录使用 Landlock 保护并降级到 v1 以兼容更多内核；升级多个 CVE 依赖。

环境变量与部署变化

来源列出 28 个新增环境变量、1 个移除、1 个修改。新增变量涵盖 Agent 后端连接（如 AGENT_BACKEND_BASE_URL、超时与重连相关变量）、Dify Agent 的 Redis 配置与运行保留时长、Plugin daemon 与内部 API 配置、shellctl 入口与鉴权令牌、DIFY_AGENT_SERVER_SECRET_KEY、shell 输出脱敏模式、路径隔离开关、新用户默认插件与模型、工作流生成超时与并行 worker 数、Redis keepalive 参数以及 NEXT_PUBLIC_ENABLE_AGENT_V2（默认 true）。

• ENABLE_AGENT_V2 已移除，由 NEXT_PUBLIC_ENABLE_AGENT_V2 取代且默认值为 true。
• NEXT_PUBLIC_ENABLE_FEATURE_PREVIEW 默认值由 false 改为 true。
• Docker Compose 新增 agent_backend 与 local_sandbox 两个服务，api 与 worker 现在依赖 agent_backend；API_WEBSOCKET_WORKER_AMOUNT 变为可配置。

升级注意与待核实事项

来源给出升级指引：更新代码后运行 flask db upgrade；若部署是从早于 1.15.0 的版本升级且尚未应用旧模型类型迁移，需要单独运行模型类型迁移命令，该迁移不包含在 flask db upgrade 中，默认以 dry-run 模式运行，需先备份数据库并审阅输出后再使用 --apply。来源同时提醒：DIFY_AGENT_SERVER_SECRET_KEY 带开发默认值，生产环境必须替换；ENABLE_AGENT_V2 需从 env 文件中移除；此前配置自定义 OpenAI API key 的用户需确认 API 类型为 Responses。

需要说明的是，来源内容在依赖升级列表处被截断，且文中关于数据库迁移数量的表述存在不一致（正文先称 9 个迁移，升级注意事项处又称 8 个），具体数量与完整变更清单需以官方发布页面为准。本整理未进行任何运行验证。来源中的发布时间仅代表该版本的发布时点，不代表当前时间。