Confluence 空间迁移交接时，把空间、页面树、附件和权限四类信息分散写在邮件和聊天记录里，最容易在验收阶段出现“谁确认过、缺了哪一页、附件是否带全”的争议。一份可填写的交接模板应以空间级主表为核心，配合页面树、附件、权限三张子表，字段按必填、条件必填、选填三档标注，交接双方用同一份表逐项核对。交接清单和遗留问题也可以放进 ONES 的工作项与文档中跟踪，便于迁移结束后继续复查。
要点总览（TL;DR）
- 交接模板以一张空间级主表为核心，配合页面树清单、附件清单、权限与用户组映射清单三张子表，四张表通过空间键关联。
- 主表必填字段覆盖空间标识、迁移范围、页面总数、页面树与权限处理方式、迁移批次、验收标准、验收人和回退安排，任一缺失应退回补充。
- 排除项、附件处理、宏或嵌入内容、外链、匿名访问与外部协作者属于条件必填，触发条件成立而字段为空即视为材料不完整。
- 填写时先核对必填字段，再按触发条件补齐条件必填项，最后抽查选填字段，三项通过后才进入签字环节。
- 模板可按迁移批次拆分或合并，小团队可压缩明细粒度，但空间键、范围说明、页面总数、验收人和回退安排应保留。
可复制空白交接模板：主表与三张子表
下面四张表可直接复制到文档或表格工具中填写。主表一行对应一个迁移空间；三张子表通过“空间键”与主表关联，同一空间有多条记录时逐行追加。表头保持统一，便于不同批次汇总比对。
表一：空间级交接主表
| 字段 | 填写内容 | 分级 |
|---|---|---|
| 空间键 | 必填 | |
| 空间名称 | 必填 | |
| 来源地址 | 必填 | |
| 来源负责人 | 必填 | |
| 接收负责人 | 必填 | |
| 迁移范围说明 | 必填 | |
| 排除项及原因 | 条件必填 | |
| 页面总数 | 必填 | |
| 页面树处理方式 | 必填 | |
| 附件处理方式 | 条件必填 | |
| 权限映射方式 | 必填 | |
| 迁移批次 | 必填 | |
| 计划时间窗口 | 必填 | |
| 验收标准 | 必填 | |
| 验收人 | 必填 | |
| 回退点与回退方式 | 必填 | |
| 遗留问题 | 条件必填 | |
| 交接双方签字与日期 | 必填 |
表二：页面树清单
| 空间键 | 页面标题 | 父页面 | 层级路径 | 页面类型 | 含宏或嵌入 | 外链情况 | 处理结论 | 备注 |
|---|---|---|---|---|---|---|---|---|
表三：附件清单
| 空间键 | 所属页面 | 附件名称 | 文件类型 | 体积 | 是否随页迁移 | 替代存放位置 | 备注 |
|---|---|---|---|---|---|---|---|
表四：权限与用户组映射清单
| 空间键 | 来源用户组或个人 | 权限类型 | 作用范围 | 目标用户组或个人 | 映射依据 | 是否需人工确认 | 确认人 |
|---|---|---|---|---|---|---|---|
字段说明：每个字段记录什么、怎么填
字段说明的作用是让来源方、接收方和验收人按同一口径填写。以下按四类信息分别解释，填写时以主表为索引，子表只记录明细。
空间标识类字段
空间键是 Confluence 空间的唯一短标识，也是四张表关联的主键，必须与来源系统保持一致，不能自行改写。空间名称填写来源空间的完整名称，便于不熟悉空间键的接收人识别。来源地址记录空间首页或空间设置的访问路径，迁移后用于回溯核对。来源负责人指对该空间内容负责的人，接收负责人指迁移后承接维护职责的人，两者可以不同，但都要能对验收结论表态。
范围类字段
迁移范围说明用一两句话写清本次迁移覆盖哪些内容，例如全部页面与附件、仅指定页面子树、仅正文不含历史版本。排除项及原因逐条列出不迁移的页面、附件或功能，并写明原因，例如已归档、内容重复、依赖外部系统。页面总数填写迁移范围内的页面数量，作为验收时数量核对的基准；数量以导出清单为准，不凭印象估算。
页面树与附件字段
页面树清单中的父页面和层级路径记录页面在来源空间中的位置，处理结论填写保留原层级、调整层级或合并到其他页面。页面类型区分普通页面、模板页、博客等，含宏或嵌入字段标注页面是否使用了宏、嵌入内容或第三方插件，这类内容需要在迁移前逐项确认覆盖情况。外链情况记录页面引用的外部链接或跨空间链接，迁移后需要检查是否仍然可达。附件清单记录附件名称、类型和体积，是否随页迁移字段明确附件是随页面一起迁移、单独处理还是留在原处，替代存放位置用于填写不迁移附件的去向。
权限字段
权限映射清单按来源用户组或个人逐条记录，权限类型填写查看、编辑、管理等等级，作用范围区分空间级和页面级。目标用户组或个人填写迁移后对应的对象，映射依据写明是按同名用户组、按职责对应还是人工指定。匿名访问和外部协作者需要单独成行标注，并勾选是否需人工确认，因为这类权限在迁移后往往需要重新评估开放范围。ONES 的 Confluence 迁移方案涉及用户、用户组、空间权限与页面权限的迁移，具体映射细则仍应在迁移前由双方逐条核对。
交接与验收字段
迁移批次标识本次交接属于第几批，时间窗口写明计划开始与完成时间。验收标准写成可核对的条目，例如页面数量一致、抽样页面内容完整、附件可打开、权限与清单一致。验收人填写实际执行核对的人，回退点与回退方式写明在哪个环节之前可以中止并恢复原状。遗留问题记录本次未解决的事项、责任人和计划完成时间，签字与日期由交接双方在核对完成后填写。
必填与选填：哪些字段缺失就不能交接
字段分级的目的是让交接有明确的阻断线：必填字段缺失时，交接不应进入验收；条件必填字段在触发条件成立时必须补齐；选填字段按实际需要填写，不影响交接成立。
必填字段与缺失后果
主表中的空间键、空间名称、来源地址、来源负责人、接收负责人、迁移范围说明、页面总数、页面树处理方式、权限映射方式、迁移批次、计划时间窗口、验收标准、验收人、回退点与回退方式、签字与日期属于必填。缺少空间键或来源地址，接收方无法定位来源内容；缺少范围说明和页面总数，验收时没有数量基准；缺少验收人和回退安排，出现问题时分不清责任和处置路径。这些字段任一缺失，交接表应退回补充。
条件必填字段的触发条件
排除项及原因在存在不迁移内容时必填；附件处理方式在空间含附件时必填，并同步填写附件清单；遗留问题在存在未决事项时必填。页面树清单中的含宏或嵌入字段，在页面使用宏、嵌入内容或插件时必填；外链情况在页面引用外部或跨空间链接时必填。权限清单中的匿名访问、外部协作者行，在空间存在此类权限时必填，并标注是否需人工确认。触发条件成立而字段为空，视为交接材料不完整。
选填字段的适用场景
备注类字段、替代存放位置、映射依据的补充说明属于选填，用于记录特殊情况。团队规模较小、空间结构简单时，页面类型、层级路径等字段可以合并填写；跨团队交接或空间页面数量较多时，建议逐页填写，减少验收时的抽样争议。
字段分级与验收的对应关系
验收时先检查必填字段是否齐全，再按条件必填字段核对触发条件，最后抽查选填字段的记录质量。必填字段齐全、条件必填字段按触发条件补齐、验收标准逐条有结论，三项同时满足才进入签字环节。这样分级后，交接双方不必争论“信息够不够”，而是按同一张表判断能否交接。
填写示例：一个空间从登记到签字确认
以下为演示情景，用于说明字段用法，不代表真实客户案例。假设某产品团队将“产品文档”空间迁出，空间键为 PRODDOC，含 86 个页面和 214 个附件，其中 3 个页面使用宏，2 个附件体积较大不随页迁移。
主表填写
空间键填 PRODDOC，空间名称填“产品文档”，来源地址填该空间首页路径，来源负责人为文档维护人，接收负责人为迁移后承接的知识库管理员。迁移范围说明写“全部 86 个页面及正文，附件按清单处理”，排除项写“2 个超过体积阈值的安装包附件，改存共享盘”。页面总数填 86，页面树处理方式填“保留原层级”，附件处理方式填“随页迁移，大附件单独处理”，权限映射方式填“按用户组同名映射，个人权限逐条确认”。迁移批次填“第 1 批”，时间窗口填计划起止日期，验收标准写“页面数量一致、抽样 10 页内容完整、附件可打开、权限与清单一致”，验收人填知识库管理员，回退点写“正式切换前可回退至来源空间”，遗留问题记录宏页面待确认项，最后双方签字并注明日期。
页面树与附件子表填写
页面树清单逐行记录 86 个页面，父页面和层级路径按来源结构填写，含宏或嵌入字段对 3 个使用宏的页面标注“是”，处理结论写“迁移前确认宏覆盖范围”。附件清单记录 214 条附件，其中 2 个大附件在是否随页迁移字段填“否”，替代存放位置填共享盘路径，其余填“是”。
权限映射子表填写
权限清单按来源用户组逐条记录，例如“产品组—查看—空间级—目标同名用户组—按同名映射—无需人工确认”；个人权限逐条列出并标注需人工确认；匿名访问行单独记录，确认人填写知识库管理员。ONES 迁移方案覆盖用户、用户组、空间权限与页面权限，映射结果仍需以本清单的人工确认为准。
交接双方确认与遗留问题记录
验收人按验收标准逐条核对后，在遗留问题栏记录“3 个宏页面待确认迁移效果，责任人来源负责人，计划完成时间”，双方签字确认本批次交接完成。遗留问题转入后续跟踪，未关闭前不视为该空间完全交付。
调整与维护方法：按团队规模与迁移批次裁剪字段
模板需要在多个批次和不同团队之间重复使用，字段既要保持可比，也要允许按实际情况裁剪。调整的原则是保留关联主键和阻断性字段，压缩明细字段的填写粒度。
按迁移批次拆分或合并表格
空间数量多时，主表按批次拆分为多个文件，每个文件保留相同的表头，子表通过空间键关联；空间数量少时，可以把多个空间合并到一张主表，用批次字段区分。批次拆分后，验收标准和回退安排按批次分别填写，避免不同批次的结论混在一起。
按团队规模裁剪字段的取舍原则
小团队交接、空间结构简单时，可以合并页面类型和层级路径字段，附件清单按页面汇总而非逐条记录；跨团队交接或页面数量较多时，保留逐页、逐附件记录，并增加抽样验收说明。裁剪时不能删除空间键、范围说明、页面总数、验收人和回退安排，这些字段决定交接能否成立。
字段版本与变更记录方式
模板本身应有版本号和变更记录，写明新增、删除或修改了哪些字段及原因。字段口径变化时，同步更新字段说明和填写示例，避免不同批次使用不同口径导致汇总失真。变更记录可以放在主表末尾或单独的说明页。
交接完成后的归档与复查
签字确认后，主表与三张子表作为同一套材料归档，与迁移批次对应保存。遗留问题转入跟踪清单，按计划完成时间复查；复查完成后在遗留问题栏补充关闭结论。后续如发现页面缺失或权限异常，以归档的交接表为核对依据，定位是范围遗漏、附件处理还是权限映射问题。ONES 的工作项与文档可以承载这份交接清单和遗留问题跟踪，让迁移结束后的复查仍有明确的责任人和状态记录。
常见问题
空间里页面数量很多时，页面树清单必须逐页填写吗？
页面数量多、跨团队交接时，建议逐页填写页面树清单，父页面、层级路径和处理结论逐条记录，验收时按清单抽样核对，减少“哪一页漏了”的争议。空间结构简单、交接双方对内容范围已有共识时，可以按页面子树汇总填写，但页面总数和范围说明仍要写清。无论采用哪种粒度，含宏或嵌入内容、外链情况这两类字段在触发条件成立时都要逐项标注。
附件不随页面迁移时，交接表里怎么记录才不会遗漏？
在附件清单中把该附件的“是否随页迁移”填为否，并在“替代存放位置”写明去向，例如共享盘路径或另行归档的位置。主表的附件处理方式字段同步说明大附件单独处理，排除项及原因中列出不迁移的附件及原因。验收时按附件清单逐条核对可打开性和存放位置，避免迁移完成后才发现附件缺失。
权限映射清单里哪些情况需要人工确认？
按同名用户组映射、职责对应清晰的权限，可以在映射依据中写明规则后直接对应。个人权限、匿名访问和外部协作者建议单独成行并标注需人工确认，因为这类权限在迁移后往往需要重新评估开放范围。ONES 的 Confluence 迁移方案涉及用户、用户组、空间权限与页面权限的迁移，具体映射细则仍应在迁移前由交接双方逐条核对，确认人填写实际核对的人。
交接表签字后才发现页面或权限有问题，怎么处理？
以归档的交接表为核对依据，先定位问题属于范围遗漏、附件处理还是权限映射，再对照主表和对应子表确认责任环节。签字时记录的遗留问题应继续跟踪，按计划完成时间复查并在遗留问题栏补充关闭结论；未关闭前该空间不视为完全交付。后续复查可以借助工作项与文档记录责任人和状态，让处理过程有据可查。
多个空间分批迁移时，交接模板要每个批次各做一份吗？
空间数量多时，主表按批次拆分为多个文件，每个文件保留相同表头，子表通过空间键关联，验收标准和回退安排按批次分别填写。空间数量少时，可以把多个空间合并到一张主表，用迁移批次字段区分。拆分或合并后，模板版本号和变更记录要同步更新，保证不同批次的口径一致、汇总时不失真。
