Maintainerr v2.17.0版本发布：增强质量规则与路径修复

项目简介

Maintainerr是一个专注于媒体库管理的自动化工具，主要用于优化和维护Plex媒体服务器的内容。它能够自动执行各种维护任务，如清理重复项、管理质量规则、处理请求等，帮助用户保持媒体库的整洁和高效运行。

版本亮点

新增质量规则功能

v2.17.0版本为Radarr和Sonarr两大媒体管理工具新增了多项质量规则控制功能，进一步增强了媒体文件的质量管理能力：

1. Radarr增强：

   • 新增文件质量达标检测（布尔值）：可判断文件质量是否达到预设的cutoff标准
   • 新增文件质量名称检测（文本）：可获取文件的具体质量名称

2. Sonarr增强：

   • 新增质量配置文件名称检测（布尔值）
   • 新增剧集文件质量达标检测（布尔值）
   • 新增剧集文件质量检测（文本）

这些新规则为用户提供了更精细的质量控制手段，可以创建更复杂的自动化规则来确保媒体库中的内容始终保持最佳质量。

路径修复优化

本次版本还修复了几个与路径处理相关的重要问题：

1. 基础路径处理：

   • 修复了当使用BASE_PATH环境变量时，某些API端点（如日志流和事件流）可能返回404错误的问题
   • 优化了路径拼接逻辑，防止出现未定义的基础路径出现在最终路径中

2. 操作符修复：

   • 修正了sectionResults操作符的错误实现，确保相关功能正常工作

技术细节

质量规则实现原理

新增的质量规则功能主要通过以下方式实现：

1. 对于布尔类型的规则（如质量是否达标），系统会从媒体文件的元数据中提取相关信息，与用户配置的质量标准进行比对，返回真/假结果。

2. 对于文本类型的规则（如质量名称），系统直接从媒体文件的元数据中提取相应的文本信息。

这些规则的实现深度集入了Radarr和Sonarr的API，能够实时获取最新的文件质量信息。

路径处理改进

路径处理的改进主要涉及：

1. 在构建API端点路径时，现在会正确考虑BASE_PATH配置，确保在各种部署环境下都能正确访问所有端点。

2. 优化了路径拼接算法，避免了可能出现的前导或尾随斜杠问题，以及未定义路径段的问题。

升级建议

对于正在使用Maintainerr管理媒体库的用户，建议尽快升级到v2.17.0版本，特别是：

1. 依赖质量规则进行自动化管理的用户，可以立即受益于新增的质量控制选项。

2. 使用反向代理或自定义基础路径部署的用户，路径修复将显著改善API访问的稳定性。

升级过程与往常一样简单，只需替换容器或二进制文件即可，无需额外的配置变更。

总结

Maintainerr v2.17.0通过新增的质量规则和路径修复，进一步巩固了其作为专业媒体库管理工具的地位。这些改进不仅增强了功能丰富度，也提升了系统的稳定性和可靠性，为用户提供了更加完善的媒体库管理体验。