Sonarr项目中的自定义脚本导入功能解析

背景介绍

Sonarr作为一款流行的媒体管理工具，提供了强大的自动化功能来管理电视节目。其中"Import using script"（使用脚本导入）功能允许用户在文件导入过程中执行自定义脚本，为高级用户提供了极大的灵活性。

核心问题分析

在实际使用中，有用户反馈在使用自定义脚本进行文件导入时遇到了问题，特别是当尝试将MKV格式转换为MP4格式并导入时。系统会出现两种错误：

1. "Script output contains non-existent media file"（脚本输出包含不存在的媒体文件）
2. "is not a child of"（不是目标目录的子目录）

技术原理深入

Sonarr的脚本导入机制通过ScriptImportDecider.cs文件中的逻辑处理脚本输出。脚本需要返回特定格式的字符串来指导Sonarr的后续操作：

• [MediaFile]标记主媒体文件
• [ExtraFile]标记附加文件（如字幕）
• [MoveStatus]指示文件移动状态

最佳实践建议

根据项目贡献者的建议，推荐以下工作流程：

1. 一体化处理方案：

   • 直接将文件移动到目标目录
   • 在移动过程中完成格式转换和附加文件提取
   • 输出转换后的文件路径

2. 分步处理方案：

   • 在原目录完成格式转换
   • 提取附加文件
   • 使用[MoveStatus]DeferMove让Sonarr处理后续移动

技术细节说明

• 附加文件处理系统在下载目录和通过[ExtraFile]标记导入时有差异
• 复杂标签（如default、forced等）需要通过[ExtraFile]标记才能完全支持
• 文件路径必须与目标系列目录有正确的父子关系

潜在改进方向

当前实现可能不完全支持"先转换后导入"的工作流，这可能需要作为功能请求提出。项目维护者表示如果需要，可以相对容易地适配这一功能。

总结

Sonarr的自定义脚本导入功能为高级用户提供了强大的扩展能力，但需要遵循特定的输出格式和工作流程。理解其内部处理机制有助于开发更有效的自定义脚本，实现如格式转换等高级功能。