ytdl-sub项目中关于Kodi安全模式下UTF-8字符处理的解析

在视频下载工具ytdl-sub的使用过程中，用户可能会遇到一个特殊现象：当视频标题或描述包含emoji等4字节UTF-8字符时，这些字符在生成的.nfo文件中会被替换为白色方块符号(□)。这种现象实际上是设计上的有意行为，而非软件缺陷。

现象分析

当用户通过ytdl-sub下载在线视频时，如果视频元数据包含：

1. 多字节UTF-8字符（如emoji）
2. 启用了Kodi兼容模式

生成的.nfo文件中，这些特殊字符会被转换为U+25A1(□)符号。例如"🍜"会被转换为"□"，而文件名中的emoji则保持原样显示。

技术背景

这种处理方式源于：

1. Kodi媒体中心的XML解析器对4字节UTF-8字符的支持限制
2. 保证.nfo文件在Kodi环境中的稳定解析
3. 避免潜在的字符编码问题

解决方案

用户可以通过以下方式控制此行为：

1. 保持默认的Kodi安全模式（推荐Kodi用户）

   presets:
     tv_show:
       nfo_tags:
         kodi_safe: True
   

2. 禁用Kodi安全模式（需要完整Unicode支持时）

   presets:
     tv_show:
       nfo_tags:
         kodi_safe: False
   

最佳实践建议

1. 如果主要使用Kodi作为媒体中心，建议保持kodi_safe启用
2. 如果需要保留完整元数据，可考虑：
   • 禁用kodi_safe
   • 同时维护一个原始描述文本文件
3. 注意文件名和.nfo文件的处理差异源于不同系统的兼容性要求

这种设计体现了ytdl-sub在功能完整性和系统兼容性之间的平衡考虑，用户可根据实际使用场景灵活配置。