Kometa项目中动态演员集合构建的注意事项

Kometa项目是一个用于管理Plex媒体库元数据的工具，其中动态集合功能允许用户基于特定条件自动创建和管理媒体集合。本文将重点介绍在使用动态演员集合时需要注意的关键技术细节。

动态演员集合的工作原理

Kometa的动态集合功能支持基于演员创建集合，系统会自动分析媒体库中的演员出现频率，然后为符合条件的演员创建专门的集合。这一功能通过type: actor参数实现，可以配置最小出现次数(minimum)和返回数量限制(limit)等参数。

常见配置问题解析

在配置动态演员集合时，开发者需要注意几个关键参数的区别：

1. tmdb_actor_details与tmdb_person的区别：

   • tmdb_actor_details参数要求传入TMDb的人物ID，而不是演员姓名
   • tmdb_person参数则同时支持TMDb ID和演员姓名作为输入

2. 模板变量使用： 系统会自动生成多个变量供模板使用，包括：

   • <<value>>：演员姓名
   • <<key>>：与value相同的演员姓名
   • <<key_name>>：演员姓名
   • <<name>>：动态集合名称

最佳实践建议

1. 描述信息填充： 如果需要为动态创建的演员集合添加描述信息，建议使用tmdb_person参数而非tmdb_actor_details，因为前者支持直接使用演员姓名。

2. 搜索条件优化： 在plex_search部分，可以使用actor: <<value>>来筛选包含特定演员的媒体项。同时可以通过genre.not等条件进一步细化搜索结果。

3. 集合排序与标识： 通过sort_title参数可以为集合设置排序前缀，使用url_poster可以为每个演员集合指定个性化的封面图片。

错误排查指南

当遇到"Regex Error: Failed to parse TMDb Person ID"错误时，通常是因为：

1. 错误地使用了tmdb_actor_details参数并传入了演员姓名而非ID
2. 解决方法是将tmdb_actor_details替换为tmdb_person，或者确保传入的是有效的TMDb人物ID

通过理解这些技术细节，用户可以更有效地利用Kometa的动态集合功能来组织和管理Plex媒体库中的演员相关媒体内容。