Kometa项目配置文件中模板变量使用注意事项

在Kometa媒体库管理工具的配置文件中，模板变量(template variables)的正确使用对于功能实现至关重要。近期发现一个常见配置错误值得用户特别注意。

问题现象

用户在使用Kometa的覆盖层(overlay)功能时，发现即使已经在配置文件中将某些模板变量设置为false，系统仍然会搜索和识别这些本应被忽略的项目。这种情况通常出现在分辨率相关的覆盖层配置中。

根本原因

经过分析，问题出在配置文件的语法格式上。正确的配置应该使用下划线连接的"template_variables"而非空格分隔的"template variables"。

错误示例：

overlay_files:
  - default: resolution
    template variables:  # 此处格式错误
      use_720p_dvhdrplus: false

正确示例：

overlay_files:
  - default: resolution
    template_variables:  # 正确格式
      use_720p_dvhdrplus: false

技术细节

1. YAML语法规范：在YAML配置文件中，带空格的键名需要使用引号包裹，而使用下划线连接的键名则不需要。Kometa的设计遵循了这一规范。

2. 模板变量机制：Kometa的覆盖层系统通过解析这些模板变量来决定哪些特性应该被启用或禁用。格式错误会导致解析失败，变量设置被忽略。

3. 影响范围：这个问题主要影响分辨率相关的覆盖层配置，包括各种HDR、DV等视频格式的标识显示控制。

最佳实践建议

1. 始终使用下划线连接的"template_variables"格式
2. 在修改配置文件后，建议先使用YAML验证工具检查语法
3. 对于复杂的配置，可以采用分步测试的方法验证各项功能
4. 注意保持缩进一致，YAML对缩进非常敏感

总结

正确的配置文件语法是确保Kometa各项功能正常工作的基础。特别是对于模板变量这类需要精确控制的配置项，必须严格遵循格式规范。用户在遇到类似功能异常时，应首先检查配置文件的关键字拼写和格式是否正确。

通过遵循这些规范，用户可以充分利用Kometa强大的媒体库管理功能，实现精确的覆盖层控制和个性化配置。