agentbase-docs

版本管理

知识库的 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 冲突,都会阻止封存。封存成功后版本变为只读快照,不会自动发布。

发布与回滚

版本删除

仅非当前、非回滚角色的版本可删除。删除为不可逆的异步操作:请求接受后版本立即不可访问,后台分批清理数据;页签内以删除操作展示状态(已排队、删除中、需关注、数据已清理),可查询进度。清理失败的版本保持不可访问,可重试删除。删除完成后版本记录保留为审计痕迹,数据已清除且无法恢复。

版本采纳(Adoption)

未启用版本化的旧库仍走旧的读取路径,Versions 页签会提示启用版本化。采纳为异步操作:既有内容被封存为首个不可变版本,期间展示排队、预检、标记、验证、激活等阶段;在版本标记开始前可取消,之后只能等待其收敛。采纳成功前不影响当前内容的使用。

保留策略

自动保留设置控制保留的历史版本数(默认保留 3 个),可自定义或恢复默认;超出保留数的版本按策略清理。

使用边界