Confluence 页面迁移完成度需要按页面、附件、链接、权限四类对象分别度量，再按事先约定的权重或分档汇总。单一百分比容易掩盖结构性缺口，例如页面全部建好但附件校验未通过、权限继承关系错位。本文给出可复算的分子分母口径、取数证据、计算步骤与解读边界，适用于已确定统计基准日和迁移范围、准备判断能否进入切换或收尾的迁移项目。
要点总览（TL;DR）
- 完成度按页面、附件、链接、权限四类对象分别度量，各自定义分子、分母、单位与时间窗，再按事先约定的权重或分档汇总，单一百分比容易掩盖结构性缺口。
- 页面看“目标端已建且内容校验通过数 / 源端应迁移页面数”，附件看“已上传且大小与校验值一致数 / 源端附件总数”，链接看“可解析到目标地址数 / 被检链接数”，权限看“权限一致页面数 / 抽样页面数”。
- 汇总时先看各分项是否达到各自阈值，再看加权结果；判定能否切换以分项阈值全部满足为准，总完成度用于汇报和趋势跟踪。
- 分母为零标注“不适用”，部分迁移在相关分项计为未通过，重复迁移去重后统计并留档；阈值按内容重要性和回退成本设定，没有通用达标线。
- 完成度只证明对象迁移到位、内容一致，不衡量内容质量与使用效果；权限抽样有覆盖局限，链接检查有时效性，业务验收需另行完成。
评估目标：完成度要回答哪几个问题
迁移完成度要回答的是“现在能不能进入下一阶段”，而不是“迁了多少”。它至少服务三类决策：能否开始切换（源端转只读、用户转向目标端）、是否需要回退（保留源端可写的时间窗口）、能否收尾（关闭源端、归档迁移记录）。因此完成度必须按对象拆分，并给出每类对象的通过标准，让决策者看到缺口在哪一类、缺多少。
建议把迁移状态分成三层，每层对应不同的核验动作：
- 已迁移：目标端已存在对应对象，数量可对齐。这一层只证明“搬过去了”，不证明内容正确。
- 已校验：对象内容经过比对，页面正文、附件校验值、链接可解析性、权限一致性达到约定标准。这一层是完成度计算的主要依据。
- 已验收：业务负责人或页面所有者确认内容可用、结构合理，抽样用户完成实际使用确认。这一层超出定量指标，属于业务验收。
统计前必须固定三个前提：统计基准日（以哪一天的目标端快照为准，迁移期间源端仍在变更时尤其重要）、统计范围（哪些空间、哪棵页面树、是否含子空间）、时间窗（增量迁移的页面按哪个时间段计入）。基准日之后源端的新增或修改，应进入下一轮增量统计，不混入本轮完成度。范围一旦确定，分母随之固定，后续复算才有可比性。
指标与范围：页面、附件、链接、权限四类对象
四类对象各自定义分子、分母、单位和时间窗，形成一张可复算的指标表。分母的确定规则要在迁移开始前写进迁移方案，避免统计时临时调整口径。
| 对象 | 指标定义（分子 / 分母） | 单位 | 时间窗与口径说明 |
|---|---|---|---|
| 页面 | 目标端已建且内容校验通过的页面数 / 源端应迁移页面数 | 页面数 | 以基准日目标端快照为准；分母需事先约定草稿、归档页面、模板是否计入，建议分别列示“计入”与“不计入”两套数字 |
| 附件 | 已上传且可打开、大小与校验值一致的附件数 / 源端附件总数 | 附件个数（版本是否单独计数需约定） | 按附件当前版本统计；历史版本若需保留，单独设一项“历史版本完整率” |
| 链接 | 可解析到目标地址的链接数 / 被检链接数 | 链接条数 | 内部页面链接、附件链接、外部链接分开统计；外部链接单独标注不可控 |
| 权限 | 权限一致页面数 / 抽样页面数 | 页面数 | 核对空间权限、页面限制与继承关系；抽样方案在统计前确定 |
几个口径细节需要提前定死。页面指标中，“内容校验通过”要有明确判定方式，例如正文文本比对一致、图片与表格结构完整、常用宏渲染正常；只统计“已创建”会把空页面或占位页面算成完成。附件指标中，校验值比对是判断内容一致的关键证据，大小一致但内容不同的情况并不罕见。链接指标中，内部页面链接和附件链接指向目标端地址才算可解析，仍指向源端地址的应计为未完成；外部链接受第三方站点可用性影响，单独统计并注明检查时间。权限指标中，空间权限、页面限制、继承关系三者要分别核对，只比页面级限制会漏掉空间层配置差异。
分母为零时，报告中标注“不适用”，不记为 0% 或 100%。例如某个空间没有附件，附件完成度不参与汇总，也不拉低整体结果。部分迁移的页面（正文已迁、附件未迁）在页面指标中计为未通过，在附件指标中按实际附件状态计入，两类指标各自反映各自的问题。
数据口径与证据：从哪里取数、留什么凭证
完成度要可复核，取数就必须可追溯。基本做法是从源端和目标端各导出一份对象清单，用稳定的对齐键匹配，再逐项比对。对齐键建议优先使用源端页面 ID（迁移时通常保留映射关系），其次用空间键加页面路径，标题只作为辅助，因为迁移过程中标题可能被修改或去重。
需要留存的证据按对象分类：
- 页面：源端与目标端页面清单（含页面 ID、路径、标题、最后修改时间）、正文比对结果记录、校验未通过页面的差异说明。
- 附件：附件清单（文件名、大小、校验值）、目标端附件可打开验证记录、校验值不一致的附件明细。
- 链接：链接检查报告（链接原文、所在页面、目标地址、解析结果、检查时间），内部链接与外部链接分列。
- 权限：抽样页面的权限快照或截图（源端与目标端各一份）、抽样记录（抽样规则、抽样页面清单、核对人、核对日期）。
数据清洗规则同样要写进口径。缺失值（源端有、目标端清单中找不到）计为未完成，并单列“缺失清单”供排查；重复项（同一页面被迁移两次）按对齐键去重后统计，重复迁移的记录单独留档；改名页面以页面 ID 对齐，标题差异记入差异清单，不计为未完成。这些规则的作用是让不同人复算同一批数据时得到相同结果。
计算与评估步骤：从清单到完成度结论
计算流程可以固定为六步：导出清单、对齐、逐项比对、分项计算、汇总、判定。每一步产出可留存的中间物，便于复核和增量更新。
- 导出清单：按统计基准日导出源端应迁移对象清单和目标端已建对象清单。
- 对齐：用页面 ID 为主键匹配，生成“已匹配 / 源端有目标端无 / 目标端多出”三类结果。
- 逐项比对：页面比对正文与结构，附件比对大小与校验值，链接执行解析检查，权限按抽样核对。
- 分项计算：按指标表公式计算四类完成度，分母为零的项标注“不适用”。
- 汇总：先看各分项是否达到各自阈值，再看加权结果。
- 判定：输出“可进入切换 / 需补迁 / 需回退整改”的结论，并附缺口清单。
汇总方式建议采用“分档加权重”的组合。分档指每类对象设自己的通过阈值，例如页面与附件要求接近全量通过，链接允许一定比例的外部链接异常，权限抽样要求零重大差异；加权指四类分项按约定权重合成一个总完成度，权重在统计前确定并写入迁移方案，常见做法是页面权重最高、附件次之、链接与权限按风险分配。总完成度只用于对外汇报和趋势跟踪，判定是否可切换时以分项阈值是否全部满足为准。
阈值没有通用标准，应按内容重要性和回退成本设定。核心空间、对外发布内容、合规相关页面的阈值应更严；内部草稿区可以放宽并列入后续整改。部分迁移和重复迁移按前述规则处理：部分迁移在相关分项计为未通过，重复迁移去重后统计并留档。
算例：一个空间迁移的完成度计算示例
以下为一组假设数据，仅用于演示计算过程，不代表任何真实迁移项目的结果。
假设某空间源端应迁移页面 1,200 个（不含草稿与归档），附件 3,000 个，被检链接 8,000 条（内部页面链接 5,000 条、附件链接 1,500 条、外部链接 1,500 条），权限抽样 100 个页面。迁移后核对结果：目标端已建且内容校验通过页面 1,140 个；已上传且校验值一致附件 2,880 个；可解析链接 7,760 条（内部页面链接 4,930 条、附件链接 1,480 条、外部链接 1,350 条）；权限一致页面 96 个。
| 对象 | 计算 | 分项完成度 | 缺口 |
|---|---|---|---|
| 页面 | 1,140 / 1,200 | 95.0% | 60 个页面未通过内容校验 |
| 附件 | 2,880 / 3,000 | 96.0% | 120 个附件校验值不一致或缺失 |
| 链接（合计） | 7,760 / 8,000 | 97.0% | 240 条不可解析 |
| 链接（内部页面） | 4,930 / 5,000 | 98.6% | 70 条仍指向源端或失效 |
| 链接（附件） | 1,480 / 1,500 | 98.7% | 20 条不可解析 |
| 链接（外部） | 1,350 / 1,500 | 90.0% | 150 条外部站点不可达，需单独说明 |
| 权限（抽样） | 96 / 100 | 96.0% | 4 个页面权限与源端不一致 |
若约定权重为页面 40%、附件 30%、链接 20%、权限 10%，总完成度为 95.0%×0.4 + 96.0%×0.3 + 97.0%×0.2 + 96.0%×0.1 = 95.8%。解读时先看分项：页面缺口 60 个、附件缺口 120 个，属于需要补迁的实质问题；链接合计 97% 看似达标，但外部链接 90% 拉低了合计值，内部链接实际表现更好，说明问题集中在外部站点而非迁移改写；权限抽样 4 个不一致页面需要逐个核对，确认是空间权限、页面限制还是继承关系差异。若阈值约定为页面与附件均需达到 99%、权限零重大差异，则本例结论是“需补迁后再判定”，总完成度 95.8% 不能作为放行依据。
解读与限制：哪些结论不能从完成度直接得出
完成度衡量的是对象是否迁移到位、内容是否一致，它不衡量迁移后的知识库是否好用。页面 100% 校验通过，仍可能存在结构混乱、重复页面、过时内容未清理的问题，这些属于内容治理范畴，需要另行安排评审。把完成度当作质量保证，是这类指标最常见的误用。
权限指标依赖抽样，抽样覆盖不到全部页面，未抽中的页面仍可能存在权限差异。抽样方案应覆盖不同空间角色、不同页面层级和典型继承结构，并在报告中注明抽样比例和抽样方法；对权限敏感的空间，建议提高抽样比例或改为全量核对。链接检查有时效性，检查当天的可解析结果不代表长期可用，外部链接尤其如此，报告中应记录检查时间，并在切换后安排一次复检。
完成度也不能替代业务验收。页面所有者确认内容可用、关键用户完成实际使用确认、必要的培训与公告到位，这些是切换前的独立动作。建议把完成度报告作为验收材料的一部分，与业务确认记录并列归档，形成“定量指标 + 定性确认”的完整证据链。
在迁移项目的核对与验收环节，可以把页面清单、附件校验记录、链接检查报告和权限抽样记录作为工作项或文档附件集中管理，让每类缺口有负责人、有处理状态、有复核记录。ONES 的 Confluence 迁移方案覆盖空间、页面、附件和权限结构的迁移，目标端为 ONES Wiki，迁移数据包括用户、用户组、空间权限与页面权限，并支持页面正文、附件、图片、常用宏及批注的迁移；这些范围信息可以帮助在迁移前把分母口径与源端对象类型对齐。完成度统计报表、链接改写校验和附件校验值比对的具体支持方式，需在迁移方案确认阶段与实施方逐项核实，再决定哪些核对动作借助工具完成、哪些依靠导出清单人工比对。
常见问题
统计基准日之后源端又修改了页面，这部分算不算本轮完成度？
不算。统计基准日一旦确定，分母随之固定，基准日之后源端的新增或修改进入下一轮增量统计，不混入本轮完成度。迁移期间源端仍在变更时，建议在迁移方案中写明基准日、增量窗口和每轮的统计范围，并在报告中标注本轮数据的截止时间，避免不同轮次的结果被直接比较。
某个空间没有附件，附件完成度应该记 0% 还是 100%？
两者都不对，应标注“不适用”。分母为零的指标不参与加权汇总，也不拉低整体结果。报告中保留该项并注明原因，便于复核者确认是确实没有附件，还是清单导出遗漏。
页面正文迁过去了但附件没迁，页面指标里算完成吗？
不算。页面指标统计的是“已建且内容校验通过”的页面，正文已迁、附件未迁的页面在页面指标中计为未通过，同时在附件指标中按实际附件状态计入。两类指标各自反映各自的问题，缺口清单中应把这类页面单独列出，便于安排补迁。
权限抽样只覆盖了部分页面，结论能代表全部页面吗？
不能完全代表。抽样应覆盖不同空间角色、不同页面层级和典型继承结构，报告中注明抽样比例与方法。对权限敏感的空间，建议提高抽样比例或改为全量核对；未抽中的页面仍可能存在权限差异，切换后安排一次复检更稳妥。
总完成度达到约定数值，是否就可以关闭源端？
不一定。总完成度用于汇报和趋势跟踪，能否切换或收尾以各分项阈值是否全部满足为准。此外还需完成业务验收：页面所有者确认内容可用、关键用户完成实际使用确认、必要的培训与公告到位。建议把完成度报告与业务确认记录并列归档，形成定量指标加定性确认的完整证据链。
迁移过程中借助工具承载核对记录，需要注意什么？
把页面清单、附件校验记录、链接检查报告和权限抽样记录集中管理，让每类缺口有负责人、有处理状态、有复核记录，可以减少统计时反复找数。ONES 的 Confluence 迁移方案覆盖空间、页面、附件和权限结构的迁移，目标端为 ONES Wiki，迁移数据包括用户、用户组、空间权限与页面权限，并支持页面正文、附件、图片、常用宏及批注的迁移，可用于在迁移前对齐分母口径与源端对象类型。完成度统计报表、链接改写校验和附件校验值比对的具体支持方式，需在迁移方案确认阶段与实施方逐项核实。
