Prowlarr项目SceneHD索引器XXX分类搜索问题解析

问题背景

Prowlarr是一款优秀的索引器管理工具，近期用户反馈在使用SceneHD索引器时，针对XXX分类（类别ID为6000）的搜索功能出现异常。具体表现为无法通过Prowlarr获取XXX分类的搜索结果，而其他分类如电影等则能正常返回结果。

问题分析

经过深入排查，发现问题的根源在于SceneHD索引器的分类搜索参数格式发生了变化。原实现中使用的是categories[10]=1这种数组形式的参数传递方式，但SceneHD服务端已不再支持这种格式。

技术验证过程

开发团队与用户进行了多轮测试，尝试了多种参数组合：

1. 传统数组格式cat[10]=1 - 完全无效
2. 简化格式c10=1 - 返回所有结果，无分类过滤效果
3. 分号分隔格式cat=1;4;5 - 服务端无法识别
4. 逗号分隔格式cat=2,10 - 成功返回指定分类结果

测试结果表明，SceneHD目前仅支持使用逗号分隔的简单参数格式来指定多个分类。

解决方案

基于以上发现，解决方案是修改Prowlarr中SceneHD索引器的实现，将分类参数从原来的数组格式调整为逗号分隔的字符串格式。具体修改包括：

1. 重构分类参数构建逻辑
2. 确保多分类搜索时使用逗号分隔ID
3. 保持向后兼容性

技术实现要点

在实现过程中需要注意：

1. 分类ID映射需要准确，特别是对于特殊分类如XXX内容
2. 参数编码要符合HTTP标准
3. 错误处理要完善，应对服务端可能的响应变化
4. 性能考虑，避免不必要的参数重复

用户影响

此修复将使得：

1. XXX分类内容可以正常搜索和获取
2. 多分类组合搜索功能恢复正常
3. 搜索结果的准确性和完整性得到提升

总结

这次问题排查展示了开源协作的优势，通过开发者与用户的紧密配合，快速定位并解决了参数格式兼容性问题。这也提醒我们在实现索引器集成时，需要定期验证API的兼容性，特别是对于分类搜索这类核心功能。

对于Prowlarr用户来说，更新后将可以无缝使用SceneHD索引器的所有分类搜索功能，包括之前异常的XXX分类内容。