Jackett项目：Knaben索引器从YML迁移到C的技术方案

背景介绍

Jackett是一个开源的Torrent索引器代理，它能够将多个Torrent网站的搜索结果聚合到一个统一的界面中。Knaben作为其中一个重要的Torrent聚合源，能够从TPB、YTS、nyaa等多个知名Torrent站点收集数据。

当前问题分析

目前Jackett通过YML格式的HTML爬虫来获取Knaben的数据，这种方式存在几个明显缺陷：

1. 数据时效性问题：当源站点删除某些包含恶意软件的标题后，YML爬虫获取的数据无法及时同步这些变更
2. 维护成本高：HTML结构变化时需要频繁更新爬虫逻辑
3. 数据完整性不足：无法准确反映种子的实时状态（如做种数、下载数）

技术解决方案

方案一：迁移到C#索引器

核心优势：

• 直接调用Knaben提供的API接口，获取更准确的数据
• 能够检测到种子数/下载数为0的情况，自动过滤无效结果
• 减少对HTML结构的依赖，提高稳定性

实现要点：

1. 需要开发新的C#索引器类，继承Jackett的基础索引器类
2. 实现API请求逻辑，处理JSON格式的响应数据
3. 添加结果过滤机制，自动排除无效种子

方案二：改进Cardigann支持JSON请求

潜在优势：

• 保持现有YML配置方式，减少改动量
• 统一处理多种索引器类型

技术挑战：

• 需要修改Cardigann核心以支持JSON请求体
• 可能涉及更复杂的配置逻辑

技术实现建议

对于C#索引器实现，建议采用以下架构：

1. 请求构建层：封装API请求参数，处理认证等基础功能
2. 响应处理层：解析JSON响应，转换为Jackett内部数据结构
3. 结果过滤层：基于种子数、下载数等指标进行智能过滤
4. 缓存机制：合理设置缓存时间，平衡实时性和性能

预期效果

迁移到C#索引器后，预期将带来以下改进：

1. 数据准确性提升：能够及时反映源站点的删除操作
2. 系统稳定性增强：减少因HTML结构变化导致的解析失败
3. 维护效率提高：API接口通常比HTML爬虫更稳定，减少维护频率
4. 用户体验改善：提供更干净、可靠的搜索结果

总结

将Knaben索引器从YML迁移到C#实现是一个值得投入的技术改进方向。它不仅能够解决当前面临的数据同步问题，还能为未来的功能扩展奠定更好的基础。对于Jackett项目维护团队而言，这种架构演进也符合长期的技术路线规划。