Tampermonkey中GM_download文件名解析问题解析

在Tampermonkey浏览器扩展的使用过程中，用户发现了一个关于GM_download API的文件名解析问题。这个问题主要出现在当用户不指定下载文件名，而让系统自动从服务器获取文件名时，对URL编码字符的处理不正确。

问题现象

当服务器返回的文件名包含URL编码字符时（例如"file%20name.jpg"），Tampermonkey的GM_download函数没有正确解码这些字符。具体表现为：

• 服务器提供的文件名："file%20name.jpg"
• 期望解析结果："file name.jpg"
• 实际解析结果："file20name.jpg"

技术分析

这个问题源于对URL编码字符串的处理逻辑不完整。URL编码中，%20代表空格字符，%后跟随两个十六进制数字表示特定字符。正确的处理流程应该是：

1. 从服务器获取原始文件名
2. 识别所有%xx格式的编码字符
3. 将每个%xx替换为对应的ASCII字符
4. 使用解码后的字符串作为最终文件名

然而，当前实现中似乎只是简单地移除了%符号，而没有进行完整的URL解码过程，导致"file%20name.jpg"变成了"file20name.jpg"。

影响范围

这个问题会影响所有依赖GM_download API且不显式指定文件名的用户脚本。特别是那些从服务器获取文件名并希望保留原始文件名的场景。

解决方案

开发者已经在Tampermonkey 5.3.6208 beta版本中修复了这个问题。修复后的版本能够正确处理URL编码的文件名，包括但不限于：

• %20 → 空格
• %2F → /
• %3A → :
• 其他标准URL编码字符

最佳实践建议

为了避免类似问题，建议用户脚本开发者：

1. 明确指定下载文件名，而不是依赖自动解析
2. 如果需要使用服务器文件名，可以先自行处理URL解码
3. 对于关键功能，考虑添加文件名验证逻辑
4. 及时更新Tampermonkey到最新版本

总结

这个问题的修复提高了Tampermonkey在处理服务器返回文件名时的准确性和可靠性。对于依赖自动文件名解析功能的用户脚本来说，更新到修复版本将确保文件下载时能够正确保留原始文件名中的特殊字符。