Bazarr项目中ASS字幕自动转换为SRT格式的问题分析与修复

在Bazarr字幕管理系统中，用户报告了一个关于嵌入式字幕格式转换的问题：当从MKV容器中提取ASS格式的字幕时，系统会将其转换为SRT格式，即使用户已经选择了"使用原始格式"选项。

问题现象

用户在使用Bazarr 1.4.3版本时发现，当通过嵌入式字幕提供程序下载ASS格式的字幕时，系统不仅会更改文件扩展名，还会实际转换字幕格式。这一行为发生在以下场景：

1. 启用嵌入式字幕提供程序
2. 勾选"使用原始格式"选项
3. 从MKV文件中下载ASS字幕

技术分析

通过分析系统日志，开发团队发现了问题的根源：

1. 格式请求参数问题：日志显示系统始终请求SRT格式(Subtitle formats requested: ('srt',))，即使配置了保留原始格式。

2. REST API处理缺陷：在手动下载场景下，API端点期望接收字面布尔值字符串，但前端发送的是JavaScript布尔值，导致格式保留选项始终被忽略。

3. 自动下载流程差异：修复后手动下载功能正常，但自动下载流程仍存在类似问题，需要额外处理。

解决方案

开发团队通过以下修改解决了问题：

1. 统一布尔值处理：修改API端点，使其能够正确处理不同类型的布尔值输入。

2. 格式传递机制：确保原始格式信息能够正确传递到字幕处理流程的各个环节。

3. 自动下载流程适配：扩展修复方案到自动下载流程，确保一致性。

技术细节

问题的核心在于系统内部对字幕格式请求的处理逻辑。当用户选择"使用原始格式"时，系统应：

1. 检测源字幕的实际格式
2. 保持该格式不变
3. 仅进行必要的编码转换或清理

修复后的系统现在能够正确识别和处理ASS格式的字幕文件，保留其原始格式和样式信息，这对于需要高级字幕特效的用户尤为重要。

用户影响

这一修复对用户的主要好处包括：

1. 保持字幕原始格式，特别是对需要复杂样式的ASS字幕
2. 避免不必要的格式转换导致的信息丢失
3. 提高字幕与视频内容的兼容性

结论

Bazarr团队通过细致的日志分析和代码审查，定位并修复了字幕格式转换的问题。这一改进体现了开源项目对用户反馈的快速响应能力，也展示了系统在处理多媒体元数据方面的持续优化。用户现在可以更可靠地获取原始格式的字幕，满足各种播放场景的需求。