研发附件迁移时，保留范围可以按“业务可追溯性”分级判断：原文件本体完整迁移；版本历史在需要回溯评审、变更依据或合规留痕时保留；权限按目标系统模型重建，保留权限意图；与检索、审计、工作项关联的元数据必须保留；预览信息可重建；外部共享链接一般只保留引用记录并在迁移后重新签发。下文给出六类对象的判断表、必须保留与可重建清单，以及试点验证方法。
要点总览（TL;DR）
- 附件保留范围按业务可追溯性分级：原文件本体必须完整迁移，版本历史按回溯与合规需求条件保留，预览信息可重建，外部共享链接只保留引用记录并重新签发。
- 权限继承迁移的是权限意图而非原权限对象：迁移前导出“谁应可见、谁应可编辑”清单，再按目标系统权限模型重建，模型差异过大时降级为基础权限加敏感附件单独核对。
- 元数据中与检索、审计、工作项关联的字段必须保留并完成字段映射，纯展示性字段可重建；判断标准是缺少该项是否会导致追溯中断。
- 历史附件量过大、版本链不完整、合规口径未明确时，应分批迁移或暂缓定级，先迁文件本体和基础元数据，并形成书面记录。
- 用覆盖多版本、权限继承、外部共享链接三类场景的试点验证保留粒度，观察文件可打开、版本可回溯、权限符合预期、引用可定位，通过后再全量执行。
先给判断：附件保留范围按什么分级
附件迁移的保留范围需要逐类判断，依据三条标准：业务可追溯性（能否支撑评审回溯和变更依据）、合规留痕要求（审计时能否提供完整证据链）、重建成本（迁移与重建哪个更省事、更可靠）。三条标准指向同一结论：支撑追溯和审计的内容优先保留，纯展示性、可再生成的内容可以重建。
下表给出六类附件对象的保留判断结论，可作为迁移方案讨论的起点。
| 对象 | 保留判断 | 判断依据 | 处理方式 |
|---|---|---|---|
| 原文件本体 | 必须完整保留 | 文件可打开、可下载是迁移底线 | 全量迁移，迁移后逐个校验可打开 |
| 版本历史 | 条件保留 | 存在评审回溯、变更依据或合规留痕需求时保留；否则可只留最新有效版本 | 按附件所属业务对象分级，逐批确认 |
| 权限继承 | 保留权限意图，重建权限对象 | 原权限对象无法跨系统直接沿用，但“谁应可见、谁应可编辑”必须延续 | 导出权限意图清单，按目标系统权限模型重建 |
| 元数据 | 检索、审计、工作项关联字段必须保留 | 这些字段决定迁移后能否定位附件、还原上下文 | 字段级映射，迁移后抽样核对 |
| 预览信息、缩略图 | 可重建 | 属于派生数据，可由原文件重新生成 | 迁移后由目标系统重新生成，不单独迁移 |
| 外部共享链接 | 只保留引用记录 | 旧链接指向原系统地址，跨系统通常无法延续 | 记录链接指向的对象与范围，迁移后重新签发 |
这张表的核心意思是：保留范围按对象分级，不按“全留”或“只留文件”一刀切。每一类的判断都要落到具体条件和处理动作上，才能在迁移方案里执行。
为什么附件保留范围值得单独判断
附件保留范围单独判断，要解决的是迁移工期、存储成本和后续可用性之间的平衡问题。研发附件往往数量大、版本多、权限关系复杂，如果不在迁移前把范围定清楚，执行阶段容易出现两种偏差。
一种是全量照搬。所有历史版本、所有派生数据、所有权限对象一并迁移，短期看省去了判断工作，实际会带来三个问题：迁移窗口被拉长，存储成本上升；目标系统里堆积大量过期版本和无效权限，检索时噪声增加；权限对象照搬后与目标系统模型冲突，反而需要二次清理。
另一种是过度精简。只迁最新文件、丢掉版本链和权限意图，迁移看起来快了，但评审时找不到当时的附件版本，变更依据断裂；权限重建缺少依据，出现该看的人看不到、不该看的人能看到的情况；审计时无法还原附件与工作项的关联，追溯成本转移到日常运营中。
保留范围决策的价值在于：把判断工作前置到迁移方案阶段，用一张分级表明确每类对象的处理方式，让迁移工期、存储规划和迁移后的检索体验都可预期。判断做得细，执行阶段的返工和争议就少。
哪些附件内容必须随迁移保留
必须保留项的判断前提是：该附件内容在迁移后仍需支撑追溯、审计或协作交接。满足这个前提时，以下内容应列入必须保留清单。
- 原文件本体。所有纳入迁移范围的附件，文件本体必须完整迁移，迁移后逐个校验可打开、可下载。任何分级都不应以牺牲文件可用性为代价。
- 版本历史。触发条件有三类：附件参与过评审且评审意见引用了特定版本；附件是变更依据，需要还原“当时提交的是哪一版”；合规或审计要求保留完整修改轨迹。满足任一条件，该附件的版本链应完整保留；三类条件都不满足的附件，可只保留最新有效版本。
- 元数据中的关键字段。与检索相关的字段（文件名、类型、所属项目或工作项、上传人、上传时间）、与审计相关的字段（修改记录、操作人）、与工作项关联的字段（附件挂在哪个需求、任务或缺陷上）必须保留并完成字段映射。这些字段丢失后，附件在目标系统中会变成孤立文件，难以定位。
- 权限意图记录。迁移前导出每个附件的可见范围与编辑范围，形成“谁应可见、谁应可编辑”的清单。权限对象本身按目标系统模型重建，但这份意图清单是重建的依据，必须随迁移方案保留。
判断某类内容是否属于必须保留，可以用一个问题检验：迁移后如果业务方要回溯这个附件的使用过程，缺少这项内容是否会导致追溯中断？会中断的，列入必须保留；不会的，进入可重建清单。
哪些可以重建或只保留引用
可重建项的共同特征是：内容可以由原文件或目标系统重新生成，且重建结果与迁移前等价或满足使用要求。以下对象可以重建或只保留引用，但各有前提。
- 预览信息、缩略图。前提是目标系统具备从原文件生成预览的能力。迁移时只迁原文件，预览在目标系统中重新生成。需要确认的是：特殊格式文件（如大型图纸、专有格式文档）在目标系统中能否正常生成预览，不能生成的应提前告知业务方。
- 权限继承关系。做法是：不迁移原权限对象，按目标系统权限模型重建继承关系。前提是迁移前完成权限模型差异评估，明确原系统中“继承自上级目录或空间”的权限，在目标系统中对应哪一层级。风险在于：两边模型差异过大时，重建结果可能与原意图有偏差，需要通过抽样核对确认。
- 外部共享链接。处理方式是只保留引用记录——记录链接指向哪个附件、共享给谁、有效期到何时，迁移后由附件所有者重新签发。前提是迁移前尽可能枚举存量链接；无法枚举的部分，在迁移公告中明确旧链接失效，并给出重新获取的路径。
- 纯展示性元数据。如封面图、排序号、展示样式等字段，可在目标系统中重建或重新设置。边界是：这些字段不参与检索、审计和工作项关联；一旦某个“展示性”字段实际被用于筛选或统计，就应转入必须保留清单。
可重建不等于可以忽略。每一项重建都要在迁移方案中写明由谁重建、何时完成、如何核对，避免迁移结束后出现预览缺失、权限错位、链接失效却无人处理的情况。
投入与前提：判断保留范围需要准备什么
保留范围判断不宜在信息不全时拍板。做出可执行的判断，需要准备以下输入，并明确角色分工。
- 附件清单盘点。按所属业务对象（需求、任务、缺陷、文档空间等）统计附件数量、总容量、版本数量分布、外部链接数量。这份清单是分级判断的数据基础，也是估算迁移工期的依据。
- 版本历史与权限数据的可导出性核查。确认原系统能否导出附件版本链、权限设置和共享链接记录。导出能力不足时，需要提前设计替代方案，例如按目录抽样人工记录。
- 角色分工。业务方负责确认哪些附件支撑评审和变更追溯，给出版本保留的业务判断；法务合规方确认审计留痕要求，明确哪些附件必须保留完整轨迹；IT 迁移执行方负责导出能力核查、字段映射和重建方案。三方结论汇合后形成保留范围决策。
- 抽样核验投入。在正式迁移前，抽取一定比例的附件核对版本链完整性、权限意图清单与实际设置是否一致。抽样比例和样本量根据附件总量和风险等级确定，高风险业务对象的附件应提高抽样比例。
在附件与工作项关联紧密的研发场景中，迁移后附件需要继续挂在对应的工作项上，权限也需要随项目成员关系延续。ONES 的迁移方案覆盖项目、工作项、附件和历史记录的迁移，并提供权限配置与权限结构的迁移支持；具体到附件多版本的保留粒度、外部共享链接的处理方式，需要在迁移前与实施方逐项确认，再写入保留范围方案。
什么情况下应暂缓或缩小保留范围
以下情形出现时，不宜按原计划一次性全量保留，应先缩小范围或分批处理。
- 历史附件量过大、版本链不完整。当附件总量超出迁移窗口承载能力，或大量附件的版本记录本身缺失、断链时，全量保留既无法保证质量，也会拖长工期。处理方式是：按业务对象分批迁移，优先迁移活跃项目和近期附件；版本链不完整的附件标记为“仅保留现有版本”，并在迁移记录中注明。
- 权限模型差异过大、无法映射。原系统与目标系统的权限层级、继承规则差异明显，逐条映射成本过高时，可降级为“按项目成员关系重建基础权限”，再对敏感附件单独核对。降级方案需要业务方确认可接受，并记录例外清单。
- 外部共享链接无法枚举。存量链接分散、缺少集中记录时，无法保证逐一重新签发。处理边界是：迁移公告明确旧链接失效时间，提供重新获取附件的入口，对仍在有效期内的对外共享，由附件所有者逐一确认后重新签发。
- 合规要求未明确。审计留痕范围、保留年限等要求尚未确认前，涉及合规判断的附件版本应暂缓定级，先迁移文件本体和基础元数据，待合规口径明确后再补充版本和轨迹处理。
暂缓或缩小范围的决定应形成书面记录，写明暂缓对象、原因、后续处理计划和责任人，避免迁移结束后遗留问题无人跟进。
用试点验证保留范围是否合适
保留范围判断是否合适，用小范围试点验证比直接全量执行更稳妥。试点样本应覆盖三类典型场景：含多版本历史的附件、存在权限继承的附件、带外部共享链接的附件。每类选取若干业务对象，数量以能在较短时间内完成核验为准。
试点验证的观察点包括：
- 文件可打开：抽样附件在目标系统中能正常打开、下载，特殊格式文件无损坏。
- 版本可回溯：按保留规则应保留版本链的附件，能按时间顺序查看历史版本，评审引用的版本可定位。
- 权限符合预期：按权限意图清单核对，该可见的人能看到，该可编辑的人能编辑，继承关系与预期一致。
- 引用可定位：附件与工作项的关联关系保留，通过工作项能查到附件；外部共享链接的引用记录完整，重新签发流程可走通。
试点结论用于调整保留范围：如果某类附件的版本回溯失败率高，应扩大该类附件的版本保留范围或调整迁移方式；如果权限核对偏差集中在某一层级，应修正权限映射规则后再推广。试点通过的标准是：三类场景的观察点均达到预期，例外项有明确处理方案，业务方和合规方确认结论。满足这些条件后，再按同一规则执行全量迁移。
常见问题
附件版本历史很多，全部保留会拖长迁移工期，怎么取舍？
按附件所属业务对象分级，而不是按文件逐个决定。先确认哪些附件参与过评审且评审意见引用了特定版本、哪些是变更依据、哪些受合规审计约束，这三类保留完整版本链；其余附件只保留最新有效版本。对于版本链本身缺失、断链的附件，标记为“仅保留现有版本”并在迁移记录中注明，避免为补齐历史版本投入不成比例的工时。
原系统的权限继承关系在目标系统中对不上，能否直接放弃重建？
不建议放弃。权限对象可以重建，但权限意图必须延续，否则会出现该看的人看不到、不该看的人能看到。可行做法是先导出每个附件的可见与编辑范围清单，再按目标系统权限模型重建；两边模型差异过大、逐条映射成本过高时，降级为按项目成员关系重建基础权限，对敏感附件单独核对，并把例外清单交业务方确认。降级方案要写入迁移记录，便于后续复查。
外部共享链接迁移后还能继续用吗？
旧链接指向原系统地址，跨系统通常无法延续，处理方式是保留引用记录并在迁移后重新签发。迁移前尽可能枚举存量链接，记录链接指向的附件、共享对象和有效期；无法枚举的部分，在迁移公告中明确旧链接失效时间，并提供重新获取附件的入口。仍在有效期内的对外共享，由附件所有者逐一确认后重新签发，避免外部协作方在不知情的情况下失去访问。
合规留痕要求还没定下来，附件迁移要不要等？
不必整体等待，可以分两步走。先迁移文件本体和基础元数据，保证附件在目标系统中可打开、可定位、与工作项关联不断；涉及合规判断的版本轨迹和审计字段暂缓定级，待法务合规方明确留痕范围和保留年限后，再补充处理。暂缓对象、原因、后续计划和责任人应形成书面记录，防止迁移结束后遗留问题无人跟进。
试点验证要选多少附件、看哪些指标才算通过？
样本量以能在较短时间内完成核验为准，关键是覆盖三类场景：含多版本历史的附件、存在权限继承的附件、带外部共享链接的附件，每类选取若干业务对象。观察四项：文件能正常打开下载，特殊格式无损坏；应保留版本链的附件能按时间顺序回溯；权限核对与意图清单一致；附件与工作项的关联可查、共享链接引用记录完整且重新签发流程可走通。三类场景均达到预期、例外项有明确处理方案、业务方与合规方确认结论，即可按同一规则推广全量迁移。
