Jackett项目关于CapybaraBR索引器标题显示问题的技术解析

背景介绍

在Jackett项目中，CapybaraBR（简称CBR）是一个巴西PT-BR语言的私有种子索引器。近期，该索引器的开发团队提出了一个关于搜索结果标题显示方式的改进需求。原本的设计允许用户选择使用文件名或上传标题作为搜索结果展示，但CBR团队希望统一使用上传标题作为默认显示方式。

问题分析

在Jackett的默认配置中，CapybaraBR索引器启用了"single_file_release_use_filename"选项（设置为true），这会导致搜索结果优先显示文件名而非上传标题。例如：

• 当前显示：Donnie.Brasco.1997.1080p.HMAX.WEB-DL.DD2.0.x264.pt-BR.ENG-LCD.mkv
• 期望显示：Donnie Brasco 1997 1080p HMAX WEB-DL DD2.0 x264 DUAL-LCD

这种差异源于巴西不同PT-BR语言种子站点的命名习惯差异。虽然某些站点使用".pt-BR.ENG"这样的文件名格式，但大多数巴西PT站点更倾向于在标题中使用"DUAL"来表示多语言版本。CBR团队希望通过统一使用上传标题来保持站点内部的一致性。

技术解决方案

Jackett开发团队经过讨论后，决定采取以下技术方案：

1. 保留配置选项：不直接移除"使用文件名作为标题"的功能，而是将其默认值改为false
2. 用户自定义：仍然允许有特殊需求的用户通过Jackett仪表板手动启用该选项
3. 版本更新：该变更将在Jackett v0.21.2485版本中发布

这种方案既满足了CBR团队对统一显示格式的需求，又保留了必要的灵活性，防止可能出现的下载循环问题（某些自动化工具可能依赖特定文件名格式）。

实现细节

在技术实现层面，开发团队修改了位于Jackett.Common/Definitions/capybarabr.yml的配置文件，将single_file_release_use_filename的默认值从true改为false。这种修改方式：

1. 不影响现有配置文件的向后兼容性
2. 新安装用户将自动获得符合CBR团队期望的默认配置
3. 现有用户可以通过界面轻松调整设置

总结

这次变更展示了Jackett项目如何平衡不同PT站点的特殊需求和通用功能的灵活性。通过这种配置调整，CBR用户将获得更符合当地使用习惯的搜索体验，同时项目也保持了应对各种特殊情况的扩展能力。这种技术决策体现了开源项目在满足特定需求与保持通用性之间的权衡艺术。