使用方法

FlowPick 提供两种使用方式：浏览器扩展和在线工具。本文档覆盖两者的完整操作流程。

快速上手（30 秒）

1. 打开任意包含视频的网页（如 Bilibili），播放几秒钟
2. 点击浏览器工具栏中的 FlowPick 图标
3. 在弹出窗口中点击你想下载的资源旁的下载按钮
4. 等待下载完成

扩展使用

检测媒体

FlowPick 通过监控浏览器网络请求来检测页面上的媒体资源。检测结果按类型自动分类：

检测技巧：

• 先播放视频/音频几秒钟，确保媒体请求已发出
• 如果检测不到，刷新页面后重新播放
• 某些网站使用动态加载，需要拖动进度条触发更多分片请求
• 加密的 HLS 流（带 EXT-X-KEY 标签）也能被检测到，FlowPick 会自动解密

预览媒体

在下载前预览内容，确认是要保存的资源：

• 点击播放图标 → 内置播放器预览视频/音频
• 点击眼睛图标 → 预览图片
• 预览支持 HLS 和 DASH 流的实时播放

下载单个资源

1. 在资源列表中找到目标文件
2. 点击右侧的下载图标
3. 对于普通文件（MP4、MP3 等），浏览器直接下载
4. 对于流媒体（M3U8、MPD），FlowPick 自动下载所有分片并合并为单个文件

批量下载

1. 勾选多个资源左侧的复选框
2. 点击顶部的 下载所选 按钮
3. 所有选中的资源将依次加入下载队列
4. 在下载管理面板中查看每个任务的进度

过滤资源

当页面上资源很多时，使用过滤条件快速定位目标：

弹出窗口顶部还有一根常驻的搜索栏，可以按资源地址做模糊搜索，也能切到正则模式（支持 \.m3u8$、token=\w+ 这类写法）。搜索和上面的分类、大小、格式筛选是叠加生效的。

画质选择

对于自适应流媒体（HLS/DASH），FlowPick 会列出所有可用画质：

选择画质后，FlowPick 只下载对应分辨率的分片，节省时间和存储空间。

在线工具使用

在线工具无需安装扩展，适合临时使用或无法安装扩展的场景。

M3U8 下载器

适用于 HLS 流媒体（.m3u8 地址）：

1. 打开 M3U8 下载器
2. 在输入框中粘贴 M3U8 地址
3. 点击 解析 按钮，工具会分析流信息
4. 选择画质和输出格式
5. 点击 开始下载

如何获取 M3U8 地址：

• 打开浏览器开发者工具（F12）→ Network 标签 → 过滤 m3u8
• 播放视频后，在请求列表中找到 .m3u8 文件
• 右键复制链接地址

DASH 下载器

适用于 DASH 流媒体（.mpd 地址）：

1. 打开 DASH 下载器
2. 在输入框中粘贴 MPD 地址
3. 点击 解析 按钮
4. 分别选择视频和音频轨道
5. 点击 开始下载，工具会自动合并音视频

下载管理

下载队列

所有下载任务在统一的队列中管理：

• 并发控制：同时进行的下载任务数受配置中的并发线程数限制
• 队列排序：先添加的任务优先执行
• 暂停/恢复：可以暂停单个任务或全部任务
• 取消：取消的任务会清理已下载的临时文件

进度监控

每个下载任务显示实时进度信息：

下载完成

下载完成后：

• 浏览器会弹出下载完成通知（可在设置中关闭）
• 文件保存在浏览器默认下载目录或你指定的目录
• 对于流媒体，合并后的文件以你选择的格式（MP4/TS）保存

格式转换

FlowPick 内置了基于 FFmpeg WASM 的格式转换功能，在浏览器端完成，无需上传文件。

支持的转换

设置

点击弹出窗口中的齿轮图标访问设置。常用设置项：

键盘快捷键

你可以在浏览器的扩展管理页面（chrome://extensions）中自定义快捷键：点击左上角菜单 → 键盘快捷键 → 找到 FlowPick 并修改。

使用技巧

视频网站

• 在打开 FlowPick 之前等待视频开始播放 3-5 秒
• 如果检测不到，拖动进度条到不同位置触发更多分片请求
• 加密视频（如部分付费课程）需要扩展的 webRequest 权限才能获取密钥
• 更高画质的流分片更多，合并时间更长

音频/播客

• 先播放音频以触发网络请求
• 播客通常有多个音频格式可选，优先选择 AAC 或 MP3
• 下载的音频文件保留原始元数据（ID3 标签）

图片

• 使用大小过滤排除图标和缩略图（建议最小 50KB）
• 批量下载适合图库网站
• 支持 WebP、AVIF 等现代图片格式

大文件下载

FlowPick 的浏览器扩展完整支持大文件下载，通过智能写入策略自动选择最优方案，轻松处理 GB 级别的流媒体文件。

核心能力：

• 无文件大小上限：通过 File System Access API 流式写入，理论上支持任意大小的文件
• 恒定内存占用：流式写入模式下，内存占用不受文件大小影响，不会因文件过大导致浏览器崩溃
• 智能策略降级：自动检测浏览器能力，在 FSA → StreamSaver → Blob 三种写入策略间自动切换

推荐浏览器：

下载过程中的注意事项：

• 下载过程中不要关闭标签页，否则下载会中断
• 建议保持屏幕常亮，避免系统休眠导致网络中断
• 对于超大文件（> 5GB），建议使用有线网络以获得更稳定的下载速度
• 确保磁盘有足够的剩余空间