Bitmagnet项目中的Torznab API排序问题分析与解决方案

背景介绍

Bitmagnet作为一个开源的索引器，提供了Torznab API接口供自动化工具如Sonarr等调用。近期社区发现其Torznab API在返回结果时的排序机制存在问题，影响了自动化工具的正常工作流程。

问题本质

核心问题在于Bitmagnet的Torznab API端点返回结果时未按照发布时间降序排列。当Sonarr等自动化工具执行RSS同步时，会基于以下逻辑工作：

1. 工具从索引器请求最新内容
2. 按发布时间降序处理结果
3. 当遇到早于上次同步时间的记录时停止处理

由于Bitmagnet返回的结果顺序混乱（包含2019-2024年间不同日期的混合记录），导致Sonarr无法正确识别最新内容，仅处理第一页结果后就终止同步。

技术细节分析

Torznab规范现状

Torznab规范本身并未明确规定默认排序顺序，这给实现带来了挑战。但从实际应用场景考虑，大多数自动化工具都期望：

• 最新发布的内容排在前面
• 结果按发布时间降序排列
• 第一项应为系统中最新的种子

RSS相关字段问题

除了排序问题外，还发现Bitmagnet在返回RSS格式数据时存在两个字段问题：

1. channel/pubDate：表示频道内容的发布日期
2. channel/lastBuildDate：表示频道最后更新的时间

这两个字段当前都被设置为默认值"0001-01-01"，不符合RSS规范要求。

解决方案

经过社区讨论，确定以下改进方向：

1. 修改Torznab API默认排序为按发布时间降序

   • 确保最新内容优先返回
   • 与自动化工具预期行为一致
   • 提高RSS同步的准确性

2. 修复RSS相关字段

   • 正确设置pubDate为实际发布日期
   • 更新lastBuildDate为最后构建时间

实现考量

在实现过程中需要考虑以下技术权衡：

• 相关性排序与时间排序的平衡
• 主API与Torznab API行为的一致性
• 对现有用户工作流的影响

虽然按时间排序可能降低某些场景下的相关性，但考虑到Torznab主要用于自动化工具获取最新内容，这种改变是合理的。

结论

Bitmagnet项目通过调整Torznab API的默认排序行为，解决了与自动化工具的兼容性问题。这一改进使得Sonarr等工具能够正确识别最新内容，提高了整个系统的可用性和可靠性。同时修复的RSS字段也使输出更加符合规范标准。