dify的“版本”是全栈状态冻结，包含提示词、知识库引用、agent配置等所有运行时依赖；每次修改必须新建版本，否则仅存于草稿态；创建后需发布到指定环境，发布不可逆；支持环境隔离、草稿分支和api自动化ci/cd协同；可回滚并对比版本差异溯源。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让多个成员在同一个Dify应用上安全协作，同时确保每次修改可追溯、可回滚、不互相覆盖——这要求你真正用对版本管理机制，而不是只点“保存”就完事。
理解Dify中“版本”的真实含义
在Dify里，“版本”不是Git式的代码快照，而是一次【全栈状态冻结】：它打包了当前应用的提示词、知识库引用、Agent工作流节点配置、模型参数（如temperature）、RAG检索设置等所有运行时依赖项。一次版本创建，等于给整个AI行为逻辑拍下一张不可变的“行为身份证”。
这意味着：改一行Prompt → 必须新建版本；换一个知识库 → 必须新建版本；调整Agent分支条件 → 必须新建版本。不新建版本的修改，只存在于“开发版”草稿态，不会进入发布流程，也无法被其他成员看到或复用。
创建与发布正式版本
第一步：进入目标应用 → 点击右上角「版本」→ 选择「创建新版本」。
第二步：填写版本名称（建议用语义化命名，如v1.3.0-客户投诉分类优化）和描述（明确写清本次变更点，例如“更新意图识别Prompt，新增3类投诉子类型；替换知识库为2026Q2服务政策”）。
第三步：点击「确认创建」→ 系统生成唯一version_id（如v20260615-7f3a9b），并自动将当前全部配置打包为只读快照。
第四步：在版本列表中找到刚创建的条目 → 点击右侧「发布」→ 选择目标环境（开发/预发/生产）→ 确认发布。注意：【发布操作不可逆，且会立即覆盖该环境中正在运行的旧版本逻辑】。
多人协同开发时的分支策略
方法一：基于环境隔离分工
让前端工程师专注调用/api/v1/chat-messages接口，后端工程师在/api/v2/chat-messages中开发新意图解析模块，运营人员在预发环境单独维护知识库v202606_knowledge_qa。各环境对应独立版本，互不干扰。
Dify 3.9.2更新重点增强系统安全性，引入 Chainguard 安全基础镜像并同步社区版 CVE 修复，同时优化 OpenSearch 向量存储兼容性、插件参数传输机制及 Helm 部署配置。新增工作流模型节点缓存能力，可减少重复凭证查询，显著提升复杂工作流初始化速度，为企业级 AI 应用提供更稳定、高效的运行体验。
方法二：使用Dify内置的「草稿分支」功能
点击「版本」→ 「新建草稿」→ 命名为“张三_意图增强草案”。此时你编辑的所有内容（Prompt、工作流）仅对你可见，其他人看不到，也不会影响任何已发布版本。完成验证后，再从该草稿创建正式版本。
方法三：通过API自动化接入CI/CD
在GitHub Action中配置触发器：当main分支有commit且含关键词[release]时，自动调用Dify API创建新版本并发布到预发环境。这样就把人工操作环节压缩到最小，避免人为漏发或错发。
回滚到历史版本
进入「版本」列表 → 找到目标历史版本（如v20260528-0a1c8d）→ 点击「发布」→ 选择当前正在出问题的环境（比如生产环境）→ 确认。系统会立即用该版本的全部配置替换当前运行态，通常3秒内生效。
注意：回滚只恢复配置，不恢复用户对话记录或向量数据库中的实时索引数据。若知识库内容已变更，需同步手动还原知识库快照。
查看版本差异与变更溯源
在版本列表中，点击任意已发布版本右侧的「对比」图标 → 选择两个版本（如v1.2.0 vs v1.3.0）→ 系统展示结构化差异报告：哪些Prompt块被修改、哪个知识库ID被替换、Agent节点是否增删、temperature值从0.7变为0.5。
每条差异行右侧显示修改人和时间戳，点击用户名可跳转至该成员的操作日志页，看到他当时保存前的完整编辑界面截图（Dify自动截存）。
