Tdarr项目中MKV文件修改时间问题的技术分析

问题背景

在使用Tdarr媒体处理系统时，用户发现当系统扫描MKV格式的视频文件时，文件的修改时间(mtime)会被意外更新。这种情况主要发生在文件尚未包含STATISTICS元数据的情况下，导致文件系统层面的时间戳变更，进而可能触发inotify监控、SnapRAID差异报告等副作用。

技术原理分析

该问题的核心在于Tdarr对MKV文件处理的工作机制。当Tdarr扫描MKV文件时，会调用mkvpropedit工具，并使用--add-track-statistics-tags参数为文件添加统计信息标签。这一操作实际上会重写文件的部分元数据区域，导致操作系统层面的文件修改时间更新。

值得注意的是，这种行为是mkvpropedit工具的标准工作方式，而非Tdarr本身的缺陷。mkvpropedit在修改Matroska容器文件时，会创建一个临时文件进行修改，然后将原始文件替换为修改后的版本，这种操作流程自然会更新文件的修改时间。

影响范围

此问题主要影响以下场景：

1. 新添加到库中的MKV文件
2. 尚未包含完整STATISTICS元数据的MKV文件
3. 使用文件系统监控工具(inotify等)的环境
4. 使用SnapRAID等基于文件修改时间进行差异检测的系统

解决方案建议

对于希望保持原始文件时间戳的用户，可以考虑以下几种技术方案：

1. 禁用自动统计信息生成：在Tdarr的"Options"选项卡中关闭"Run mkvpropedit on files before running plugins"选项，避免在扫描阶段自动运行mkvpropedit。

2. 使用自定义流程插件：开发或使用现有的Tdarr插件，在文件处理流程中保存原始时间戳，并在处理完成后恢复这些时间戳。

3. 延迟统计信息生成：建议Tdarr可以考虑优化扫描策略，仅在文件实际进入处理流程时才生成统计信息，而非在初始扫描阶段就执行此操作。

最佳实践

对于生产环境中的Tdarr部署，特别是大型媒体库的管理，建议：

1. 在初始批量导入阶段，临时禁用mkvpropedit的自动运行
2. 对已包含完整元数据的文件跳过不必要的统计信息重新生成
3. 考虑使用专门的插件来处理时间戳保留需求
4. 对于使用文件监控或备份系统的环境，提前规划好时间戳变更可能带来的影响

总结

Tdarr系统中MKV文件修改时间变更的问题，本质上是工具链工作方式与用户期望之间的差异。理解这一机制后，用户可以通过配置调整或自定义插件来实现更符合自身需求的行为。对于系统维护者而言，这也提示了在媒体处理系统中，文件元数据操作可能带来的意外副作用需要在设计阶段就加以考虑。