wehub-resource-sync
71 lines
3.7 KiB
Markdown
71 lines
3.7 KiB
Markdown
---
|
||
layout: doc
|
||
outline: deep
|
||
---
|
||
|
||
# 浏览器扩展
|
||
|
||
MediaGo 自带一个轻量浏览器扩展（Manifest V3），在你浏览任意网站时自动嗅探可下载的视频/音频资源，一键发送到 MediaGo 下载。
|
||
|
||
## 它能做什么
|
||
|
||
- 跨站点嗅探 HLS / m3u8 流、直连 `.mp4` / `.flv` / `.mov` 等媒体文件
|
||
- 识别 Bilibili 视频页和 YouTube 视频/短片/直播/嵌入页
|
||
- 在浏览器工具栏图标上显示当前页面已检测到的资源数量
|
||
- 一键把单条或全部资源导入 MediaGo（Desktop 或自建服务）
|
||
|
||
## 安装
|
||
|
||
MediaGo 尚未上架 Chrome Web Store，需以"加载已解压的扩展程序"方式安装。Desktop 版已把扩展打包进安装目录，不必额外下载。
|
||
|
||
1. 打开 MediaGo Desktop 应用
|
||
2. 进入 **设置 → 更多设置 → 浏览器扩展目录**，点击按钮打开扩展文件夹
|
||
3. 在 Chrome / Edge 地址栏访问 `chrome://extensions/`
|
||
4. 右上角开启 **开发者模式**
|
||
5. 点击 **加载已解压的扩展程序**，选择第 2 步打开的那个文件夹
|
||
6. 扩展图标出现在工具栏即安装成功；建议点图钉把它固定住
|
||
|
||
## 调用模式
|
||
|
||
首次安装后点击扩展图标右上角齿轮进入设置页，选择一种调用方式：
|
||
|
||
| 模式 | 使用场景 | 要求 |
|
||
| ----------------------------------- | -------------------------------------------- | ------------------------------------------------------------------- |
|
||
| **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 / Italiano"之一。
|
||
|
||
## 常见问题
|
||
|
||
### 点"浏览器扩展目录"打不开
|
||
|
||
- **开发场景**：先跑 `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 均可）。
|