从Confluence迁移到ONES Wiki之前，盘点要回答三个问题：哪些空间和页面需要迁、它们之间是什么层级与引用关系、谁在源端拥有什么权限。做法是先导出空间清单并标注迁移优先级，再按空间逐层导出页面树，记录页面ID、父页面、附件和宏使用情况，最后导出空间与页面级权限清单，把用户组、个人授权和外部协作者对应到目标端的角色与空间成员。盘点结果要形成可核对的清单和映射表，作为试迁移与验收的输入。
要点总览（TL;DR）
- 盘点先划边界：记录Confluence部署形态、版本与空间总数，把空间、页面树、宏与外部依赖、权限对象四类纳入清单，归档与敏感空间写明排除原因。
- 空间与页面台账按空间逐层导出，至少记录页面ID、父页面、页面类型、附件、宏使用情况和跨空间引用，迁移优先级分首批、次批、暂缓三档。
- 权限盘点把用户组、个人授权、页面限制和匿名访问分开记录，按查看、编辑、评论、管理拆开粒度，再映射到ONES Wiki的空间成员与角色。
- 盘点结果用数量对齐、分层抽样和代表性空间试迁移三步核验，签字后冻结为基线版本，作为试迁移验收的比对依据。
- 权限数据导不全、宏依赖超预期或权限模型差异过大时，先暂停并收缩范围，把问题记录在案再决定是否继续。
盘点范围：迁哪些空间、页面和权限对象
盘点的第一步是把边界划清楚。Confluence站点往往积累了多年内容，全部纳入盘点会让工作量失控，范围过窄又会在试迁移时暴露遗漏。建议先记录源端基本信息：Confluence的部署形态与版本、站点下的空间总数、每个空间的负责人和最近活跃时间。这些信息决定了后续导出方式和盘点深度。
纳入盘点的对象应覆盖四类。第一类是空间本身，包括空间名称、空间标识（key）、空间类型和空间负责人。第二类是页面树，包括普通页面、博客文章、模板页面，以及页面下的附件和评论。第三类是页面中的宏与外部依赖，宏决定了迁移后内容能否正常呈现，外部链接和跨空间引用决定了迁移后是否需要修补。第四类是权限对象，包括用户组、个人授权、页面限制和匿名访问设置。
目标端ONES Wiki的空间与权限模型是盘点的参照系。ONES的Confluence迁移方案支持将空间、页面、附件和权限结构迁移到ONES Wiki，迁移数据包括用户、用户组、空间权限与页面权限。盘点时按“源端对象—目标端承载方式”成对记录，能让后续映射有据可依。具体到某个宏能否自动转换、某类页面限制如何对应，需要在盘点中逐项标注并留待迁移方案确认。
明确排除或暂缓的对象同样要写进范围说明。常见的情况包括：已归档且无人维护的历史空间、重复建设的同名空间、仅用于临时协作的草稿空间、包含敏感信息且不宜迁移的空间。每一条排除都要写明原因和责任人，避免盘点结束后被质疑漏迁。范围说明建议由IT管理员与各空间负责人共同确认，形成书面记录。
盘点前需要准备哪些输入与权限
盘点能否顺利执行，取决于账号权限和数据来源是否到位。Confluence侧通常需要两类权限：站点管理员权限用于导出全站空间清单和权限报表，空间管理员权限用于查看空间内的页面树、页面限制和空间权限设置。如果盘点人员只有普通用户权限，页面限制和部分空间配置将不可见，盘点结果会存在盲区。
导出方式要提前确认。Confluence一般支持按空间导出、按页面树导出，管理员还可以通过权限报表或管理界面查看空间权限和用户组。不同版本和部署形态下可用的导出入口不同，盘点前应实际验证一次导出结果是否包含所需字段。对于权限数据，建议同时保留界面截图或导出文件，作为后续核对的证据。
参与角色建议明确分工。IT管理员负责账号权限、导出操作和源端数据完整性；空间负责人负责确认本空间的迁移优先级、页面取舍和特殊授权；业务代表负责判断内容是否仍有业务价值。三类角色在盘点表上各自签字，可以减少后续争议。
盘点模板要在动手前定好字段。空间清单至少包含空间名称、空间标识、负责人、页面数量、最近更新时间、迁移优先级、备注。页面台账至少包含页面ID、标题、父页面ID、页面类型、作者、更新时间、附件数量、宏使用情况、跨空间引用、迁移优先级。权限清单至少包含授权对象类型（用户组或个人）、授权对象名称、权限级别、作用范围（空间级或页面级）、是否外部协作者。字段定义统一后，不同人导出的数据才能合并核对。
空间与页面清单怎么导出和整理
空间清单是盘点的骨架。按空间逐个导出页面树，记录每个页面的ID、标题、父页面、作者和更新时间，可以还原出完整的层级结构。页面ID尤其重要，它是跨空间引用、附件归属和迁移后逐条核对的锚点。父页面字段用于重建页面树，迁移后如果层级错乱，可以据此定位问题页面。
页面类型要单独标注。普通页面、博客文章、模板页面在目标端的承载方式可能不同，模板页面还涉及是否作为模板复用。附件要记录数量和大小，附件体积直接影响迁移批次划分。宏使用情况建议按宏名称统计出现次数，并标注该宏在迁移后是否需要人工处理。ONES的迁移能力覆盖页面正文、附件、图片、常用宏及批注，但“常用宏”的具体清单需要在盘点阶段逐项核对，不能默认所有宏都能自动转换。
迁移优先级建议用三个维度综合判断：访问量或近期活跃度、最近更新时间、是否有明确的业务负责人。高频访问且近期仍在更新的页面优先迁移；长期无人访问但属于合规留存的内容可以后置；无人认领的页面先标记待确认，不急于纳入首批。优先级分为首批、次批、暂缓三档即可，档位过多反而难以执行。
跨空间引用和外部链接要单独识别。Confluence页面中常见的空间内链接、跨空间链接、外部网址，在迁移后可能失效或指向错误位置。盘点时记录引用所在页面和引用目标，形成依赖清单，试迁移后逐条验证。下表可作为空间页面迁移台账的字段参考。
| 字段 | 说明 | 用途 |
|---|---|---|
| 空间标识 | 源端空间的唯一标识 | 区分空间，避免同名混淆 |
| 页面ID | 源端页面的唯一编号 | 迁移后逐条核对 |
| 父页面ID | 上级页面编号 | 重建页面树层级 |
| 页面类型 | 普通页面、博客、模板 | 确定目标端承载方式 |
| 附件数量与大小 | 页面下附件统计 | 划分迁移批次 |
| 宏使用情况 | 宏名称与出现次数 | 识别需人工处理的页面 |
| 跨空间引用 | 引用目标空间与页面 | 试迁移后验证链接 |
| 迁移优先级 | 首批、次批、暂缓 | 安排迁移顺序 |
权限盘点：从Confluence权限到ONES Wiki角色映射
权限盘点的目标是回答“谁在源端能看什么、能改什么”，并把它翻译成目标端的空间成员与角色。Confluence侧的权限来源包括空间权限、页面限制、用户组和个人授权。导出时要区分授权对象是用户组还是个人，因为组权限和个人权限在目标端可能对应不同的配置方式，混在一起记录会导致映射错误。
权限级别要拆开记录。查看、编辑、评论、管理是四类不同的能力，盘点表中应为每个授权对象分别标注。只记录“有权限”会丢失粒度，迁移后可能出现该能编辑的人只能查看，或不该管理的人获得了管理权限。页面级限制要单独列出，它与空间级权限叠加生效，盘点时注明限制的页面范围和受限对象。
映射到ONES Wiki时，以空间成员和角色为落点。ONES的迁移数据包括用户、用户组、空间权限与页面权限，盘点阶段应把源端的每个授权对象对应到目标端的空间成员身份和角色，形成权限映射表。源端空间管理员通常对应目标端空间管理员角色，源端普通成员对应编辑或查看角色，具体对应规则需结合目标端的角色定义确认。映射表要保留源端授权对象名称，便于回溯核对。
特殊授权要单独处理。外部协作者、匿名访问、仅评论权限、临时授权都属于容易在迁移中丢失或被放大的对象。盘点时逐条记录授权对象、授权范围、授权原因和有效期，并标注目标端是否保留。对于匿名访问，需要业务方明确迁移后是否仍需要公开访问，不能默认延续。下表可作为权限映射表的框架。
| 源端授权对象 | 对象类型 | 权限级别 | 作用范围 | 目标端空间成员/角色 | 处理说明 |
|---|---|---|---|---|---|
| 示例：产品组 | 用户组 | 查看、编辑 | 空间级 | 空间成员，编辑角色 | 按组整体映射 |
| 示例：张三 | 个人 | 管理 | 空间级 | 空间管理员 | 确认是否仍担任负责人 |
| 示例：外部供应商 | 个人 | 查看 | 页面级 | 待确认 | 核实合作是否延续 |
盘点结果如何核验并作为试迁移输入
盘点完成的第一个核验动作是数量对齐。把盘点表中的空间数、页面数、附件数与Confluence管理界面的统计数字逐项比对，差异要能解释：是排除了归档空间，还是页面限制导致部分页面不可见。数量对不上就进入试迁移，后续验收将缺少基准。
第二个动作是抽样核对。按空间规模和页面类型分层抽样，检查页面树层级是否与源端一致、父页面关系是否正确、权限映射是否覆盖了所有授权对象。抽样比例可以根据空间数量确定，重点覆盖有页面限制、有外部协作者、宏使用密集的空间。抽样发现的问题要回写到台账，而不是口头记录。
第三个动作是选取代表性空间做试迁移。代表性空间应同时包含普通页面、附件、常用宏、页面限制和跨空间引用，规模不宜过大，便于逐条比对。试迁移的验收标准直接来自盘点表：页面数量是否一致、层级是否还原、附件是否完整、权限是否按映射表生效。ONES方案建议在正式迁移前确认数据范围、功能匹配和系统适配，盘点结果正是这些确认的输入。
盘点结果需要签字确认并记录版本。空间负责人确认本空间的页面取舍和优先级，IT管理员确认数据完整性，业务代表确认权限映射符合实际。确认后的台账冻结为基线版本，后续如有调整，记录变更内容和原因，避免试迁移时使用的清单与最终版本不一致。
盘点的停止条件与回退准备
盘点阶段发现权限数据无法完整导出时，应暂停而不是带着缺口继续。常见原因是账号权限不足、页面限制导致部分内容不可见、导出工具不支持某些权限类型。处理方式是先补齐管理员权限或改用其他导出入口，仍无法获取时，由空间负责人手工补充关键授权记录，并在台账中标注数据来源和可信度。
页面数量或宏依赖明显超出预期时，应收缩范围而不是延长盘点周期。可以把空间按优先级分批，首批只纳入高频使用且宏依赖简单的空间，复杂宏集中的空间单独评估。ONES建议先梳理实际使用的插件，再通过ONES Project、Wiki、TestCase、流程自动化和开放能力进行功能匹配，定制场景逐项评估。盘点中发现的复杂宏和插件依赖，应进入这份评估清单，而不是假设都能一一对应。
源端与目标端权限模型差异过大时，需要先做映射评估再决定是否继续。例如源端大量使用页面级个人授权，而目标端以空间成员角色为主，直接映射可能放大或缩小权限。此时应列出差异清单，由业务方确认哪些授权可以合并、哪些必须保留，评估结论可能指向调整迁移范围或改变权限设计。
盘点结果与业务预期不符时，启动复核机制。典型情形包括：业务方认为重要的空间在台账中优先级偏低、大量页面无人认领、权限映射后关键人员失去访问能力。复核由空间负责人牵头，逐条确认后更新台账并重新签字。盘点阶段的停止和调整都应记录在案，作为后续迁移决策的依据，而不是在正式迁移时才暴露问题。
常见问题
Confluence空间很多，盘点必须一次全部做完吗？
不必一次做完。可以按空间优先级分批盘点：先处理高频使用、近期仍在更新、有明确负责人的空间，形成首批台账并进入试迁移；归档空间和无人认领的空间先登记基本信息，标注暂缓原因，等首批验证后再决定是否纳入。分批的前提是每批都完成数量对齐和签字确认，避免后补数据与已冻结的基线混在一起。
盘点人员只有普通用户权限，能完成权限盘点吗？
普通用户权限通常看不到页面限制和完整的空间权限配置，盘点结果会存在盲区。建议至少为盘点人员开通站点管理员权限用于导出全站空间清单和权限报表，并为各空间负责人开通空间管理员权限，用于查看本空间的页面树和授权设置。权限确实无法提升时，由空间负责人手工补充关键授权记录，并在台账中标注数据来源。
Confluence里的宏在ONES Wiki中都能自动转换吗？
不能默认全部自动转换。ONES的Confluence数据迁移支持迁移页面正文、附件、图片、常用宏及批注，其中“常用宏”的具体覆盖清单需要在迁移前逐项核对。盘点时应按宏名称统计出现次数，把复杂宏和插件依赖单独列出，进入ONES建议的插件梳理与功能匹配评估，逐项确认迁移后是自动转换、人工处理还是调整呈现方式。
源端大量使用页面级个人授权，映射到ONES Wiki时怎么处理？
先把页面级个人授权单独列出，记录授权对象、受限页面范围、权限级别和授权原因，再与目标端以空间成员角色为主的模型做差异评估。可以由业务方确认哪些个人授权可以合并到用户组或空间角色，哪些必须保留为单独配置。差异清单确认后再更新权限映射表，避免直接按名称对应导致权限被放大或缩小。
试迁移应该选什么样的空间，盘点表要提供哪些信息？
代表性空间宜同时包含普通页面、附件、常用宏、页面限制和跨空间引用，规模不宜过大，便于逐条比对。盘点表需要为该空间提供完整的页面台账、附件统计、宏使用清单、跨空间引用清单和权限映射表，试迁移验收时按这些字段逐项核对页面数量、层级还原、附件完整性和权限生效情况。ONES方案也建议在正式迁移前确认数据范围、功能匹配和系统适配，盘点表正是这些确认的输入。
