PlexTraktSync 0.30.0版本中Trakt收藏集同步异常问题分析

问题现象

近期PlexTraktSync项目升级到0.30.0版本后，部分用户报告了一个严重的同步异常问题。当工具运行时，会先将所有电视剧集添加到Trakt收藏集，随后在下一个同步步骤中又立即移除所有这些内容。这种异常行为导致用户的Trakt收藏集不断被清空和重新填充。

问题根源

经过技术分析，该问题源于0.30.0版本中引入的一个配置项处理逻辑变更。具体来说，当配置文件中设置了clear_collected: true选项时，新版本会错误地执行以下操作序列：

1. 首先将所有Plex中的剧集同步到Trakt收藏集
2. 然后由于配置了清除不在Plex中的收藏项，工具会错误地将所有刚刚添加的剧集标记为"不在Plex中"
3. 最终导致所有剧集被从Trakt收藏集中移除

影响范围

该问题主要影响满足以下条件的用户：

• 使用PlexTraktSync 0.30.0版本
• 配置文件中启用了clear_collected: true选项
• 主要同步电视剧集内容

临时解决方案

对于遇到此问题的用户，目前有以下几种可行的解决方案：

1. 降级到0.29.14版本：这是最直接的解决方法，可以立即恢复正常同步功能
2. 修改配置文件：暂时禁用clear_collected选项，等待后续修复版本发布
3. 手动同步：在修复版本发布前，可以暂时停止自动同步，改为手动控制同步过程

技术背景

PlexTraktSync作为一个在两个平台间同步观看状态的工具，其核心功能依赖于对两个API的精确调用和状态比对。clear_collected选项原本设计用于清理那些已从Plex移除但仍存在于Trakt收藏集中的项目，但在0.30.0版本中，该功能的实现逻辑出现了偏差，导致比对算法错误地将所有项目都判定为"需要移除"。

预防措施

为避免类似问题再次发生，建议用户：

1. 在升级前备份当前配置文件
2. 先在小范围测试新版本功能
3. 关注项目的更新日志，了解重大变更内容
4. 考虑使用Docker等容器技术，便于快速回滚到稳定版本

后续进展

项目维护团队已经确认该问题，并在后续版本中进行了修复。用户可以通过升级到最新版本来解决此同步异常问题。同时，这也提醒我们在处理跨平台状态同步时需要特别注意边界条件和状态一致性检查。