MoviePilot项目中的季集偏移订阅功能需求分析

背景与现状

在影视资源管理工具MoviePilot的实际使用中，用户经常遇到因TMDB元数据变更导致的订阅失效问题。典型场景如动画剧集《一念永恒》第三季第38集后，TMDB将所有季整合为单季结构（S03E38变为S01E144），这种元数据重组行为使得原有基于固定季集号的订阅机制无法正常工作。

当前MoviePilot（v2.3.3-1版本）的订阅功能存在两个主要局限：

1. 无法识别TMDB的剧集组（Episode Group）数据结构
2. 缺乏应对元数据突变的容错机制

技术需求分析

核心问题

元数据源（TMDB）与资源命名规范的差异导致订阅匹配失败。虽然TMDB通过剧集组功能维护原始季集结构，但：

• 资源发布者可能采用原始季集编号（如S03E38）
• 订阅系统仅能识别TMDB主数据库中的最新结构（S01E144）

解决方案设计

建议实现动态季集偏移机制，包含以下技术要点：

1. 偏移量配置

   • 允许用户设置相对偏移参数（如+2季-106集）
   • 支持正负整数偏移，覆盖前移/后移场景

2. 双重匹配逻辑

   def match_episode(target_season, target_episode, offset):
       # 原始匹配
       if exists_in_metadata(target_season, target_episode):
           return True
       
       # 偏移匹配
       adjusted_season = target_season + offset.season
       adjusted_episode = target_episode + offset.episode
       return exists_in_metadata(adjusted_season, adjusted_episode)
   

3. 与刮削系统的协同

   • 偏移机制仅用于资源匹配阶段
   • 最终入库仍采用TMDB标准元数据
   • 通过剧集组插件保持原始季集结构展示

实现建议

1. 前端交互

   • 在订阅配置页面增加"高级设置"区域
   • 提供季/集偏移量的数字输入框（默认0）

2. 数据持久化

   {
       "subscription": {
           "season_offset": 2,
           "episode_offset": -106
       }
   }
   

3. 异常处理

   • 设置偏移量有效范围（如±10季）
   • 冲突检测：当多个偏移规则可能匹配同一资源时告警

技术价值

该功能的实现将显著提升系统在以下场景的适应性：

• TMDB季集重组（合并/拆分季）
• 特殊剧集的非标准编号（如OVA、特别篇）
• 不同元数据源之间的编号差异

延伸思考

未来可考虑扩展为智能偏移系统：

1. 自动学习资源命名模式
2. 建立季集映射关系数据库
3. 提供偏移建议算法