从 Confluence 迁出时，迁移完成度需要按页面、附件、链接、权限四类对象分别核对，每项指标写清分子、分母、统计时间窗和缺失值处理，才能让他人按同一口径复算。本文给出四组核对指标的定义、取数方式、核对步骤和一个 1000 页面的计算示例，并说明结果解读的边界。
要点总览（TL;DR）
- 迁移完成度按页面、附件、链接、权限四类对象分别度量，每项指标写清分子、分母、单位与统计时间窗，便于他人复算。
- 页面看迁移覆盖率、正文一致率、层级结构还原率；附件看覆盖率、可打开率、版本保留率；链接看内部链接重定向成功率与失效链接数；权限看映射一致率与越权访问数。
- 覆盖率回答数量是否到位，一致率回答内容是否可用，两者不能互相替代；越权访问数用绝对数量表达，不折算比率。
- 分母为零时标注“不适用”并单列说明，抽样指标需记录比例与方法，结论只代表抽样范围。
- 未达标时按缺失清单、内容差异、失效链接、越权访问的顺序排查，修正后按同一口径复算，形成可追溯的验收记录。
迁移完成度要回答哪几个问题
迁移完成度可以拆成三层判断：内容是否完整迁出、迁出后是否可用、访问是否安全。三层判断对应不同的核对对象，混在一起看容易得出偏乐观的结论。例如页面数量全部到位，但正文格式错乱、附件打不开，完整性达标而可用性不达标。
四类对象各自回答一个具体问题：
- 页面回答“该迁的内容是否都迁了、迁过来的内容是否与原页面一致”。
- 附件回答“挂在页面上的文件是否随页面一起到位、能否正常打开”。
- 链接回答“页面之间的引用关系在新环境中是否还能走通”。
- 权限回答“原来受限的内容迁移后是否仍然受限、原来公开的内容是否仍然可访问”。
同一组指标在两种场景下用法不同。过程监控关注趋势和差异清单，用于安排返工顺序，允许指标暂时偏低；迁移验收关注某一时点的最终值，需要固定统计时间窗，并对未达标项给出处理结论。验收时应明确统计截止时间，避免把迁移仍在进行中的数据当作最终结果。
四类核对指标与统计范围
下表给出四组指标的定义与计算口径。所有比率类指标的分母均为源端对应对象的数量，统计对象为迁移批次内纳入范围的空间与页面，时间窗建议取迁移批次开始至核对截止时点。
| 对象 | 指标 | 计算方式 | 单位 | 统计时间窗 |
|---|---|---|---|---|
| 页面 | 迁移覆盖率 | 目标端已存在的源端页面数 ÷ 源端页面总数 | 百分比 | 批次开始至核对截止 |
| 页面 | 正文一致率 | 正文比对通过的页面数 ÷ 参与比对的页面数 | 百分比 | 核对截止时点 |
| 页面 | 层级结构还原率 | 父子关系与源端一致的页面数 ÷ 有父页面的源端页面数 | 百分比 | 核对截止时点 |
| 附件 | 附件覆盖率 | 目标端存在的源端附件数 ÷ 源端附件总数 | 百分比 | 批次开始至核对截止 |
| 附件 | 附件可打开率 | 可正常下载并打开的目标端附件数 ÷ 目标端附件数 | 百分比 | 核对截止时点 |
| 附件 | 附件版本保留率 | 版本数与源端一致的附件数 ÷ 源端存在多版本的附件数 | 百分比 | 核对截止时点 |
| 链接 | 内部链接重定向成功率 | 指向正确目标页面的内部链接数 ÷ 源端内部链接总数 | 百分比 | 核对截止时点 |
| 链接 | 失效链接数 | 目标端点击后无法到达预期页面的链接数量 | 个 | 核对截止时点 |
| 链接 | 外部链接抽检通过率 | 抽检中可正常访问的外部链接数 ÷ 抽检外部链接数 | 百分比 | 抽检执行时点 |
| 权限 | 权限映射一致率 | 目标端权限与源端映射规则一致的页面数 ÷ 参与核对的受限页面数 | 百分比 | 核对截止时点 |
| 权限 | 越权访问数 | 用无权限账号实际可访问的受限页面数量 | 个 | 核对截止时点 |
| 权限 | 受限页面可见性偏差 | 目标端可见范围与源端不一致的页面数 ÷ 参与核对的受限页面数 | 百分比 | 核对截止时点 |
几处口径需要提前约定。正文一致率中的“比对通过”应明确比对内容：纯文本内容、标题层级、表格与列表结构、图片占位是否计入。建议按“文本内容完全一致”和“结构基本一致”两档记录，避免一个笼统的通过率掩盖格式问题。内部链接重定向成功率的分母只统计源端页面之间的链接，指向外部站点的链接单独归入外部链接抽检。权限映射一致率的分母是受限页面，公开页面不参与该比率，否则会因大量公开页面稀释问题。
越权访问数用绝对数量表达，不折算成比率。它的意义在于“有没有”，一个越权页面和一百个越权页面在安全处置上的优先级相同，都需要逐项排查。
数据从哪里取、口径怎么统一
四类指标分别对应四份清单，源端与目标端各导出一份，比对才有基础。
- 页面清单：页面标题、页面 ID 或稳定路径、所属空间、父页面、最后修改时间、正文摘要或正文哈希。
- 附件清单：附件名、所属页面、文件大小、版本号、上传时间。
- 链接清单：链接所在页面、链接目标、链接类型（内部或外部）。
- 权限清单：页面或空间、受限对象（用户或用户组）、权限类型（查看、编辑等）。
全量与抽样的适用场景不同。页面覆盖率、附件覆盖率、权限映射一致率这类可枚举的指标应做全量比对，成本主要在清单导出和自动匹配。正文一致率在页面量大时可以抽样，但需记录抽样比例、抽样方法和抽样时间，结论只代表抽样范围。外部链接受网络环境影响，适合抽检，抽检比例建议在核对方案中写明，例如按空间分层抽取固定数量。
缺失值和特殊情况按以下规则处理：
- 源端为空的页面仍计入页面总数，正文一致率中按“空对空”判定通过，并在备注中单列数量。
- 零附件的空间不参与附件覆盖率计算，在报告中单列“无附件空间 N 个”。
- 目标端存在但源端没有的页面，不计入覆盖率分子，单独列为“新增页面”，避免虚增完成度。
- 分母为零的指标不写成 0% 或 100%，直接标注“不适用（分母为 0）”，并说明原因。
源端与目标端的统计时点不一致会制造假差异。迁移期间源端仍可能有人编辑页面，建议在导出源端清单时记录导出时间，目标端清单在核对截止时点导出，比对时对“源端导出后发生修改”的页面单独标记，不直接判为不一致。若迁移分多批进行，每批单独统计，不把不同批次的数据混在一个比率里。
核对步骤：从清单到结论
核对流程可以固定为五步，每步产出可留存的文件，便于复核和返工。
- 导出源端四类清单：在迁移开始前或批次冻结时导出，记录导出时间与导出人，作为基准数据。
- 导出目标端对应清单：在核对截止时点导出，字段与源端尽量对齐，字段名不同时先做字段映射。
- 按唯一标识匹配：优先使用页面 ID 或稳定路径作为匹配键，标题作为辅助校验。标题在迁移中可能被修改或重名，单独用标题匹配会产生误判。附件以“所属页面 + 附件名 + 版本号”匹配。
- 差异分类：把匹配结果分为缺失、内容不一致、链接失效、权限偏差四类，每类记录数量与明细清单。内容不一致再细分文本差异和结构差异，便于判断返工方式。
- 汇总指标并标注未确认项：按第二节的公式计算各项指标，对无法确认的项目（如目标端清单缺失字段、抽样未覆盖的页面）单独列出，不并入比率，也不默认通过。
匹配键的选择直接影响结论可信度。如果源端页面在迁移中被重新组织到不同空间，路径会变化，此时应以页面 ID 为主键，路径仅作参考。差异清单应保留到页面级，汇总数字用于汇报，明细用于返工。
算一个例子：1000个页面的迁移核对
以下为演示情景，数字为假设，用于说明计算过程。
假设源端某批次包含 1000 个页面、2400 个附件、5600 条内部链接，其中受限页面 180 个。迁移后核对结果如下：目标端存在 985 个源端页面；抽取 300 个页面做正文比对，其中 276 个通过；有父页面的源端页面 820 个，父子关系一致的有 795 个；目标端附件 2310 个，可正常打开 2288 个，源端多版本附件 150 个，版本一致 138 个；内部链接中指向正确目标页面的 5320 条；受限页面中权限映射一致 171 个，用无权限账号实测可访问的受限页面 3 个。
逐项代入：
- 页面迁移覆盖率 = 985 ÷ 1000 = 98.5%
- 正文一致率 = 276 ÷ 300 = 92.0%（抽样 300 页，抽样比例 30%）
- 层级结构还原率 = 795 ÷ 820 ≈ 96.95%
- 附件覆盖率 = 2310 ÷ 2400 = 96.25%
- 附件可打开率 = 2288 ÷ 2310 ≈ 99.05%
- 附件版本保留率 = 138 ÷ 150 = 92.0%
- 内部链接重定向成功率 = 5320 ÷ 5600 = 95.0%
- 失效链接数 = 5600 − 5320 = 280 个
- 权限映射一致率 = 171 ÷ 180 = 95.0%
- 越权访问数 = 3 个
分母为零的处理示例：若该批次中有一个空间没有任何附件，则该空间不参与附件覆盖率计算，报告中写“附件覆盖率 96.25%，统计范围 2398 个附件所在空间，另有 1 个无附件空间未纳入”。缺失数据的处理示例：若 15 个页面因目标端清单缺少正文摘要而无法比对，正文一致率仍按 276 ÷ 300 计算，同时注明“另有 15 页因数据缺失未纳入比对，待补测”。
结论可以写成一段可核验的表述：“本批次源端 1000 个页面，迁移覆盖率 98.5%，缺失 15 页；抽样 300 页正文一致率 92.0%，另有 15 页待补测；附件覆盖率 96.25%，可打开率 99.05%，版本保留率 92.0%；内部链接重定向成功率 95.0%，失效链接 280 条；受限页面权限映射一致率 95.0%，实测越权访问 3 页，需优先处置。以上数据统计截止于核对时点，抽样指标仅代表抽样范围。”
怎么解读结果、有哪些限制
覆盖率与一致率回答不同问题。覆盖率高说明对象数量到位，一致率高说明内容可用。两者都高仍不能排除个别页面格式错乱或宏未正确渲染，这类问题往往需要打开页面人工确认。把覆盖率当作迁移成功的唯一证据，容易在验收后暴露内容质量问题。
抽样指标有置信限制。30% 抽样得到的 92% 一致率，不能直接推断全量一致率就是 92%，样本越小、页面差异越大，推断越不可靠。抽样结论应写明抽样范围和比例，需要更强结论时扩大样本或对高风险空间做全量比对。
权限指标与安全审计是两件事。权限映射一致率衡量的是“是否按规则映射”，越权访问数衡量的是“实际能不能进”。映射规则本身可能有误，例如源端某个用户组被映射到了范围更大的目标组，此时映射一致率可能很高而越权数不为零。权限核对应以实际访问测试为准，映射一致率作为辅助证据。
指标不能替代人工抽检的场景包括：正文中的表格、代码块、宏和批注的渲染效果，页面内嵌图片的清晰度，复杂权限继承关系下的边界访问。这些内容建议在指标核对后按空间抽取一定数量页面人工打开确认。
未达标时的排查顺序建议为：先查缺失清单，确认是迁移遗漏还是匹配键问题；再查内容不一致的页面，区分文本差异和结构差异；然后处理失效链接，优先修复被高频引用的页面链接；最后处置越权访问，越权页面应最先收紧权限再排查原因。每一步的排查结果回填到差异清单，形成闭环。
迁移完成后的核对结果需要有地方承接。ONES Wiki 支持将 Confluence 空间、页面、附件和权限结构迁移过来，迁移数据包括用户、用户组、空间权限与页面权限，页面正文、附件、图片、常用宏及批注在支持范围内。核对中发现的缺失页面、失效链接和权限偏差，可以在目标端的文档与权限设置中逐项修正，修正后再按同一口径复算指标，形成可追溯的验收记录。依赖 Confluence 宏或插件的页面，建议在迁移前梳理实际使用情况并逐项评估对应关系，这类页面的正文一致率需要单独统计，避免与普通页面混算。
常见问题
迁移期间源端仍有人编辑页面，核对时怎么避免把正常修改误判为迁移差异？
在导出源端清单时记录导出时间与导出人，作为基准数据；目标端清单在核对截止时点导出。比对时对“源端导出后发生修改”的页面单独标记，不直接判为不一致。若迁移分多批进行，每批单独统计，不把不同批次的数据混在一个比率里，否则时间差会被误读为迁移质量问题。
正文一致率做抽样时，抽样比例和结论该怎么写才不会被误读？
抽样结论只代表抽样范围。报告中应写明抽样比例、抽样方法和抽样时间，例如“抽取 300 页，占该批次 30%，正文一致率 92.0%”。样本越小、页面差异越大，向全量推断越不可靠。需要更强结论时，可扩大样本，或对高风险空间（宏多、表格多、批注多的页面）做全量比对并单独统计。
权限映射一致率很高，但仍有越权访问，说明什么？
两者衡量的是不同问题：映射一致率看“是否按规则映射”，越权访问数看“实际能不能进”。映射规则本身可能有误，例如源端某个用户组被映射到范围更大的目标组，此时一致率可能很高而越权数不为零。权限核对应以实际访问测试为准，映射一致率作为辅助证据；发现越权页面应先收紧权限，再排查映射规则。
依赖 Confluence 宏或插件的页面，迁移核对时要不要单独统计？
建议单独统计。宏和插件的渲染效果难以用文本比对覆盖，混入普通页面的正文一致率会掩盖问题。迁移前梳理实际使用的宏与插件并逐项评估对应关系，迁移后对这类页面单独记录数量、比对结果和人工确认情况，再决定是否纳入整体一致率。ONES 的 Confluence 迁移支持常用宏，非常用宏需在迁移前逐项评估。
核对结果出来后，缺失页面、失效链接和权限偏差在哪里修正和复算？
核对结果需要有承接位置。ONES Wiki 支持将 Confluence 空间、页面、附件和权限结构迁移过来，迁移数据包括用户、用户组、空间权限与页面权限，页面正文、附件、图片、常用宏及批注在支持范围内。缺失页面、失效链接和权限偏差可在目标端的文档与权限设置中逐项修正，修正后按同一口径复算指标，形成可追溯的验收记录。
