JavSP项目中的文件命名规则问题解析

在JavSP项目中，用户在使用filename = $num命名规则时遇到了预期与实际不符的情况。根据项目文档描述，预期文件名应包含编号前缀，但实际生成的文件名却缺少了这一关键信息。

问题现象分析

用户期望的文件命名格式为：

SQTE-196-fanart.jpg
SQTE-196-poster.jpg
SQTE-196.mp4
SQTE-196.nfo

但实际获得的文件名为：

fanart.jpg
poster.jpg
SQTE-196.mp4
movie.nfo

从日志分析可以看出，这是一个典型的配置文件设置问题。项目维护者指出，关键在于media_servers配置项的设置。

技术解决方案

经过深入分析，该问题的根本原因在于配置文件中的媒体服务器类型设置不当。正确的解决方法是将配置文件中的：

media_servers = xxx

修改为：

media_servers = jellyfin

技术背景说明

JavSP项目支持多种媒体服务器环境，不同的服务器类型对文件命名规则有不同的要求。当设置为jellyfin时，系统会自动采用包含编号的完整命名规则，这与其他媒体服务器的默认行为有所不同。

最佳实践建议

1. 在使用文件命名功能前，务必确认media_servers配置正确
2. 对于需要保留编号信息的场景，推荐使用jellyfin配置
3. 修改配置后建议重启应用以确保设置生效
4. 对于特殊需求，可考虑自定义命名规则模板

总结

文件命名规则是媒体管理中的重要环节，正确的配置可以确保后续的媒体识别和管理更加高效。JavSP项目通过灵活的配置选项支持多种使用场景，理解并正确设置这些参数是获得预期效果的关键。