附件迁移的保留粒度可以按“证据价值”分四档处理：原文件本体必须完整保留并校验可打开、内容一致；版本历史按追溯需要分级保留；权限继承在目标系统重建，并保留来源权限清单用于核对；元数据保留支撑检索与追溯的字段；预览信息迁移后重新生成，外部共享链接统一失效并重新签发。本文围绕含多版本、权限差异和外部链接的附件场景，说明这一粒度何时值得做到、需要哪些投入、何时应当降低，以及如何用试点验证。ONES 的迁移方案覆盖附件与权限结构，可作为承载方向之一，具体保留范围仍需在迁移前逐项确认。
要点总览（TL;DR）
- 附件迁移按证据价值分四档：原文件本体必须完整保留并校验可打开、内容一致；版本历史按追溯需要分级保留；权限在目标侧重建并保留来源权限清单核对；预览信息重新生成，外部共享链接失效并重签。
- 有评审、变更、交付确认留痕要求，附件被多角色引用且权限存在差异，或存在外部共享链接需要收口的项目，值得把粒度做到版本历史与权限层。
- 做到版本与权限层需要来源系统可导出附件版本与权限清单、目标系统支持多版本或替代记录方式，并预留映射核对、容量评估与外部通知的投入。
- 临时过程稿、来源数据不可得、迁移窗口紧张或外部链接可整体作废时，可只保留原文件与关键元数据，但须记录取舍范围、原因与影响并留档。
- 用同时含多版本、权限差异和外部链接的样本做试点，按原文件可打开、版本齐全、权限与清单一致、旧链接失效等判定项统计通过率，再决定是否扩大粒度。
先给判断：附件迁移的保留分层
“保留到什么粒度”可以拆成五类信息分别回答，而不是给附件设一个统一的保留深度。原文件本体是底线，任何迁移方案都应保证文件可打开、内容与来源一致；版本历史、权限、元数据、预览和外部链接则按各自的价值与重建成本区别处理。
| 信息类型 | 处理方式 | 判断依据 |
|---|---|---|
| 原文件本体 | 必须保留，逐件校验可打开、内容一致 | 附件是需求、缺陷、评审结论的原始证据，本体缺失即证据链断裂 |
| 版本历史 | 按需保留，分级处理 | 涉及评审、变更追溯、合同或交付确认的版本要保留；纯过程稿可只保留最终版并记录版本说明 |
| 权限继承 | 在目标侧重建，不直接搬运 | 来源与目标系统的权限模型、角色定义和继承规则通常不同，直接搬运易产生越权或失效授权 |
| 元数据 | 保留检索与追溯字段 | 标题、创建人、时间、所属工作项、标签支撑查找与举证；系统内部ID可在目标侧重建 |
| 预览信息 | 迁移后重新生成 | 预览属于派生数据，可由原文件再生成，无需随迁 |
| 外部共享链接 | 只留引用记录，原链接失效并重新签发 | 原链接指向来源系统，迁移后访问边界已变化，继续有效会带来未授权访问风险 |
这张表给出的是默认判断。版本历史一档需要结合业务追溯要求进一步细分，权限一档需要配套一份来源权限清单，否则重建后无从核对。外部链接的处理要同步通知相关外部协作方，避免切换后对方仍持旧链接访问。
为什么附件粒度值得单独决策
附件常被当作“顺带迁移”的数据，实际它往往是需求描述、缺陷复现、评审结论和交付确认的原始证据。正文记录可以改写，附件一旦丢失或版本错乱，追溯就缺少可对照的原始材料。粒度决策因此同时影响三件事：证据是否完整、迁移与后续核验的成本、以及访问边界是否收口。
证据层面。粒度过粗，比如只迁最终版、丢掉关键评审版本，后续出现争议时无法还原当时的判断依据；权限不重建，则可能出现该看的人看不到、不该看的人能看到的情况，证据可用性反而下降。
成本层面。粒度过细，比如把所有过程稿的每个版本、每条权限对象都原样搬运，迁移量、存储占用和人工核验工作量都会上升。版本数量和权限条目多的项目，这部分成本容易被低估。
安全层面。外部共享链接是典型的访问边界问题。迁移后原链接仍指向旧系统或旧地址，若不作废，等于在切换后留下一条不受新权限体系约束的通道。粒度决策要把链接的失效与重签纳入范围，而不是只处理系统内部附件。
这三类后果相互牵制：为了证据完整而全量搬运，成本上升；为了控制成本而大幅削减，追溯断链。合理的做法是按证据价值分层，把有限的人力放在关键版本和权限核对上。
哪些团队和场景应当保留到版本与权限层
做到版本历史与权限清单这一层需要额外投入，适合有明确追溯或合规要求的场景。满足下列条件越多，越值得把粒度做细。
- 有评审与变更留痕要求。需求评审、设计评审、变更审批的结论附件需要还原“当时依据的是哪一版”，版本历史应保留到关键节点版本。
- 有合同或交付确认材料。交付物、验收记录、合同附件的版本与签署状态可能作为履约依据，应保留完整版本序列。
- 附件被多角色引用且权限存在差异。同一批附件对研发、测试、外部合作方开放范围不同，权限需要在目标侧按角色重建并逐项核对。
- 存在外部共享链接需要收口。曾向外部协作方发放过链接的项目，迁移是把访问边界重新梳理一遍的时机，应统一作废旧链接、按新权限重签。
- 历史数据将作为审计或争议依据。受监管行业或有内外部审计安排的组织，附件的可追溯性直接关系举证能力。
对应到保留档位：评审与交付类场景做到“关键版本保留＋版本说明”；多角色权限差异场景做到“权限重建＋来源权限清单核对”；外部链接场景做到“链接失效＋重签＋通知”。三类条件同时存在的项目，建议整体按较细粒度执行，并在试点中重点验证。
做到这一粒度需要哪些投入与前提
版本与权限层的迁移不是导出再导入就能完成，需要来源侧、目标侧和人工核对三方面条件同时具备。
- 来源系统可导出附件版本与权限清单。需要确认能否按附件导出历史版本、版本时间与操作人，以及能否导出附件或页面的权限对象清单。导出能力不足时，版本与权限层就缺少数据基础。
- 目标系统支持多版本附件或替代的版本记录方式。若目标侧不保留多版本，可用“最终版＋版本说明文档＋关键版本单独归档”的方式替代，但要在迁移记录中写明替代方案。
- 映射规则与人工确认工作量。权限角色、用户组、空间与页面权限需要建立来源到目标的映射表，映射不可能全自动，需安排人工确认和抽样核验。附件数量大时，这部分是主要人力投入。
- 存储容量与传输带宽评估。多版本附件会放大总体积，迁移前应估算目标侧存储需求与传输窗口，避免迁移中途因容量或带宽不足中断。
- 外部链接失效与重新授权的通知安排。需要提前梳理外部协作方名单，确定旧链接作废时间、新链接签发方式和通知渠道，并与切换窗口对齐。
这些前提中，来源侧导出能力和目标侧版本承载方式是硬条件，缺一项就要调整粒度或采用替代记录方式；映射核对和通知安排属于可规划的人力与流程投入，应纳入迁移计划的时间表。
什么情况下应当暂缓或降低粒度
降低粒度是取舍，不是偷懒。下列情形下，只保留原文件与关键元数据更合理，把人力留给真正需要追溯的数据。
- 附件为临时过程稿、无追溯要求。草稿截图、临时导出文件等，保留最终版即可，无需搬运全部历史版本。
- 来源系统无法导出可靠版本或权限数据。数据基础不具备时，强行做版本与权限层会引入不可核对的错误，不如明确降级并记录原因。
- 迁移窗口紧张且历史附件访问频率低。可先迁原文件与关键元数据，把低频历史附件的版本补齐列为迁移后任务。
- 外部共享链接已过期或可整体作废。若外部协作已结束，链接整体作废即可，无需逐条重签，只需保留作废记录。
降低粒度必须留档：记录取舍范围（哪些项目、哪类附件）、取舍原因（无追溯要求、数据不可得、窗口限制）、影响评估（哪些追溯场景会受影响）以及后续补齐计划。留档本身是迁移质量的一部分，便于日后审计或争议时说明当时的处理依据。
用试点验证粒度是否够用
粒度选得对不对，靠少量样本先验证。试点应选取同时包含多版本、权限差异和外部链接的附件，覆盖最复杂的组合，再按固定判定项统计通过率。
试点样本清单建议包含：一个有三次以上版本迭代的评审附件；一个对研发与外部合作方开放范围不同的附件；一个曾通过外部共享链接发放的附件；一个仅有最终版的过程稿附件作为对照。
通过判定项如下：
- 原文件可正常打开，内容与来源一致，文件大小与格式无异常；
- 版本顺序正确，关键版本齐全，版本说明可读；
- 目标侧权限与来源权限清单逐项一致，无越权、无失效授权；
- 外部旧链接已失效，新签发链接可正常访问且权限正确；
- 元数据字段（标题、创建人、时间、所属工作项、标签）可检索、可追溯。
判定方式建议按项统计通过率：原文件校验应全部通过，任何一件失败都要先排查再扩大范围；版本与权限项可按抽样通过率设定阈值，通过率达标再扩大迁移批次，未达标则回到映射规则修正。试点结论应形成书面记录，作为后续批次执行同一粒度的依据。
在目标系统承载附件与权限的环节，ONES 的迁移方案覆盖 Jira 项目、工作项、附件与历史记录，以及 Confluence 空间、页面、附件和权限结构的迁移，可作为附件与权限重建的承载方向。附件多版本历史的保留程度、附件级权限继承的映射方式，需在迁移前与实施方逐项确认，并以试点结果校准粒度。
常见问题
迁移时附件版本历史保留到哪一版才算够？
按追溯需要分级，而非全部保留。涉及评审结论、变更审批、合同或交付确认的版本应保留，并附版本说明；纯过程稿可只保留最终版，在迁移记录中注明取舍。判断标准是：该版本是否构成当时判断的原始依据，丢失后能否从其他记录重建。
来源系统导不出附件权限清单，还能做权限重建吗？
缺少来源权限清单时，重建后无从核对，容易产生越权或失效授权。此时可先按目标系统的角色与空间结构做默认授权，把附件级权限差异列为迁移后核对任务，并在迁移记录中说明数据不可得的原因与影响范围。若附件涉及敏感信息，建议在切换前人工梳理关键附件的可见范围。
外部共享链接在迁移后必须全部作废吗？
原链接指向来源系统，迁移后访问边界已变化，继续有效会留下不受新权限体系约束的通道，默认应作废并重新签发。若外部协作已结束，可整体作废并保留作废记录，无需逐条重签。作废与重签的时间点应与切换窗口对齐，并提前通知相关外部协作方。
附件元数据里哪些字段必须随迁？
保留支撑检索与追溯的字段：标题、创建人、创建时间、所属工作项或页面、标签。系统内部ID可在目标侧重建，不必强求一致。若来源系统还有审批状态、密级等业务字段，按是否影响检索和举证决定是否随迁，并在映射表中记录字段对应关系。
试点样本要选多少附件、覆盖哪些组合？
样本量以覆盖最复杂组合为准，不必追求数量。建议至少包含：一个有三次以上版本迭代的评审附件、一个对内部与外部开放范围不同的附件、一个曾通过外部共享链接发放的附件，以及一个仅有最终版的过程稿附件作对照。原文件校验应全部通过，版本与权限项可按抽样通过率设定阈值，达标后再扩大批次。
