Kometa项目中的评分覆盖配置详解

Kometa是一个强大的媒体库管理工具，它允许用户通过YAML配置文件来自定义各种覆盖效果。在最新版本的文档中，我们发现了一个关于评分覆盖配置的重要修正点。

评分覆盖配置的正确用法

在Kometa的配置中，评分覆盖(ratings overlay)是一个非常有用的功能，它允许用户在媒体库项目上显示来自不同来源的评分信息。然而，之前的文档示例中有一个关键错误：

错误示例中使用了：

- default: network

而实际上正确的配置应该是：

- default: ratings

为什么这个修正很重要

1. 功能准确性：使用"ratings"作为默认值才能确保评分覆盖功能正常工作
2. 配置清晰性：正确的配置项能让用户更清楚地理解这是评分相关的覆盖
3. 避免混淆："network"是用于网络标志的覆盖类型，与评分功能无关

完整的正确配置示例

以下是修正后的完整配置示例：

libraries:
  Movies:
    overlay_files:
      - default: ratings
        template_variables:
          rating1: critic
          rating2: audience
          rating3: user
          rating1_image: imdb
          rating2_image: rt_popcorn
          rating3_image: tmdb
    operations:
      mass_critic_rating_update: imdb
      mass_audience_rating_update: mdb_tomatoesaudience
      mass_user_rating_update: tmdb

配置项解析

1. rating1/2/3：定义了三个评分槽位的类型
2. ratingX_image：指定每个评分对应的图标
3. mass_X_rating_update：定义批量更新评分时使用的数据源

最佳实践建议

1. 始终使用"ratings"作为评分覆盖的默认类型
2. 可以根据需要混合使用不同评分来源
3. 电视剧集可以单独配置集级别的评分覆盖
4. 保持配置文件的缩进格式正确

这个修正已经包含在Kometa的最新文档中，用户在使用评分覆盖功能时应该参考更新后的配置示例，以确保功能正常工作。