安装
安装 FlowPick 浏览器扩展的完整指南，涵盖 Chrome 和 Edge 商店安装、开发者模式手动加载、权限说明，以及在线 M3U8 和 DASH 工具的使用方式。
FlowPick 提供两种使用方式：浏览器扩展（推荐）和在线工具（无需安装）。本文档涵盖扩展的安装方法和在线工具的访问方式。
选择使用方式
| 浏览器扩展 | 在线工具 | |
|---|---|---|
| 安装要求 | 需要安装扩展 | 无需安装，打开网页即用 |
| 媒体检测 | 自动监控网络请求 | 手动粘贴流媒体 URL |
| CORS 限制 | 不受限 | 受同源策略限制 |
| 适用场景 | 日常高频使用 | 临时使用、无法安装扩展 |
| 功能入口 | 浏览器工具栏图标 | /m3u8-downloader /dash-downloader |
商店安装（推荐）
Chrome
- 打开 Chrome 网上应用店
- 搜索 FlowPick，或直接访问扩展页面链接
- 点击 添加到 Chrome
- 在弹出的确认对话框中点击 添加扩展程序
- 安装完成后，FlowPick 图标会出现在浏览器工具栏右侧
如果图标没有出现在工具栏中，点击工具栏右侧的拼图图标（扩展程序），找到 FlowPick 并点击图钉图标将其固定。
Edge
- 打开 Edge 加载项商店
- 搜索 FlowPick，或直接访问扩展页面链接
- 点击 获取
- 在弹出的确认对话框中点击 添加扩展
- 安装完成后，FlowPick 图标会出现在浏览器工具栏右侧
其他 Chromium 内核浏览器
以下浏览器均基于 Chromium 内核，安装方式与 Chrome 类似：
| 浏览器 | 扩展商店 | 备注 |
|---|---|---|
| Brave | Chrome 网上应用店 | 与 Chrome 完全兼容 |
| Opera | Chrome 网上应用店 / Opera Addons | 两种方式均可 |
| 360 极速浏览器 | Chrome 网上应用店 / 360 扩展中心 | 推荐使用 Chrome 商店版本 |
| QQ 浏览器 | Chrome 网上应用店 / QQ 应用市场 | 推荐使用 Chrome 商店版本 |
| 搜狗高速浏览器 | Chrome 网上应用店 | 需开启"开发者模式" |
| Yandex Browser | Chrome 网上应用店 / Yandex Addons | 两种方式均可 |
Firefox
- 打开 Firefox Add-ons 商店
- 点击 添加到 Firefox
- 在弹出的权限确认对话框中点击 添加
- 安装完成后，FlowPick 图标会出现在浏览器工具栏
Firefox 版本要求 109+。安装后如果图标没出现在工具栏，点击 Firefox 菜单 → 扩展和主题，找到 FlowPick 并将其固定到工具栏。
Firefox 上 FlowPick 的大文件下载行为与 Chrome 略有不同——输出文件会先流式写入浏览器的 OPFS 临时存储（避免内存溢出），合并完成后需要点击"保存到磁盘"导出文件。如需自动保存到指定目录，建议使用 Chrome 或 Edge。
手动安装
如果你无法访问扩展商店，或者需要使用开发版本，可以通过手动加载的方式安装。
适用场景
- 企业网络限制无法访问 Chrome 商店或 Firefox Add-ons
- 需要测试开发版本或预发布版本
- 使用未内置商店的 Chromium 浏览器
安装步骤
下载扩展文件
从 GitHub Releases 或官网下载 FlowPick 扩展 ZIP 包。
解压到本地文件夹
将 ZIP 包解压到一个固定的文件夹中。注意：安装后不要移动或删除该文件夹，否则扩展将失效。
打开扩展管理页面
在浏览器地址栏输入对应的扩展管理地址：
| 浏览器 | 地址 |
|---|---|
| Google Chrome | chrome://extensions |
| Microsoft Edge | edge://extensions |
| Brave | brave://extensions |
| Opera | opera://extensions |
| 360 极速浏览器 | chrome://extensions |
| QQ 浏览器 | chrome://extensions |
| 搜狗高速浏览器 | chrome://extensions |
| Yandex Browser | yandex://extensions |
| Firefox | about:debugging#/runtime/this-firefox |
开启开发者模式
在扩展管理页面右上角，打开 开发者模式 开关。
Firefox 用户无需开启开发者模式。在
about:debugging#/runtime/this-firefox 页面直接操作下一步。加载扩展
- Chrome / Edge / 其他 Chromium 浏览器：点击 加载已解压的扩展程序，选择步骤 2 中解压的文件夹。
- Firefox：点击 临时载入附加组件，选择步骤 2 中解压文件夹内的
manifest.json文件。
确认安装
安装成功后，FlowPick 图标会出现在浏览器工具栏中。如果未出现，在扩展列表中找到 FlowPick 并点击图钉图标固定。
手动安装的注意事项
- 手动安装的扩展不会自动更新，需要手动下载新版本并替换文件
- 每次浏览器启动时可能会提示"请停用开发者模式扩展"，这是正常现象，点击取消即可
- 如果扩展文件夹被移动或删除，扩展将显示为"已损坏"，需要重新加载
- Firefox 特有：临时载入的扩展仅在当前浏览器会话有效，重启 Firefox 后需要重新加载。如需永久安装，请通过 Firefox Add-ons 商店 安装
验证安装
安装完成后，通过以下方式确认扩展正常工作：
- 打开任意包含视频的网页（如 Bilibili）
- 播放视频几秒钟
- 点击工具栏中的 FlowPick 图标
- 弹出窗口应显示检测到的媒体资源
如果弹出窗口显示"未检测到媒体资源"，请参考 常见问题排查。
权限说明
安装时浏览器会提示 FlowPick 需要以下权限。每个权限都有明确的用途：
| 权限 | 用途 | 是否必需 |
|---|---|---|
activeTab | 在你点击扩展图标时访问当前标签页，用于检测页面上的媒体资源 | 必需 |
downloads | 将下载的文件保存到你的计算机 | 必需 |
storage | 保存你的偏好设置（如并发线程数、输出格式等） | 必需 |
webRequest | 监控浏览器发出的网络请求，识别视频、音频和图片 URL | 必需 |
host_permissions | 允许扩展在所有网站上运行，以便检测任意网页的媒体资源 | 必需 |
FlowPick 仅在以下时机访问你的数据：(1) 你主动点击扩展图标时；(2) 你主动点击下载按钮时。扩展不会在后台持续运行或收集任何浏览数据。详见 隐私与安全。
更新扩展
商店版本
商店安装的扩展会自动更新。浏览器会定期检查并安装新版本，无需手动操作。
如果你想立即检查更新：
- 打开扩展管理页面（
chrome://extensions或 Firefox 的about:addons） - Chrome / Edge：开启右上角的 开发者模式，点击 更新 按钮
- Firefox：点击 FlowPick 旁的齿轮图标 → 检查更新
手动安装版本
手动安装的扩展不会自动更新。更新步骤：
- 从 GitHub Releases 下载最新版本
- 解压并覆盖原有的扩展文件夹
- 打开扩展管理页面
- 找到 FlowPick，点击刷新图标
- 或者移除后重新加载
卸载
Chrome / Edge
- 右键点击工具栏中的 FlowPick 图标
- 选择 从 Chrome 中移除（Edge：从 Microsoft Edge 中移除）
- 或者打开扩展管理页面，找到 FlowPick 并点击 移除
Firefox
- 右键点击工具栏中的 FlowPick 图标
- 选择 从 Firefox 中移除
- 或者打开
about:addons页面，找到 FlowPick，点击 ... → 移除
手动安装版本
- 打开扩展管理页面
- 找到 FlowPick，点击 移除（Firefox 临时加载：点击 重新载入 旁的 移除）
- 手动删除解压的扩展文件夹（可选）
故障排除
扩展图标不显示
- 点击工具栏右侧的拼图图标（扩展程序）
- 在列表中找到 FlowPick
- 点击图钉图标将其固定到工具栏
Firefox 用户：点击 Firefox 菜单 → 扩展和主题，在扩展列表中找到 FlowPick，点击齿轮图标 → 固定到工具栏。
安装后无法检测到媒体
- 刷新目标网页后重试
- 确保媒体已开始播放（不是暂停状态）
- 检查是否有其他扩展冲突（如广告拦截器）
下载不工作
- 检查浏览器下载设置（是否设置了"下载前询问位置"）
- 确保磁盘有足够空间
- 检查是否有其他下载管理扩展冲突
- Firefox 用户：如果合并完成后未弹出保存对话框，检查是否需要手动点击"保存到磁盘"按钮导出文件（Firefox 会将大文件先写入 OPFS 临时存储）
如果以上方法无法解决问题，请查看 常见问题排查 获取更详细的诊断步骤。