BililiveRecorder文件名乱码问题分析与解决方案

问题背景

在使用BililiveRecorder进行直播录制时，部分用户发现当主播标题(title)中包含特殊字符(如"?")时，在Windows系统下会出现文件名乱码现象。这一问题主要出现在Linux系统录制后通过SMB协议在Windows下查看文件时。

根本原因分析

该问题并非BiliveRecorder本身的缺陷，而是由以下因素共同导致：

1. 文件系统差异：Windows和Linux对文件名中允许使用的字符集存在差异。Windows限制文件名中不能包含"?、:、*、<、>、|"等特殊字符。

2. 跨平台文件共享：当在Linux系统上录制并保存到NAS，然后通过SMB协议在Windows下访问时，SMB协议在字符转换过程中可能无法正确处理这些特殊字符。

3. 程序处理逻辑：BililiveRecorder默认仅根据当前运行的操作系统来过滤非法字符，在Linux下运行时不会主动过滤Windows特有的非法字符。

技术解决方案

方案一：使用Liquid模板过滤器

BililiveRecorder支持使用Liquid模板引擎来定义文件名格式，可以通过添加replace过滤器来主动替换可能引起问题的字符：

{{ roomId }}-{{ name }}/录制-{{ roomId }}-{{ "now" | time_zone: "Asia/Shanghai" | format_date: "yyyyMMdd-HHmmss-fff" }}-{{ title | replace: "?", "？" | replace: ":", "：" }}.flv

此方案的优势在于：

• 灵活可控，可以精确指定要替换的字符
• 可以保留原字符的语义，如将英文问号替换为中文问号
• 不影响其他系统的正常使用

方案二：系统级字符替换

对于需要频繁处理此类情况的用户，可以考虑在系统层面设置：

1. 在Linux挂载SMB共享时指定字符集选项
2. 配置NAS的SMB服务使用兼容性更强的字符编码

最佳实践建议

1. 跨平台使用考虑：如果录制的文件需要在多平台间共享，建议在文件名模板中主动过滤Windows不支持的字符。

2. 字符替换策略：

   • 将"? "替换为"？"
   • 将":"替换为"："
   • 过滤或替换"*<>|"等Windows保留字符

3. 测试验证：在正式使用前，建议先用各种特殊字符测试文件名生成效果。

总结

BililiveRecorder的文件名乱码问题本质上是跨平台文件系统兼容性问题。通过合理使用Liquid模板的字符替换功能，可以有效解决这一问题，确保录制文件在各种环境下都能正常显示和使用。这一解决方案既保持了软件的灵活性，又解决了实际使用中的痛点。