Bazarr项目中听力障碍字幕文件命名问题的分析与修复

在开源字幕管理工具Bazarr的最新版本1.4.5中，开发团队发现并修复了一个关于听力障碍(hearing impaired)字幕文件命名的功能性问题。这个问题影响了用户手动上传字幕文件时的命名规范。

问题背景

Bazarr作为一款专业的字幕管理工具，允许用户为影视内容自动或手动获取字幕。对于听力障碍用户，系统支持特殊标记的字幕文件，这些文件通常需要在文件名中包含特定标识(如sdh、hi或cc)以区分普通字幕。

问题表现

当用户通过Bazarr界面手动上传标记为"听力障碍"的字幕文件时，系统未能按照预设的命名规则为文件添加相应的听力障碍标识后缀。具体表现为：

• 上传时用户明确选择了"听力障碍"选项
• 文件保存时缺少配置中定义的特殊后缀
• 普通字幕命名正常，仅听力障碍字幕受影响

技术分析

这个问题属于文件命名逻辑中的条件判断缺陷。系统在处理手动上传流程时：

1. 正确接收了用户设置的"听力障碍"标记
2. 但在最终生成文件名时，未将该标记转化为配置中定义的后缀格式
3. 文件存储环节直接使用了基础命名规则

修复方案

开发团队在后续版本中修正了这一行为，确保：

• 文件命名模块会检查字幕的听力障碍属性
• 根据系统配置添加相应的后缀标识
• 保持与自动下载字幕相同的命名一致性

用户影响

该修复保证了：

1. 手动上传和自动下载的字幕命名规则统一
2. 听力障碍用户能清晰识别特殊字幕文件
3. 与其他媒体管理工具(如Radarr/Sonarr)的兼容性

最佳实践建议

对于使用Bazarr管理字幕的用户，特别是需要听力障碍字幕的：

1. 确保使用最新版本以获得完整功能
2. 在系统设置中预先配置好喜欢的后缀格式
3. 上传后检查文件名是否符合预期

这个问题展示了开源项目中典型的"边界情况"处理，也体现了Bazarr团队对辅助功能支持的重视。通过持续的用户反馈和快速响应，项目不断完善其专业字幕管理能力。