媒体存储迁移

当本地或 NAS 媒体库空间不足、希望将已入库内容迁入另一种存储时，不必删除后重新导入。媒体存储迁移会把选中的媒体批量迁到支持的目标媒体库，同时保留原来的媒体记录。

简单说：换的是媒体实际存放的位置，不是 SakuraMedia 里的那条媒体。

因此，媒体 ID、影片归属、播放进度、缩略图、时刻和片段等已有关联都会继续保留；迁移完成后，列表、详情页和活动中心仍指向同一项媒体。

当前支持范围

迁移能力由源和目标媒体库所属的 Provider 共同决定。界面只会列出能够安全完成迁移的目标库；没有可用目标时会给出提示。

官方当前实现首先覆盖 本地存储媒体库 → 115 网盘媒体库：

• 目标端只使用 115 秒传，不回退为普通上传；115 未命中时会跳过该文件，源文件和原媒体记录保持不变。
• 迁移前会计算并核验文件大小与 SHA-1；115 返回目标后还会再次确认目标的名称、大小、哈希和目录可见性。
• 只有目标确认可用后，系统才会将原媒体记录切换到目标媒体库，并清理本地媒体库中的对应文件链接。

这不是备份、同步或双向镜像功能。它的目标是安全地完成一次“换库”；其他 Provider 将来可在实现相同迁移能力后接入。

如何使用

1. 先创建并确认源、目标媒体库均可正常使用。本地迁往 115 时，需要使用支持迁移能力的 SakuraMedia、Local Provider 和 115 Provider 版本。
2. 进入媒体管理，在同一个源媒体库中勾选需要迁移的媒体。
3. 点击「迁移」，从可用的目标媒体库中选择一项并提交。
4. 到活动中心查看进度和结果。任务会分别显示「已迁移」「已跳过」「迁移失败」「源文件待确认」与「未执行」的数量。

迁移按项串行执行。已成功的项目会保留结果；如果后续某一项遇到文件变化、库忙、网络或清理异常，任务会停止，而不会把尚未处理的项目冒险继续下去。

会保留什么

迁移不会新建一条“目标媒体”，而是更新原媒体的存储归属和存储引用。因此下列信息保持关联：

• 影片或普通视频的归属、媒体 ID 和已保存的元数据；
• 播放进度、缩略图、时刻、片段和片段合集；
• 影片级字幕记录，以及图片搜索和推荐等依赖该媒体记录的数据。

内嵌字幕随视频字节进入目标端；单独管理的外挂字幕记录不会被上传。已有片段文件也不会随这次迁移移动。

安全边界与注意事项

• 迁移期间，源和目标媒体库的配置、扫描及插件管理会与迁移互斥；请不要同时修改这两个媒体库、升级或卸载 Provider。
• 系统只清理媒体库内的那条源文件链接，不会递归删除目录，也不会删除下载器任务或管理做种关系。
• 如果媒体库文件和下载目录是硬链接，删掉媒体库链接未必释放磁盘空间；如果两者本来就是同一文件路径，清理会影响下载器。请在迁移前确认自己的目录和做种策略。
• 任务中断或源文件清理结果无法确认时，系统不会自动重试、反向迁移或猜测文件状态。活动中心会如实标为“源文件待确认”，需要自行检查处理。
• 正在播放的本地视频不保证无缝切换；迁移后如需继续播放，请重新打开该媒体。

TIP

建议先选少量非关键媒体验证存储 Provider、115 账号和目录配置，再迁移整批内容。