Jackett项目Trellas索引器故障排查与修复全记录

问题背景

Jackett是一款流行的种子索引聚合工具，它能够将多个私有种子网站的搜索结果整合到一个统一的接口中。近期，Jackett项目组收到用户反馈，针对希腊种子站点Trellas（原名Magico）的索引器功能出现异常。主要表现为：

1. 搜索请求无法返回预期结果
2. 部分查询返回错误状态
3. 希腊语内容搜索存在大小写敏感问题

技术分析

初始问题诊断

开发团队首先确认了用户环境信息，包括Jackett版本、运行环境等基础配置。通过分析用户提供的增强日志，发现核心问题在于：

• 搜索请求被Trellas服务器忽略
• 系统返回的是最新20条种子而非匹配结果
• GET/POST请求方式变更导致兼容性问题

第一阶段修复

开发团队实施了以下修复措施：

1. 将索引器名称从Magico更新为Trellas
2. 添加配置排序选项
3. 尝试将搜索方式从GET切换为POST
4. 修正免费种子标记
5. 更新分类系统

然而，POST方式测试失败，系统返回错误响应。这表明Trellas可能对API请求方式有特殊要求。

深入调查

由于开发团队没有Trellas账户，无法直接测试。在获得用户提供的测试账户后，发现关键问题：

1. 关键词过滤器对包含空格的搜索查询处理不当
2. 搜索参数pid值可能需要从32调整为10
3. 希腊语内容搜索存在大小写敏感问题

解决方案

核心修复

开发团队实施了多轮修复：

1. 恢复GET请求方式并添加提交关键词
2. 修正日志清理工具，保留关键参数pid
3. 修复关键词过滤器，正确处理带空格的查询
4. 增加对希腊语内容的大小写不敏感支持

版本发布

修复分多个版本逐步发布：

1. v0.21.1658：基础功能修复
2. v0.21.1664：GET请求恢复
3. v0.21.1672：关键词过滤器修正
4. v0.21.1700：错误处理增强
5. v0.21.1776：希腊语搜索优化

技术要点

搜索机制优化

针对Trellas的特殊要求，开发团队实现了：

1. 动态请求方式切换机制
2. 参数自动调整功能
3. 错误重试和回退策略

国际化支持

特别针对希腊语内容：

1. 实现大小写不敏感搜索
2. 优化字符编码处理
3. 增强本地化结果匹配

经验总结

本次故障排查展示了开源协作的优势：

1. 用户与开发者的紧密配合加速了问题定位
2. 分阶段验证确保了修复质量
3. 日志分析在远程诊断中的关键作用
4. 国际化支持需要考虑语言特殊性

通过系统性的问题分析和渐进式修复，Jackett项目成功解决了Trellas索引器的兼容性问题，同时增强了多语言支持能力，为类似问题的解决提供了参考范例。