Plex-Meta-Manager中多版本电影元数据备份问题解析

在Plex媒体服务器管理工具Plex-Meta-Manager的1.20.0版本中，用户发现了一个关于电影多版本元数据备份的功能缺陷。该问题主要影响包含多个版本（Edition）的电影在元数据备份时的完整性表现。

问题现象

当使用metadata_backup操作进行电影库备份时，配置示例如下：

operations:
  metadata_backup:
    path: config/Movie_Backup.yml
    sync_tags: true

对于拥有多个版本（如剧场版和加长版）的电影，系统仅会备份其中一个版本的元数据信息。以电影"That Thing You Do!"为例，该片存在"剧场版"和"加长版"两个版本，但备份文件Movie_Backup.yml中仅记录了加长版的元数据，包括影片摘要和年龄分级标签等信息。

技术背景

在Plex的媒体管理体系中，Edition（版本）是一个重要的元数据属性，允许同一部电影的不同剪辑版本共存于资料库中。Plex-Meta-Manager的元数据备份功能本应完整保留这些版本差异信息，以支持后续的恢复或同步操作。

问题根源

经过分析，该问题源于备份逻辑中的版本处理机制存在缺陷：

1. 备份过程中未正确遍历电影的所有版本节点
2. 版本标识符（Edition标签）未被纳入备份数据的键名体系
3. 多版本数据在内存结构中可能被后处理的版本覆盖

解决方案

开发团队已通过提交32f48aa修复了该问题，主要改进包括：

1. 增强版本感知的备份数据收集逻辑
2. 为每个版本建立独立的备份条目
3. 在YAML输出结构中明确包含Edition标识

用户建议

对于需要使用多版本电影管理的用户：

1. 建议升级到包含该修复的版本
2. 重新运行完整备份以确保所有版本数据被正确保存
3. 检查备份文件是否包含类似结构：

That Thing You Do! (1996) [Theatrical Cut]:
  title: That Thing You Do!
  edition: Theatrical Cut
  # 其他元数据...

That Thing You Do! (1996) [Extended Cut]:
  title: That Thing You Do!
  edition: Extended Cut
  # 其他元数据...

该修复确保了Plex-Meta-Manager能够完整保留媒体库中的版本多样性，为专业影视收藏者提供了更可靠的数据保障。