浏览器扩展
MediaGo 自带一个轻量浏览器扩展（Manifest V3），在你浏览任意网站时自动嗅探可下载的视频/音频资源，一键发送到 MediaGo 下载。
它能做什么
- 跨站点嗅探 HLS / m3u8 流、直连
.mp4/.flv/.mov等媒体文件 - 识别 Bilibili 视频页和 YouTube 视频/短片/直播/嵌入页
- 在浏览器工具栏图标上显示当前页面已检测到的资源数量
- 一键把单条或全部资源导入 MediaGo（Desktop 或自建服务）
安装
MediaGo 尚未上架 Chrome Web Store，需以"加载已解压的扩展程序"方式安装。Desktop 版已把扩展打包进安装目录，不必额外下载。
- 打开 MediaGo Desktop 应用
- 进入 设置 → 更多设置 → 浏览器扩展目录，点击按钮打开扩展文件夹
- 在 Chrome / Edge 地址栏访问
chrome://extensions/ - 右上角开启 开发者模式
- 点击 加载已解压的扩展程序，选择第 2 步打开的那个文件夹
- 扩展图标出现在工具栏即安装成功；建议点图钉把它固定住
调用模式
首次安装后点击扩展图标右上角齿轮进入设置页，选择一种调用方式：
| 模式 | 使用场景 | 要求 |
|---|---|---|
| Desktop · Schema 协议 | 本机装了 MediaGo Desktop，允许浏览器唤起协议 | 无配置；首次会弹出"Open MediaGo?"对话框，勾选"总是允许"即可静默直通 |
| Desktop · HTTP 本地接口（默认） | 本机装了 MediaGo Desktop 且在运行 | 无配置；扩展固定连接 127.0.0.1:39719 |
| Docker / 自建服务 · HTTP | 连接远端自建 MediaGo 服务端（Docker 部署等） | 填写服务器 URL；若后端启用了 --enable-auth 则填 API Key |
扩展不会自动降级。 选定模式后，调用失败会直接报错。要换模式请回到设置页手动切换。
导入行为
设置页 导入行为 卡片里的两个开关：
- 立即开始下载：开 = 任务进队列并立刻开跑；关 = 仅加入下载列表，等用户手动触发。对 Schema 和 HTTP 两种模式都生效。
- 静默导入（Schema 模式）：开 = Schema 调用携带
silent=1，MediaGo 收到即创建任务；关 = MediaGo 会弹出下载表单让你核对名字/类型/保存路径再提交。仅 Schema 模式生效，HTTP 模式一律静默。
界面语言
扩展支持中英文，默认跟随浏览器 UI 语言（浏览器是中文即显示中文）。也可以在设置页 界面语言 卡片强制切换到"跟随系统 / 中文 / English"之一。
常见问题
点"浏览器扩展目录"打不开
- 开发场景：先跑
pnpm -F @mediago/extension build构建扩展产物 - 生产场景：重新安装 MediaGo，确保
resources/extension/在安装目录里
Desktop · HTTP 模式测试连接失败
- 确认 MediaGo Desktop 在运行
- 确认端口
39719没被其他进程占用（netstat -ano | findstr 39719） - 如果你本地同时跑了 Web/server 模式的 Go Core，注意那个用的是
9900，不是 39719
Schema 模式每次都弹窗
首次弹出"Open MediaGo-community?"时勾选 总是允许 即可。之后 Chrome 会静默把请求转给 Desktop。
批量导入 Schema 模式失败
Schema 一次只能发一条任务，这是浏览器协议调用的限制。要批量导入请切到 HTTP 模式（Desktop 或 Docker 均可）。