Jackett项目自定义索引器分类映射问题解析与解决方案

问题背景

在使用Jackett最新版Docker镜像时，用户遇到了自定义索引器无法正常工作的问题。具体表现为Radarr和Sonarr无法通过自定义索引器获取内容，日志中显示错误信息："Invalid Release: 'https://bludv.xyz/familia-e-tudo-1a-temporada-2024-06-03-2024/'. No categories provided."（无效发布：未提供分类）。

问题分析

这个问题源于Jackett对索引器返回结果的分类(category)处理机制发生了变化。在最新版本中，Jackett严格要求每个索引结果必须包含有效的分类信息，而用户的自定义索引器配置存在以下问题：

1. 虽然定义了详细的分类映射(categorymappings)，但索引器返回的JSON数据中并未包含分类字段
2. 分类映射配置直接复制自thepiratebay.yml模板，但实际数据结构不匹配
3. 缺少对分类字段的默认值处理

解决方案

针对这个问题，Jackett开发者提供了两种解决方案：

方案一：简单分类处理

如果索引器确实无法提供分类信息，可以采用最简单的分类处理方式：

caps:
  categories:
    Other: Other

并在fields字段中添加：

fields:
  category:
    text: Other

这种方法将所有结果归为"Other"类别，虽然简单但缺乏分类精度。

方案二：智能分类推断

更优的方案是根据标题内容自动推断分类：

caps:
  categorymappings:
    - { id: Movie, cat: Movies, desc: "Movies" }
    - { id: TV, cat: TV, desc: "TV" }

fields:
  category_is_tv_show:
    selector: title
    filters:
      - name: regexp
        args: "\\b(S\\d+(?:E\\d+)?)\\b"
  category:
    text: "{{ if .Result.category_is_tv_show }}TV{{ else }}Movie{{ end }}"

这个方案通过正则表达式分析标题：

1. 如果标题中包含"S01E01"这样的剧集标识，则分类为TV
2. 否则分类为Movie

对于葡萄牙语内容，还可以增加对"Temporada"(季节)关键词的识别，但实际测试发现大多数情况下正则表达式已经足够。

技术要点

1. 分类映射机制：Jackett使用分类映射将索引器的原始分类转换为标准分类，供Radarr/Sonarr等应用使用。

2. 字段处理：通过selector和filters可以灵活处理原始数据，包括使用正则表达式进行模式匹配。

3. 模板语法：Jackett支持简单的模板语法，可以根据条件动态生成字段值。

最佳实践建议

1. 在设计自定义索引器时，应确保返回的JSON数据包含分类信息
2. 如果无法修改后端数据，应在前端配置中做好分类推断
3. 对于多语言内容，应考虑不同语言的常见剧集标识模式
4. 定期检查Jackett更新日志，了解分类处理机制的变化

总结

Jackett作为索引聚合工具，对分类信息的处理越来越规范。开发者需要根据实际情况选择合适的分类处理方案，确保索引器能够稳定工作。通过合理的配置，即使后端数据不完善，也能在前端实现良好的分类效果。