Voice-over-translation项目在Yandex Disk视频翻译功能故障排查指南

问题现象分析

近期部分用户反馈在使用voice-over-translation脚本时，Yandex Disk视频翻译功能出现异常。主要症状表现为：

1. 翻译按钮正常显示但点击后报错"Failed to request video translation"
2. 该问题在Firefox浏览器上出现频率较高
3. 部分用户在Yandex Browser原生环境中也遇到类似问题

根本原因定位

经过技术分析，该问题主要由以下因素导致：

1. CSP安全策略限制：Firefox浏览器对内容安全策略(CSP)执行较为严格，会阻止Tampermonkey脚本的正常请求

2. 浏览器兼容性差异：

   • Chromium内核浏览器(如Opera)通常能正常工作
   • Yandex Browser因服务端限制会主动屏蔽Disk视频翻译功能

3. 视频可见性设置：必须确保视频已设置为"公开"或"通过链接共享"状态

解决方案汇总

针对Firefox用户

1. 调整Tampermonkey设置：

   • 进入设置 → 配置模式改为"专家模式"
   • 找到"添加TM到CSP安全策略"选项设为"是"

2. 版本兼容性提示：

   • Tampermonkey 5.2+版本移除了CSP设置选项
   • 建议降级使用Legacy版本(4.x)以获得完整功能

通用解决步骤

1. 确保视频共享设置正确：

   • 上传视频至Yandex Disk
   • 使用"共享"功能生成公开链接
   • 在新标签页中打开该链接进行操作

2. 语言识别注意事项：

   • 使用"自动检测"模式时，系统会自主选择语音合成方案
   • 如需特定语音效果，建议手动指定源语言

技术背景延伸

CSP策略解析

内容安全策略(Content Security Policy)是现代浏览器的重要安全机制。当脚本尝试跨域访问资源时，CSP会检查请求是否被目标站点的策略允许。在Firefox上，这种检查更为严格，需要显式配置脚本管理器以通过验证。

语音合成差异

项目在Yandex Disk和YouTube平台使用不同的语音合成引擎：

• YouTube翻译使用标准语音库
• Disk翻译采用自适应语音选择算法 这种差异是平台API限制导致的正常现象，不影响翻译质量。

最佳实践建议

1. 优先使用Chromium内核浏览器进行操作
2. 定期检查Tampermonkey的CSP设置状态
3. 视频处理时注意：
   • 时长控制在2小时以内
   • 音频清晰度建议不低于128kbps
   • 避免背景音乐干扰语音识别

通过以上措施，用户可以稳定使用voice-over-translation项目的全部功能，获得流畅的视频翻译体验。