Confluence迁移到ONES Wiki验收清单

这份验收清单用于Confluence迁移到ONES Wiki的项目收尾与切换判断，按迁移前、试迁移、正式迁移、切换、切换后观察五个时点组织。每个检查项都写明通过标准、证据和负责人；内容缺失、权限越权、关键链接失效属于阻断项，未全部关闭前不应宣布迁移完成。

要点总览（TL;DR）

• 验收按迁移前、试迁移、正式迁移、切换、切换后观察五个时点推进，每个检查项都要写明通过标准、证据和负责人。
• 迁移前先冻结空间与页面范围，确认账号与权限映射方案、特殊对象处理口径和回退方案，这四项属于阻断项。
• 试迁移用于暴露结构、附件和宏的适配问题；正式迁移后要核对页面层级、正文完整性、附件可打开性和内部链接，并逐条处理迁移日志中的失败条目。
• 切换前以权限映射方案为基准核对空间与页面权限，抽查敏感内容可见范围，并验证编辑、评论、历史版本等协作动作可用。
• 内容缺失、权限越权、关键链接失效、失败条目未处理、回退方案不可用属于阻断项，全部清零且观察期问题收敛后才可宣布迁移完成。

谁在什么时点使用这份验收清单

验收清单的价值在于把“迁移做完了”变成一组可核对的判断。不同角色关注的证据不同，检查时点也不同，先明确分工可以避免所有问题都堆到切换当天才发现。

迁移项目负责人负责整体节奏与阻断项裁决，在每个时点结束后确认本阶段检查项是否关闭，并决定是否进入下一阶段。Wiki管理员负责空间结构、页面层级、权限映射的执行与核对，是试迁移和正式迁移阶段的主要操作人。内容负责人按空间或业务域分工，负责确认本域页面、附件、宏和链接的完整性，对内容缺失类问题给出处理结论。IT与安全角色负责账号对接、权限基线审查、敏感内容可见范围抽查，以及备份与回退方案的可用性确认。

角色	主要检查时点	核心关注	输出证据
迁移项目负责人	五个时点全程	阶段准入、阻断项关闭、完成判定	阶段验收结论、阻断项台账
Wiki管理员	迁移前、试迁移、正式迁移、切换	结构一致性、权限映射生效、迁移日志处理	结构对照记录、权限核对表、日志处理记录
内容负责人	试迁移、正式迁移、切换后观察	正文与附件完整、链接可用、检索命中	抽查记录、问题清单及关闭状态
IT/安全角色	迁移前、切换前、切换后观察	账号映射、敏感内容可见范围、备份与回退	权限抽查报告、回退演练记录

验收结论采用阻断项清零制：每个时点的检查项分为阻断项与一般项，阻断项必须全部关闭并附证据，一般项可以带条件通过但需登记责任人和计划关闭时间。只有阻断项清零、观察期问题收敛、回退方案确认可用，才可宣布迁移完成。

迁移前准备检查项

迁移启动前最容易出现的风险是范围不清和权限不明。此阶段的目标是把迁移边界固定下来，让后续试迁移和正式迁移有明确的对照基准。

检查项	通过标准	证据	负责人	是否阻断
空间与页面范围清单	待迁移空间、页面、附件范围已列明并经业务方确认，范围冻结后变更走审批	范围清单及确认记录	迁移项目负责人	是
源端账号与权限映射方案	Confluence用户、用户组与ONES Wiki账号的对应关系已确认，空间权限与页面权限的映射规则逐条写明	账号映射表、权限映射说明	Wiki管理员、IT	是
特殊对象处理口径	附件、图片、常用宏、批注、嵌入内容逐类给出处理方式；无法对应的宏和定制场景已逐项评估并记录替代方案	特殊对象清单及处理结论	Wiki管理员、内容负责人	是
备份与回退方案	源端数据有可用备份，回退触发条件、回退操作步骤和责任人已明确	备份确认记录、回退方案文档	IT/安全角色	是
迁移方式与批次安排	批量迁移或数据包导入的方式已确定，批次划分与时间窗口与业务方对齐	迁移实施计划	迁移项目负责人	否

特殊对象口径需要特别说明：ONES Wiki的Confluence迁移能力覆盖页面正文、附件、图片、常用宏及批注，但常用宏的具体覆盖范围应在迁移前逐项核对，依赖Confluence插件或存在定制场景的功能需要单独评估，不能默认一一对应。范围清单冻结后，新增空间应作为变更单独排期，避免迁移过程中范围持续膨胀。

试迁移与正式迁移检查项

试迁移的作用是提前暴露结构、附件和宏的适配问题，正式迁移则要求结果可核对、失败条目可追溯。两个环节使用同一套检查口径，试迁移通过后再执行正式迁移。

检查项	通过标准	证据	负责人	是否阻断
空间与页面层级	迁移后空间数量、页面父子关系与源端对照一致，抽查页面路径可还原	结构对照表、抽查截图或记录	Wiki管理员	是
正文内容完整性	正文段落、表格、代码块、图片在抽查页面中完整呈现，无截断或乱码	抽查页面清单及比对结论	内容负责人	是
附件数量与可打开性	附件数量与源端统计一致，按类型抽查文件可正常下载和打开	附件数量对照表、抽查记录	Wiki管理员	是
内部链接与跨页引用	抽查页面中的内部链接指向正确目标页面，跨页引用无死链	链接抽查清单及结果	内容负责人	是
迁移日志与失败条目	迁移日志完整留存，失败条目逐条登记原因、处理人和处理结果，正式迁移前清零或经负责人确认可接受	迁移日志、失败条目处理台账	Wiki管理员	是
批注等协作数据	批注迁移结果与预期口径一致，未迁移项已登记并告知相关用户	批注核对记录	内容负责人	否

试迁移阶段应选择覆盖典型内容形态的空间，包括含表格、代码块、图片、宏和附件的页面。试迁移发现的问题要回写到特殊对象处理口径中，正式迁移按修订后的口径执行。正式迁移完成后，迁移日志和失败条目处理台账是判断能否进入切换阶段的关键证据，失败条目未逐条处理前不应推进。

切换前的权限与协作验收

内容迁移完成不等于可以切换。切换前要确认权限按映射方案真实生效，敏感内容没有越权可见，日常协作动作在ONES Wiki中可以正常完成。

检查项	通过标准	证据	负责人	是否阻断
空间与页面权限生效	按权限映射方案逐项核对，空间权限与页面权限的继承关系符合预期	权限核对表	Wiki管理员	是
敏感内容可见范围抽查	抽取敏感空间和页面，用不同角色账号验证可见与不可见结果符合方案	抽查账号与结果记录	IT/安全角色	是
协作动作可用性	编辑、评论、历史版本查看等动作在抽查页面中可正常执行	操作验证记录	Wiki管理员	是
关键用户试用反馈	各业务域关键用户完成试用，反馈问题登记并逐条关闭或有明确处理计划	试用反馈清单及关闭状态	内容负责人	是
用户通知与培训	切换时间、访问方式、常用操作说明已通知到受影响用户	通知记录	迁移项目负责人	否

权限验收要以映射方案为唯一基准，发现实际结果与方案不一致时，先判断是映射方案有误还是执行有偏差，修正后重新抽查。敏感内容抽查应覆盖至少一个受限空间和一个公开空间，验证两个方向的可见性都正确。关键用户试用建议在切换前留出固定窗口，反馈问题按阻断项与一般项分类处理。

切换后观察与回退检查项

切换完成后进入观察期，重点是确认用户能通过检索和旧入口找到迁移后的内容，问题能被收集和关闭，回退能力保持可用直到观察期结束。

检查项	通过标准	证据	负责人	是否阻断
检索命中	用高频关键词和页面标题抽查，迁移后的页面能在ONES Wiki检索结果中命中	检索抽查清单及结果	内容负责人	是
旧链接与入口覆盖	旧链接跳转或替代入口、通知渠道已覆盖到位，用户可从原习惯路径进入新位置	入口覆盖清单、跳转验证记录	Wiki管理员	是
观察期问题清单	观察期内收集的问题逐条登记，明确责任人和关闭时间，阻断级问题即时处理	问题台账及关闭状态	迁移项目负责人	是
回退触发条件与演练	回退触发条件明确，回退步骤经过演练并记录结果，观察期内回退能力保持可用	回退演练记录	IT/安全角色	是
访问与性能观察	观察期内无集中反馈的访问异常，异常情况已记录并处理	观察期记录	Wiki管理员	否

观察期应设定明确时长和退出条件，例如连续若干天无新增阻断级问题、一般问题关闭率达到约定比例。退出观察期前，由迁移项目负责人汇总检索命中、入口覆盖、问题关闭和回退演练四类证据，确认满足条件后才可退出迁移状态。

阻断项与完成条件

阻断项是判断能否宣布迁移完成的硬性门槛。以下问题在关闭前不得进入下一阶段或宣布完成，每项关闭都需要留下可核对的证据并注明责任人。

阻断项	关闭证据	责任人
页面或附件内容缺失	缺失清单逐条补齐或经业务方书面确认可接受	内容负责人
权限越权或权限缺失	修正后的权限核对表与敏感内容复查记录	Wiki管理员、IT/安全角色
关键链接失效	链接修复记录或替代入口说明	内容负责人
迁移失败条目未处理	失败条目台账全部关闭或经负责人确认	Wiki管理员
回退方案不可用	回退演练通过记录	IT/安全角色

宣布迁移完成需要同时满足三个条件：阻断项全部清零并附关闭证据；观察期问题收敛到约定水平，未关闭项有责任人和计划时间；回退方案在观察期内保持可用并有演练记录。满足条件后由迁移项目负责人出具完成结论，清单归档，后续新增问题转入日常运维流程处理。

常见问题

试迁移要覆盖多少页面才算充分？

试迁移的样本量没有统一数字，判断标准是覆盖典型内容形态。建议选择包含表格、代码块、图片、常用宏和附件的页面，并覆盖至少一个受限空间和一个公开空间。试迁移发现的问题要回写到特殊对象处理口径中，正式迁移按修订后的口径执行。如果试迁移样本只包含纯文本页面，结构、附件和宏的问题会被推迟到正式迁移才暴露。

Confluence 的常用宏迁移后都能正常显示吗？

ONES Wiki 的 Confluence 迁移能力覆盖页面正文、附件、图片、常用宏及批注，但常用宏的具体覆盖范围需要在迁移前逐项核对。依赖 Confluence 插件或存在定制场景的功能要单独评估，不能默认一一对应。验收时建议把本企业实际使用的宏列成清单，逐个在试迁移页面中确认显示结果，无法对应的宏记录替代方案并告知内容负责人。

权限映射方案已经确认，切换前还需要抽查吗？

需要。映射方案是纸面规则，实际生效结果要通过账号验证。切换前按映射方案逐项核对空间权限与页面权限的继承关系，并用不同角色账号抽查敏感空间和公开空间的可见性。发现实际结果与方案不一致时，先判断是映射方案有误还是执行有偏差，修正后重新抽查，复查记录作为阻断项关闭证据。

观察期一般设多长，什么条件下可以退出迁移状态？

观察期时长由项目组结合用户规模和业务节奏约定，关键是把退出条件写清楚。可用的退出条件包括：连续若干天无新增阻断级问题，一般问题关闭率达到约定比例，检索命中与旧入口覆盖抽查通过，回退演练记录在观察期内保持有效。退出前由迁移项目负责人汇总这四类证据，确认满足条件后出具完成结论。

迁移完成后旧链接还能继续用吗？

旧链接的处理方式需要在切换前确定并验证。验收清单要求旧链接跳转或替代入口、通知渠道覆盖到位，用户可以从原习惯路径进入新位置。具体跳转规则取决于迁移实施安排，建议在试迁移阶段就抽查内部链接与跨页引用的指向结果，把失效链接列入阻断项，修复后再进入切换。