版本管理
知识库的 Versions 页签把库内容升级为可持续演进的不可变版本:为知识库创建工作副本(working copy),就绪后封存(Seal)为只读快照,发布(Publish)为当前激活版本,并可回滚(Rollback)到保留的历史版本;未启用版本化的旧库需先采纳(Adoption)版本化,保留策略(retention)控制保留的版本数。入口:知识库详情页 Versions 页签。
生命周期
一个版本在生命周期中依次经历:
| 阶段 | 含义 |
|---|---|
| DRAFT | 工作副本:可编辑的草稿版本,后台复制与校验通过后才出现在版本列表 |
| READY | 已封存的只读快照:可被发布或作为回滚目标 |
| 当前版本(Current) | 新的版本解析请求默认使用该版本 |
| 回滚目标(Rollback) | 发布时自动保留的上一当前版本,用于一键回滚 |
DRAFT 经封存变为 READY;READY 经发布成为当前版本;回滚则把保留的回滚目标恢复为当前版本。
能力总览
| 能力 | 说明 |
|---|---|
| 工作副本 | 基于指定 READY 源版本创建可编辑 DRAFT,可带标签与描述,支持重试(retryOf) |
| 就绪封存(Seal) | 就绪检查(readiness)通过后把 DRAFT 置为 READY |
| 发布(Publish) | 把 READY 版本切换为当前激活版本 |
| 回滚(Rollback) | 恢复保留的 READY 回滚目标为当前版本 |
| 版本删除 | 对不再需要的版本发起不可逆异步清理,以删除操作呈现并可查询状态 |
| 版本采纳(Adoption) | 未启用版本化的旧库迁移进版本化管理,可取消、可查询 |
| 保留策略(Retention) | 控制自动保留的历史版本数量 |
工作副本
在 Working copies 区点击创建工作副本,选择 READY 源版本并填写标签(必填)与描述(可选)。复制在后台进行,页签内展示行数、对象数、产物与字节的复制进度;校验成功后 DRAFT 才可见,不会影响当前激活版本。复制未完成前可取消(私有副本被清理,不会生成可见 DRAFT);失败或取消的操作可重试(retryOf 指向原操作)。
就绪封存(Seal)
DRAFT 需通过就绪检查才能置为 READY。页签展示各版本的 Readiness 摘要与阻塞原因:活动任务未完成、文档未就绪或需按当前配置重建、已启用索引能力待重建或构建失败、存在未解决的 Wiki 冲突,都会阻止封存。封存成功后版本变为只读快照,不会自动发布。
发布与回滚
- 发布:把 READY 版本切换为当前激活版本;之后的版本解析请求使用新当前版本,先前的当前版本自动保留为唯一回滚目标。
- 回滚:把保留的回滚目标恢复为当前版本;原当前版本成为新的回滚目标。不能指定任意历史版本作为回滚目标。
版本删除
仅非当前、非回滚角色的版本可删除。删除为不可逆的异步操作:请求接受后版本立即不可访问,后台分批清理数据;页签内以删除操作展示状态(已排队、删除中、需关注、数据已清理),可查询进度。清理失败的版本保持不可访问,可重试删除。删除完成后版本记录保留为审计痕迹,数据已清除且无法恢复。
版本采纳(Adoption)
未启用版本化的旧库仍走旧的读取路径,Versions 页签会提示启用版本化。采纳为异步操作:既有内容被封存为首个不可变版本,期间展示排队、预检、标记、验证、激活等阶段;在版本标记开始前可取消,之后只能等待其收敛。采纳成功前不影响当前内容的使用。
保留策略
自动保留设置控制保留的历史版本数(默认保留 3 个),可自定义或恢复默认;超出保留数的版本按策略清理。
使用边界
- 发布与回滚要求提交时的预期绑定修订号与当前一致;他人并发修改版本状态会被拒绝——刷新页面查看最新状态后重试。
- 删除版本不可恢复:版本一旦进入删除流程即不可访问,数据清除后无法找回。
- 版本列表只展示已提交的版本;仍在复制校验中的工作副本不会以半成品 DRAFT 出现。
- 标签需唯一;使用相同标签创建工作副本会被拒绝。