Unmanic插件notify_sonarr与Sonarr API兼容性问题解决方案

问题背景

在使用Unmanic媒体处理系统的notify_sonarr插件时，用户遇到了一个API调用错误。该插件的主要功能是在Unmanic完成文件处理后通知Sonarr进行相应的更新操作。具体表现为插件能够成功触发Sonarr的刷新操作，但在尝试重命名文件时失败，并返回错误信息："SonarrAPI.get_episode_file() got an unexpected keyword argument 'series'"。

错误分析

这个错误表明插件尝试调用Sonarr API的方式与当前Sonarr API版本不兼容。具体来说，插件使用了get_episode_file方法并传入了series参数，但这个参数在当前API版本中不被支持。

通过分析Sonarr API的变更历史可以发现，不同版本的API方法签名可能有所变化。在较新版本的Sonarr中，获取剧集文件的方法可能需要使用不同的参数或完全不同的方法名。

解决方案

经过技术分析，发现可以通过修改插件代码中的API调用方式来解决问题。具体修改如下：

1. 原问题代码：

rename_list = api.get_episode_file(series_id, series=True)

2. 修改后代码：

rename_list = api.get_episode_files_by_series_id(series_id)

这个修改将调用方法从get_episode_file改为get_episode_files_by_series_id，并移除了不被支持的series参数。新方法名更符合当前Sonarr API的设计规范，直接通过系列ID获取相关剧集文件。

实施步骤

1. 定位插件文件：~/.unmanic/plugins/notify_sonarr/plugin.py
2. 找到第162行左右的API调用代码
3. 将原有调用替换为新的API方法调用
4. 保存文件并重启Unmanic服务

验证结果

修改后，插件功能恢复正常，日志显示：

• 成功触发系列刷新
• 成功执行文件重命名操作
• Sonarr界面也能正确反映这些变更

技术建议

对于类似集成不同系统API的插件开发，建议：

1. 定期检查依赖API的变更日志
2. 实现API版本兼容性检查
3. 在代码中添加适当的错误处理和回退机制
4. 考虑使用API客户端库而不是直接调用，以获得更好的兼容性

这个案例也展示了开源社区解决问题的典型流程：用户发现问题、分析原因、提出解决方案并验证，最终分享给社区。这种协作方式使得开源软件能够不断改进和完善。