Bazarr项目中Subdivx字幕提供商的改进与适配

背景介绍

Bazarr作为一款优秀的字幕管理工具，其1.4.1版本在整合多个字幕提供商时遇到了一个典型问题：Subdivx提供商无法正确识别剧集的替代标题(alternative titles)，导致部分字幕资源无法被检索到。这个问题在非英语剧集(如意大利剧《Inspector Montalbano》)上表现得尤为明显。

问题分析

Subdivx作为拉丁美洲地区主要的西班牙语字幕网站，其字幕资源通常使用剧集的原生语言标题而非英语译名。在Bazarr原有实现中，Subdivx提供商仅使用主标题(通常是英语标题)进行搜索，而忽略了Sonarr提供的替代标题集合。

技术层面存在几个关键点：

1. 字幕提供商实现基于Subliminal库，各提供商可自主决定搜索策略
2. Subdivx原有的HTML页面爬取方式较为复杂，需要处理分页和多结果筛选
3. 剧集标题匹配逻辑需要同时考虑主标题和替代标题

解决方案演进

开发者社区针对这一问题进行了多次迭代改进：

1. 初始改进尝试：修改Subdivx提供商以支持替代标题搜索，但在结果筛选逻辑上遇到挑战
2. 网站改版应对：Subdivx突然改版，从HTML表单提交转为JSON API响应，这反而简化了技术实现
3. 最终方案：重构后的实现采用POST请求直接获取JSON格式结果，不再需要复杂的HTML解析

新实现的主要特点包括：

• 使用POST请求替代GET请求
• 直接处理JSON响应而非HTML解析
• 同时搜索主标题和所有替代标题
• 更简洁的剧集匹配逻辑

技术实现要点

改进后的Subdivx提供商实现包含以下关键技术点：

1. 请求构造：精心构建包含搜索关键词的POST请求体
2. 标题处理：同时考虑video.title和video.alternative_titles
3. 结果解析：直接从JSON响应中提取有效字幕信息
4. 匹配验证：确保返回的字幕与请求的季/集号匹配

用户价值

这一改进为用户带来了显著价值：

• 提高了非英语剧集字幕的发现率
• 特别是对使用原生语言标题的字幕资源更敏感
• 响应速度因API直接调用而提升
• 搜索结果更全面准确

总结

Bazarr社区通过持续改进Subdivx字幕提供商，解决了替代标题搜索的关键问题。这一过程不仅展示了开源协作的力量，也体现了对用户需求的快速响应。随着新实现的合并，用户将能更便捷地获取各类剧集的西班牙语字幕资源。