Jackett项目：Fuzer索引器TV搜索模式优化解析

在Jackett项目的Fuzer索引器使用过程中，开发团队发现了一个影响TV节目搜索准确性的技术问题。本文将深入分析该问题的成因、技术解决方案以及最终实现方式。

问题背景

当用户通过Sonarr等媒体管理工具进行剧集搜索时，Fuzer索引器会同时使用IMDb ID和季集信息(SxxEyy格式)作为搜索参数。然而在实际测试中发现，该索引器的后端处理逻辑存在特殊行为：当查询中包含IMDb ID时，系统会返回该剧集的所有季集内容，而忽略其他搜索条件(包括分辨率、具体季集号等)。

技术分析

经过开发团队的技术验证，确认Fuzer网站的后端搜索机制存在以下特点：

1. 在TV节目搜索模式下，IMDb ID参数会覆盖其他所有搜索条件
2. 季集号(SxxEyy)、分辨率等附加参数实际上被系统忽略
3. 这种处理方式与大多数索引器的标准行为不符

解决方案

开发团队经过讨论后，决定修改Fuzer索引器的定义文件，从TV搜索模式中移除IMDb ID参数支持。具体修改如下：

modes:
  search: [q]
  tv-search: [q, season, ep]  # 移除了imdbid参数
  movie-search: [q, imdbid]
  music-search: [q]
  book-search: [q]

这一变更确保了：

• TV节目搜索仅使用剧集名称(q)、季号(season)和集号(ep)作为参数
• 电影搜索模式仍保留IMDb ID支持
• 各搜索模式的功能边界更加清晰

实现效果

该修改已在Jackett v0.21.2284版本中发布。更新后，用户通过Sonarr等工具进行剧集搜索时：

• 搜索结果将严格匹配指定的季集信息
• 不再出现返回整部剧集所有季集的情况
• 搜索精准度显著提高

技术启示

这个案例展示了索引器适配层开发中的常见挑战：不同追踪网站的参数处理逻辑可能存在显著差异。开发团队需要通过：

1. 实际测试验证各种参数组合的效果
2. 根据网站实际行为调整接口定义
3. 保持各搜索模式的功能纯粹性

这种精细化的参数控制是保证Jackett与各类追踪网站稳定交互的关键技术手段。