TMDB 分类系统更新说明

🆕 新增功能

1. 负号排除匹配

支持在分类规则中使用负号（-）来排除特定的类型 ID。

语法格式：

纪录片:
  genre_ids: "99,-10402"

匹配逻辑：

• 99：必须包含该类型 ID
• -10402：不能包含该类型 ID
• 结果：只有包含 99 且不包含 10402 的影片才会被识别为纪录片

---

2. 关键词匹配 (keywords)

根据影片标题中的关键词进行精确分类。

配置示例：

哆啦A梦系列:
  genre_ids: "16" # 限定动画类型
  keywords: "哆啦A梦,机器猫,Doraemon"

匹配规则：

• 影片标题必须包含配置中的任意一个关键词
• 如果所有关键词都不匹配，则跳过该分类规则
• 关键词匹配不区分大小写

---

3. 系列化分类 (Series)

匹配成功后会在分类目录下创建子系列目录，格式为：分类名称/系列名称系列

3.1 系列关键词 (series_keywords)

基于影片标题关键词创建系列子目录。

配置示例：

动画电影:
  genre_ids: "16"
  series_keywords: "哆啦A梦,海贼王,火影忍者"

匹配结果：

• 匹配到"哆啦 A 梦" → 动画电影/哆啦A梦系列
• 匹配到"海贼王" → 动画电影/海贼王系列
• 仅匹配类型不匹配关键词 → 动画电影

3.2 演员/导演系列 (series_actors / series_directors)

基于影片的主要演员或导演创建系列子目录。

配置示例：

华语电影:
  original_language: "zh,cn,bo,za"
  series_actors: "周杰伦,周星驰,成龙"

国际大片:
  series_directors: "克里斯托弗·诺兰,昆汀·塔伦蒂诺"

匹配规则：

• 检查影片的前 6 位演员/导演信息
• 匹配演员/导演的姓名字段（name）
• 支持中英文姓名，不区分大小写

匹配结果：

• 《大灌篮》包含周杰伦 → 华语电影/周杰伦系列
• 《功夫》包含周星驰 → 华语电影/周星驰系列
• 《盗梦空间》导演是诺兰 → 国际大片/克里斯托弗·诺兰系列

---

⚡ 重要特性

配置优先级

• 更具体的规则应放在配置前面，避免被通用规则提前匹配
• 系统按配置顺序依次匹配，首次匹配成功即停止

匹配逻辑

• 普通字段：必须完全匹配，失败则整个规则失败
• series 字段：
  • 纯 series 配置：必须匹配成功，否则整个规则失败
  • 混合配置：series 匹配失败不影响整体，只是没有系列后缀

数据来源

• 所有匹配基于 TMDB API 返回的标准字段
• 支持的字段包括：genre_ids、original_language、production_countries、origin_country、title、actors、directors 等

---

📝 配置建议

1. 合理排序：将更具体的分类规则放在前面
2. 测试验证：新增规则后建议测试匹配效果
3. 姓名格式：演员/导演建议配置多种姓名形式（中英文）
4. 关键词选择：选择具有代表性且不易冲突的关键词

---

🎯 实际应用示例

# 完整配置示例
categories:
  # 具体系列（优先级最高）
  哆啦A梦系列:
    genre_ids: "16"
    origin_country: "JP"
    series_actors: "水田山葵,大原惠美"

  # 导演作品集
  宫崎骏动画:
    genre_ids: "16"
    origin_country: "JP"
    series_directors: "宫崎骏"

  # 排除特定类型
  纪录片:
    genre_ids: "99,-10402" # 纪录片但非音乐纪录片

  # 演员系列
  成龙电影:
    series_actors: "成龙,Jackie Chan"

  # 通用分类（优先级较低）
  日本动画:
    genre_ids: "16"
    origin_country: "JP"