Ani 项目中的番剧观看状态与选集排序问题分析

问题现象

在 Ani 4.1.0-alpha02 版本中，用户报告了一个关于番剧观看状态显示不一致的问题。具体表现为：

1. 在追番列表页面，番剧《银魂》显示为"在看"状态
2. 进入番剧详情页面后，同一番剧却显示为"已看完"状态
3. 选集播放窗口中的剧集排序和观看状态显示异常

技术分析

状态显示不一致问题

经过分析，这个问题涉及两个关键组件：

1. SubjectAiringInfo：负责处理番剧的播出信息
2. SubjectAiringState：负责处理番剧的观看状态

问题可能源于这两个组件在处理状态同步时存在逻辑不一致。当从追番列表进入详情页时，状态信息可能没有正确传递或转换，导致显示差异。

选集排序问题

选集排序异常的问题更为复杂，涉及多个层面的实现：

1. 排序字段选择：系统错误地使用了sort.raw而非sort.number进行排序
2. 数据源差异：
   • 收藏(追番)列表：通过Room数据库的EpisodeCollectionEntity实体类中的sortNumber字段排序
   • 搜索结果：直接使用BangumiEpisodeService查询到的原始数据排序

这种多数据源、多排序逻辑的设计，如果没有统一处理，就容易出现排序不一致的情况。

解决方案

状态同步问题

建议采取以下改进措施：

1. 统一状态管理：建立一个中央化的状态管理机制，确保不同页面间的状态一致性
2. 状态转换验证：在SubjectAiringInfo和SubjectAiringState之间添加状态转换验证逻辑
3. 状态缓存：考虑使用持久化缓存来保持状态一致性

选集排序问题

针对排序问题，建议：

1. 统一排序逻辑：无论数据来源如何，都使用相同的排序算法和字段
2. 数据标准化：在数据入库前进行预处理，确保sortNumber字段的一致性
3. 排序策略模式：实现可配置的排序策略，便于不同场景下的灵活调整

总结

这类问题在多媒体应用开发中较为常见，特别是在处理复杂的状态管理和多源数据时。Ani作为一个番剧追踪应用，需要特别注意：

1. 用户观看状态的准确性和一致性
2. 复杂剧集结构的正确展示
3. 多数据源间的数据同步

通过建立更健壮的状态管理机制和统一的数据处理流程，可以有效避免类似问题的发生，提升用户体验。