Firefox右键菜单调用yt-dlp+VLC播放YouTube视频故障求助

一、原生消息配置错误（核心触发点） #

• 注册表项配置错误：检查Windows注册表HKEY_CURRENT_USER\Software\Mozilla\NativeMessagingHosts\你的主机名的默认值，必须指向vlchost.json的完整路径，路径需用双反斜杠（如C:\\Users\\xxx\\vlchost.json），不能直接指向bat文件。
• vlchost.json格式/内容错误：
  • path字段必须指向bat脚本的完整双反斜杠路径，如"path": "C:\\Users\\xxx\\vlchost.bat"
  • type固定为stdio，allowed_extensions需与manifest.json中applications.gecko.id完全匹配，不能有拼写误差
  • 确保json无语法错误（如逗号遗漏、引号不配对），否则Firefox无法解析，会触发系统用默认编辑器打开json文件的问题

二、bat脚本适配原生消息传递逻辑 #

原生消息通过stdin/stdout传递JSON格式数据，而非控制台输入，需修改脚本适配：

@echo off
setlocal enabledelayedexpansion

:: 读取原生消息的JSON输入（第一行是消息长度，第二行是JSON内容）
set "len="
set /p len=
set "json="
set /p json=

:: 提取URL（假设传入JSON格式为{"url": "xxx"}）
for /f tokens^=2^ delims^=^" %%a in ("!json!") do set "url=%%a"

:: 执行yt-dlp与VLC命令（替换为你实际的安装路径）
"C:\Program Files\VideoLAN\VLC\yt-dlp.exe" --get-url -f b "!url!" | "C:\Program Files\VideoLAN\VLC\vlc.exe" --meta-title "!url!" --fullscreen --no-video-title

:: 必须返回JSON格式响应给扩展，否则会触发端口断开错误
echo {"status": "success"}
endlocal

三、background.js代码修正 #

端口断开错误多因原生主机未正确响应或调用方式错误，调整代码如下：

// 注册右键菜单
browser.contextMenus.create({
  id: "play-with-vlc",
  title: "Play with VLC via yt-dlp",
  contexts: ["page"]
});

// 菜单点击事件处理
browser.contextMenus.onClicked.addListener(async (info, tab) => {
  if (info.menuItemId === "play-with-vlc") {
    try {
      // 调用原生消息主机，主机名需与vlchost.json的name字段一致
      const port = browser.runtime.connectNative("你的主机名");
      port.postMessage({url: tab.url});
      
      // 监听原生主机响应
      port.onMessage.addListener((response) => {
        console.log("Native response:", response);
        port.disconnect();
      });
      
      // 监听断开事件与错误
      port.onDisconnect.addListener(() => {
        if (browser.runtime.lastError) {
          console.error("Disconnect error:", browser.runtime.lastError.message);
        }
      });
    } catch (error) {
      console.error("Call native host failed:", error);
    }
  }
});

四、manifest.json配置验证 #

确保权限与gecko ID配置正确：

{
  "manifest_version": 2,
  "name": "YouTube to VLC",
  "version": "1.0",
  "permissions": ["contextMenus", "nativeMessaging", "tabs"],
  "background": {
    "scripts": ["background.js"]
  },
  "applications": {
    "gecko": {
      "id": "youtube-to-vlc@yourdomain.com", // 必须与vlchost.json的allowed_extensions一致
      "strict_min_version": "50.0"
    }
  }
}

五、调试验证步骤 #

1. 校验vlchost.json语法：用本地文本编辑器检查，确保无格式错误
2. 手动测试bat脚本：运行脚本后输入4{"url":"https://www.youtube.com/watch?v=xxx"}（第一行是JSON字符串长度，第二行是JSON内容），确认VLC能正常启动
3. 扩展调试：在Firefox扩展调试工具中查看background页面控制台，追踪错误信息变化
4. 注册表验证：打开注册表编辑器，确认NativeMessagingHosts下的主机名路径配置正确

内容的提问来源于stack exchange，提问作者voodooR0ST