视频嗅探

FlowPick 通过监控浏览器网络请求自动检测页面上的视频内容，支持流媒体协议（HLS/DASH）和直接视频文件，并能自动解密 AES-128 加密的流。

检测原理

FlowPick 的视频检测基于 Chrome 扩展的 webRequest API，在浏览器网络层拦截请求：

检测时机：

• 扩展安装后，需要刷新目标页面才能开始检测
• 流媒体清单通常在视频开始播放时才加载，建议先播放 3-5 秒再打开扩展
• 对于动态加载的视频（如滚动到特定位置才加载），需要触发加载后才能检测到

支持的视频格式

流媒体协议

直接视频文件

HLS（M3U8）流

HLS（HTTP Live Streaming）是 Apple 开发的流媒体协议，也是目前网络上使用最广泛的视频传输方式。Bilibili、腾讯视频、优酷等主流平台均使用 HLS。

Master Playlist vs Media Playlist

HLS 清单分为两种层级：

FlowPick 自动识别 Master Playlist，解析出所有画质选项供你选择。选择画质后，再下载对应的 Media Playlist 获取分片列表。

Master Playlist (index.m3u8)
    │
    ├── 360p  → 360p.m3u8  →  segment-001.ts, segment-002.ts, ...
    ├── 720p  → 720p.m3u8  →  segment-001.ts, segment-002.ts, ...
    └── 1080p → 1080p.m3u8 →  segment-001.ts, segment-002.ts, ...

画质选择

从 Master Playlist 解析出的画质选项按码率从高到低排序：

分片下载与合并

HLS 视频由大量 TS 分片组成（通常每个分片 2-10 秒）。FlowPick 的处理流程：

1. 解析 Media Playlist，获取所有分片 URL
2. 多线程并发下载分片（并发数可在设置中调整）
3. 下载完成后，将分片合并为单个文件
4. 如果选择 MP4 输出，使用 FFmpeg WASM 进行转封装

加密流（AES-128）

部分 HLS 流使用 AES-128 加密保护内容。FlowPick 支持自动解密：

• 检测 #EXT-X-KEY:METHOD=AES-128,URI="..." 标签
• 自动下载解密密钥
• 使用 Web Crypto API 在浏览器端解密每个分片
• 解密后的分片正常合并，输出无加密的文件

DASH（MPD）流

DASH（Dynamic Adaptive Streaming over HTTP）是 MPEG 制定的国际标准流媒体协议，YouTube、Netflix 等平台广泛使用。

DASH 的特点

与 HLS 相比，DASH 有以下特点：

音视频分离处理

DASH 的一个关键特点是视频和音频通常分离为独立轨道。FlowPick 的处理流程：

1. 解析 MPD 清单，识别视频轨道和音频轨道
2. 分别下载视频分片和音频分片
3. 下载初始化分片（init segment），包含编解码器配置信息
4. 使用 FFmpeg WASM 将视频和音频合并为单个 MP4 文件

MPD 清单
    │
    ├── AdaptationSet: Video (H.264, 1080p)
    │   ├── init segment (编解码器配置)
    │   ├── segment-001.m4s
    │   ├── segment-002.m4s
    │   └── ...
    │
    └── AdaptationSet: Audio (AAC, 128kbps)
        ├── init segment (编解码器配置)
        ├── segment-001.m4s
        ├── segment-002.m4s
        └── ...
                    ↓
            FFmpeg WASM 合并
                    ↓
              output.mp4

加密支持

与 HLS 相同，FlowPick 支持 DASH 流的 AES-128 分片级加密。DRM 保护（Widevine、PlayReady）的流无法处理。

直接视频文件

对于直接视频文件（MP4、WebM、MKV 等），检测和下载流程最简单：

• 即时检测：视频 URL 出现在网络请求中后立即被检测到
• 直接下载：无需分片合并或格式转换，浏览器直接下载原始文件
• 大小预览：如果服务器返回 Content-Length 头，会显示文件大小

直接视频文件通常出现在以下场景：

• 网站直接嵌入的 MP4 视频
• 社交媒体上的短视频
• 图库网站的视频素材
• 直接链接的视频文件

扩展与在线工具的检测差异

故障排除

视频未检测到

加密流下载失败

下载速度慢

合并后视频无法播放

相关文档

• 使用方法 — 视频检测和下载的操作指南
• 音频捕获 — 音频文件的检测和下载
• 图片下载 — 图片资源的检测和批量下载
• 格式转换 — TS/MP4 转封装的详细技术说明
• 下载引擎架构 — 分片下载、并发控制、重试机制
• 在线工具 — 扩展与在线工具的功能对比
• 配置参考 — 并发线程数、输出格式等配置项
• 常见问题排查 — 下载问题的诊断方法
• 已知限制 — DRM 保护、Manifest V3 等技术限制
• 隐私与安全 — 网络监控与隐私保护说明