FluxDown 浏览器扩展拦截不到下载 — 排查 Native Messaging、Permission、Tab

常见症状

• 浏览器工具栏扩展图标变灰，hover 显示「FluxDown 未连接」。
• 点下载按钮，浏览器自己下载了文件，FluxDown 没收到。
• 扩展弹窗里嗅探不到 HLS/DASH 媒体流。

排查步骤（按顺序）

1. 确认 FluxDown 桌面端在跑

扩展通过 Native Messaging 和 FluxDown Agent 层通信——FluxDown 没开的话扩展肯定连不上：

• 检查系统托盘有没有 FluxDown 图标。
• 没有的话先启动 FluxDown，再刷新浏览器页面（或重启浏览器）。

2. 确认 Native Messaging 注册成功

FluxDown 首次启动时自动注册 Native Messaging manifest。如果手动删过、或杀毒软件误删了，可以在 FluxDown 里手动触发重新注册：

桌面端：设置 → 浏览器 → 重新注册 Native Messaging Host。

手动检查注册位置：

• Windows — 注册表 HKCU\Software\Microsoft\Edge\NativeMessagingHosts\fluxdown（Chrome 路径类似）
• macOS — ~/Library/Application Support/Google/Chrome/NativeMessagingHosts/fluxdown.json
• Linux — ~/.config/google-chrome/NativeMessagingHosts/fluxdown.json

注册文件存在且 JSON 格式正确 → Native Messaging 配置没问题。

3. 检查扩展权限

浏览器扩展安装时需要 nativeMessaging、downloads、webRequest、<all_urls> 等权限。有时候浏览器更新后或扩展升级后权限会被重置——打开扩展管理页：

• Chrome/Edge：chrome://extensions/ → FluxDown → 详情 → 确保全部权限开启。
• Firefox：about:addons → FluxDown → 权限。

4. 确认不在隐身/隐私模式下

Chrome 和 Edge 的隐身模式默认不让扩展运行。Firefox 隐私模式可以但需要手动开启：

• Chrome/Edge — 隐身窗口里扩展不工作，退出隐身即可。
• Firefox — about:addons → FluxDown → 三个点 → 管理 → 在隐私模式下运行（开启）。

5. 某些下载不走标准路径

极少数站点的下载走 JavaScript 动态生成 blob / objectURL、或 Service Worker 拦截了请求——这种情况下扩展的三层拦截（Header / 文件名 / 兜底）可能全部漏掉。可以：

• 右键下载按钮 → 「复制链接地址」→ 直接粘贴到 FluxDown 新建下载窗口。
• 打开开发者工具 Network 面板找到真实下载 URL。

6. 重装扩展

上面都试了还不行，卸载扩展再装一次。同时 FluxDown 也重启一下——让 Native Messaging 在干净状态下重新握手。

快速诊断