Confluence 空间迁出时，交接模板用来把“谁交、交什么、怎么迁、迁完谁验”记录在同一套表里，避免迁移前后靠口头确认。建议用一张交接主表承载责任与迁移范围，再配空间清单、页面树清单、附件清单、权限映射清单四张子表，分别对应空间、页面、附件和权限四类对象。下面给出可直接复制的空白表格、字段口径、必填划分、填写示例与维护方法。
要点总览（TL;DR）
- 模板由一张交接主表加空间清单、页面树清单、附件清单、权限映射清单四张子表组成，以空间标识作为唯一关联键。
- 主表必填字段包括空间标识、源空间 URL、空间负责人、接收负责人、迁移方式、计划窗口、验收人和交接状态，缺一项即暂停该空间的交接确认。
- 页面树子表记录页面路径、父页面与层级，附件子表记录附件路径、大小与类型，权限映射子表逐条写明原权限对象与目标权限组的对应关系。
- 子表核对结果全部完成后才更新主表状态；模板调整记入版本变更记录，验收后随迁移批次归档。
可复制空白交接模板
模板共五张表。主表一行记录一个空间的交接责任与迁移安排；四张子表按空间标识关联，一个空间可以有多行。复制到表格工具后，先填主表，再逐张补子表，最后回到主表更新交接状态。
交接主表
| 空间标识 | 空间名称 | 源空间 URL | 空间负责人 | 接收负责人 | 迁移方式 | 计划窗口 | 验收人 | 交接状态 | 备注 |
|---|---|---|---|---|---|---|---|---|---|
空间清单子表
| 空间标识 | 空间用途 | 页面总数 | 附件总数 | 活跃用户组 | 是否含敏感内容 | 迁移优先级 |
|---|---|---|---|---|---|---|
页面树清单子表
| 空间标识 | 页面标题 | 页面路径 | 父页面 | 层级 | 页面负责人 | 是否含宏 | 迁移结果 |
|---|---|---|---|---|---|---|---|
附件清单子表
| 空间标识 | 所属页面 | 附件名称 | 附件路径 | 文件大小 | 文件类型 | 是否需单独处理 | 迁移结果 |
|---|---|---|---|---|---|---|---|
权限映射清单子表
| 空间标识 | 原权限对象 | 原权限类型 | 原权限级别 | 目标权限组 | 目标权限级别 | 映射说明 | 核对结果 |
|---|---|---|---|---|---|---|---|
字段说明：每个字段记录什么
字段口径统一后，不同空间负责人填出来的表才能互相对照。主表回答责任与安排，子表回答对象与核对结果，填写时以空间标识作为唯一关联键。
| 所在表 | 字段 | 记录内容与填写口径 |
|---|---|---|
| 主表 | 空间标识 | 空间的唯一短标识，建议与源空间 key 一致，全表统一引用 |
| 主表 | 空间名称 | 源空间显示名称，便于非技术人员识别 |
| 主表 | 源空间 URL | Confluence 中该空间的访问地址，用于回溯原内容 |
| 主表 | 空间负责人 | 对源空间内容最熟悉、负责交付内容与说明的人 |
| 主表 | 接收负责人 | 迁移后在目标平台承接该空间的人或小组代表 |
| 主表 | 迁移方式 | 批量迁移、数据包导入或分批迁移等实际采用的方式 |
| 主表 | 计划窗口 | 约定的迁移执行时间段，写明起止日期 |
| 主表 | 验收人 | 对迁移结果做最终确认的人，可与前两项负责人不同 |
| 主表 | 交接状态 | 待准备、迁移中、待验收、已完成、已归档等阶段值 |
| 空间清单 | 空间用途 | 一句话说明空间承载的业务内容，判断是否整体迁移 |
| 空间清单 | 页面总数、附件总数 | 迁移前统计的数量，作为验收时的对照基数 |
| 空间清单 | 活跃用户组 | 当前实际访问该空间的用户组，供权限映射参考 |
| 空间清单 | 是否含敏感内容 | 标记是否涉及受限信息，决定是否需要额外审批 |
| 页面树 | 页面路径 | 从空间根页面到该页面的层级路径，保留原结构 |
| 页面树 | 父页面 | 该页面的上级页面标题，用于还原页面树 |
| 页面树 | 是否含宏 | 标记页面是否使用宏，迁移后需逐项核对显示效果 |
| 附件 | 附件路径 | 附件在源空间中的位置，通常由所属页面加文件名构成 |
| 附件 | 文件大小、文件类型 | 用于识别大文件与特殊格式，判断是否需要单独处理 |
| 权限映射 | 原权限对象 | 源空间中的用户、用户组或空间角色 |
| 权限映射 | 原权限级别 | 查看、编辑、管理等等级，按源平台实际口径记录 |
| 权限映射 | 目标权限组、目标权限级别 | 目标平台中对应的组与级别，逐条写明对应关系 |
| 权限映射 | 映射说明 | 无法一一对应时的处理方式，例如合并组或降级授权 |
必填与选填的划分
必填字段承担阻断作用：缺一项就无法确认该空间交接是否成立。选填字段用于提高核对精度，按空间规模和目标平台差异增补。划分原则是“缺了会导致责任不清或无法验收”的字段必须填。
| 字段 | 必填/选填 | 理由或适用情形 |
|---|---|---|
| 空间标识 | 必填 | 子表关联的唯一键，缺失则四张子表无法对应 |
| 源空间 URL | 必填 | 验收时需要回到源空间逐项比对 |
| 空间负责人、接收负责人 | 必填 | 明确交付与承接双方，缺失则无人对内容负责 |
| 迁移方式 | 必填 | 决定后续核对方式与工作量 |
| 计划窗口 | 必填 | 协调业务停机与通知范围 |
| 验收人 | 必填 | 迁移完成需要有明确确认人 |
| 交接状态 | 必填 | 跟踪进展的基础字段 |
| 空间名称 | 选填 | 便于识别，空间标识已能唯一定位时可省略 |
| 空间用途、迁移优先级 | 选填 | 空间数量多、需要排期时填写 |
| 页面总数、附件总数 | 选填 | 需要数量对照验收时填写 |
| 是否含敏感内容 | 选填 | 涉及合规审批的空间必须填写 |
| 页面路径、父页面、层级 | 选填 | 页面树较深或需要还原结构时逐页填写 |
| 是否含宏 | 选填 | 页面使用宏时填写，便于迁移后专项核对 |
| 附件路径、大小、类型 | 选填 | 附件多或含大文件时逐条登记 |
| 权限映射各字段 | 选填 | 空间存在跨组授权或特殊权限时必须填写 |
缺失必填项时，该空间不进入交接确认环节：先由空间负责人补齐，再由验收人复核。若某项确实不适用，填写“不适用”并注明原因，保留空白的做法会让后续核对无法区分“未填”和“无此项”。
填写示例：一个空间的完整交接记录
以下为演示情景，用来说明字段之间如何联动，数值与人员均为示例，不代表真实迁移记录。
| 空间标识 | 空间名称 | 源空间 URL | 空间负责人 | 接收负责人 | 迁移方式 | 计划窗口 | 验收人 | 交接状态 |
|---|---|---|---|---|---|---|---|---|
| PRODX | 产品文档中心 | confluence.example.com/display/PRODX | 张岚 | 李哲 | 批量迁移 | 2025-03-10 至 2025-03-12 | 王敏 | 待验收 |
| 空间标识 | 页面标题 | 页面路径 | 父页面 | 层级 | 页面负责人 | 是否含宏 | 迁移结果 |
|---|---|---|---|---|---|---|---|
| PRODX | 产品文档中心首页 | 产品文档中心首页 | — | 1 | 张岚 | 否 | 已迁移 |
| PRODX | 需求管理规范 | 产品文档中心首页/需求管理规范 | 产品文档中心首页 | 2 | 李哲 | 是 | 待核对 |
| 空间标识 | 所属页面 | 附件名称 | 附件路径 | 文件大小 | 文件类型 | 是否需单独处理 | 迁移结果 |
|---|---|---|---|---|---|---|---|
| PRODX | 需求管理规范 | 需求评审流程图.png | 产品文档中心首页/需求管理规范/需求评审流程图.png | 1.2 MB | PNG | 否 | 已迁移 |
| 空间标识 | 原权限对象 | 原权限类型 | 原权限级别 | 目标权限组 | 目标权限级别 | 映射说明 | 核对结果 |
|---|---|---|---|---|---|---|---|
| PRODX | 产品组 | 用户组 | 编辑 | 产品团队 | 编辑 | 组名变更，成员一致 | 已核对 |
| PRODX | 外部顾问 | 用户 | 查看 | 外部协作组 | 查看 | 单人授权并入协作组 | 待核对 |
示例中主表状态为“待验收”，对应页面树与权限映射中仍有“待核对”行，说明状态字段应与子表核对结果联动：子表全部核对完成后再更新主表状态，避免主表提前标记完成。
模板的调整与维护方法
模板需要在多个空间、多个批次中反复使用，调整时保持字段名稳定，新增内容通过版本记录说明，才能让不同批次的交接记录可比较。
按空间规模调整子表粒度
- 页面少于约 50 个的空间，页面树清单可只登记一级和二级页面，其余页面按数量汇总。
- 页面多、层级深的空间，逐页登记并保留父页面字段，便于迁移后按路径核对。
- 附件数量少时按页面汇总登记；含大文件或特殊格式时逐条登记大小与类型。
- 空间数量多时，在空间清单中增加迁移优先级，分批推进。
按目标平台调整权限映射字段
目标平台的权限模型与 Confluence 不完全一致时，权限映射子表需要增加“映射方式”列，记录一一对应、合并组、降级授权等处理。若目标平台按空间角色授权，可把“目标权限组”改为“目标角色”，字段含义保持不变。Confluence 迁出至 ONES Wiki 的场景中，迁移范围包括用户、用户组、空间权限与页面权限，权限映射表可按这四类对象分别登记，迁移后逐项核对。
模板版本与变更记录
| 版本号 | 变更日期 | 变更内容 | 变更人 | 影响范围 |
|---|---|---|---|---|
| V1.0 | 初始版本，含主表与四张子表 | 全部空间 | ||
| V1.1 | 权限映射增加“映射方式”列 | 含特殊授权的空间 |
字段增删都记入变更记录，已填写的旧版本记录保留原样，新批次使用新版本，避免同一批次内口径混杂。
交接完成后的归档
空间验收完成后，把主表状态更新为“已归档”，五张表随迁移批次一并存档，保留源空间 URL 与核对结果。归档记录的作用是后续出现内容缺失或权限疑问时能快速定位当时的交接人与核对结论。若团队在迁移后继续用工作项跟踪遗留问题，可把子表中“待核对”“需单独处理”的行转为任务，指定负责人和截止时间，在任务关闭后再完成归档。ONES 支持将 Confluence 空间、页面、附件和权限结构迁移至 ONES Wiki，迁移后的内容可在同一平台内继续维护，交接表中的遗留条目也便于衔接后续跟踪。
常见问题
空间里页面很多，页面树清单必须逐页登记吗？
按空间规模决定粒度。页面少于约 50 个时，可只登记一级和二级页面，其余按数量汇总；页面多、层级深时逐页登记，并保留父页面与层级字段，迁移后按路径逐项核对。无论采用哪种粒度，页面总数都应记录在空间清单中，作为验收对照基数。
源空间和目标平台的权限组名称不一致，权限映射表怎么填？
在权限映射子表中逐条写明原权限对象、原权限级别与目标权限组、目标权限级别，并在“映射说明”列记录处理方式，例如组名变更、合并组或降级授权。无法一一对应时，说明列必须写清依据，核对结果列保持“待核对”，直到接收负责人确认。
迁移过程中发现遗漏的页面或附件，模板要怎么更新？
在对应子表中补行，沿用同一空间标识，迁移结果填“待处理”，并在主表备注中说明补充原因。若遗漏影响数量对照，同步修正空间清单中的页面总数或附件总数。补充记录同样进入验收范围，验收人确认后再更新主表状态。
交接完成后，模板还需要保留吗？
需要。空间验收完成后把主表状态更新为“已归档”，五张表随迁移批次存档，保留源空间 URL 与核对结果。后续出现内容缺失或权限疑问时，可据此定位当时的交接人与核对结论。子表中“待核对”“需单独处理”的行可转为任务继续跟踪，任务关闭后再完成归档。
迁移到 ONES Wiki 时，权限映射表要覆盖哪些对象？
Confluence 数据迁移至 ONES Wiki 的范围包括用户、用户组、空间权限与页面权限，权限映射子表可按这四类对象分别登记，迁移后逐项核对。迁移方式支持批量迁移与数据包导入，主表中的“迁移方式”字段按实际采用的方式填写即可。
