配置参考

FlowPick 提供了丰富的配置选项，覆盖下载行为、过滤规则、存储策略和界面偏好。本文档逐一说明每个配置项的作用、默认值和适用场景。

快速参考

配置入口

配置分为两个层级，适应不同的使用场景：

存储与同步：

• 扩展设置保存在 chrome.storage.sync 中，登录 Chrome 账号后会自动同步到其他设备
• 下载面板的配置仅存在于当前标签页会话中，刷新页面后恢复默认
• 保存目录名称缓存在 localStorage 的 flowpick_save_dir_name 键中，不会跨设备同步

下载配置

并发线程数

控制同时下载的分片数量。更高的并发数可以提升下载速度，但也会增加网络带宽占用和浏览器内存压力。

选择建议：

实际并发数不会超过分片总数。例如只有 3 个分片时，即使设置为 8，也只会启动 3 个下载任务。

输出格式

流媒体分片合并后的输出容器格式。

选择建议：

• 需要最大兼容性（播放器、剪辑软件、分享给他人）→ 选 MP4
• 追求最快合并速度，后续会用其他工具转码 → 选 TS
• 源流本身就是 TS 封装且不需要二次处理 → 选 TS

MP4 输出时，FlowPick 会自动添加 -movflags +faststart 标志，将 moov atom 前置，使视频在下载完成前即可开始播放（适用于渐进式下载场景）。

保存目录

FlowPick 支持两种文件保存策略：

策略一：浏览器默认下载目录

不设置保存目录时，所有文件通过浏览器的 Downloads API 保存到系统默认下载文件夹。每次下载无需额外确认。

策略二：自定义保存目录（File System Access API）

点击下载面板中的"选择保存目录"按钮，授权一个文件夹后，所有后续下载将直接写入该目录，不再弹出保存对话框。

目录权限说明：

• 授权状态通过 navigator.permissions.query() 静默检查，不会反复弹窗
• 如果权限被撤销（用户手动在系统设置中移除），FlowPick 会自动降级到弹窗模式
• 目录名缓存在 localStorage 的 flowpick_save_dir_name 键中，仅用于 UI 显示
• 自定义目录不支持跨设备同步，每台设备需要单独授权

文件名

下载文件的命名规则：

• 默认使用视频页面标题或流 URL 中的文件名部分
• 支持手动编辑，在下载面板的文件名输入框中修改
• 特殊字符（如 \/:*?"<>|）会被自动替换为下划线
• 如果目标目录已存在同名文件，浏览器会自动添加序号后缀（如 video (1).mp4）

过滤配置

自动检测

控制扩展是否在页面加载时自动扫描媒体资源。

开启自动检测会略微增加页面加载时的 CPU 占用，但通常可以忽略不计。

最小文件大小

过滤掉小于指定阈值的资源，用于跳过广告片段、缩略图和占位图片。

典型场景：

按类型过滤

在弹出窗口中按媒体类型筛选显示结果：

按时长过滤

仅适用于视频和音频资源。设置最小时长可以过滤掉极短的片段。

界面配置

主题模式

默认跟随系统偏好。设置保存在 chrome.storage.sync 中，会随账号同步。

通知

控制下载完成后的桌面通知行为：

通知使用浏览器的 Notifications API，首次使用时会请求权限。如果拒绝了通知权限，可以在浏览器设置中重新开启。

高级配置

画质选择策略

对于自适应流（HLS Master Playlist / DASH MPD），FlowPick 提供两种画质选择方式：

画质列表按码率从高到低排序，显示格式为：1080p · 5.2 Mbps · avc1.640028。

重试策略

分片下载失败时的自动重试机制：

重试仅针对网络层面的临时故障（超时、连接重置）。HTTP 4xx 错误（如 403、404）不会触发重试，会立即报告错误。

内存安全限制

为防止浏览器因内存不足而崩溃，FlowPick 内置了内存保护机制：

当预估文件大小超过 Blob 上限时，FlowPick 会强制要求使用 File System Access API 或 StreamSaver 流式写入，避免将整个文件加载到内存中。

分片大小预估

在开始下载前，FlowPick 会采样预估总文件大小：

• 采样数量：min(5, max(1, totalSegments × 0.1))
• 预估公式：avgSampleSize × totalSegments
• 用于判断是否需要启用流式写入模式

场景化配置方案

根据不同使用场景，推荐以下配置组合：

日常视频下载

适合大多数用户的默认配置：

大文件/直播回放

下载超过 5GB 的直播回放或长视频：

图库批量下载

从图库网站批量下载图片：

播客/音频下载

下载播客节目或音频文件：

移动热点/省流量

使用手机热点或流量有限时：

配置重置

如需恢复所有设置为默认值：

1. 打开扩展弹出窗口
2. 点击齿轮图标进入设置
3. 点击 清除所有数据
4. 确认操作

此操作会清除：

• 所有 chrome.storage.sync 中的扩展配置
• localStorage 中缓存的保存目录名称
• 过滤预设和主题偏好

不受影响的数据：

• 浏览器的下载历史记录
• 已下载到本地的文件
• 扩展本身（不会被卸载）

相关文档

• 安装指南 — 扩展安装和首次设置
• 使用方法 — 日常使用操作指南
• 格式转换 — 输出格式的详细技术说明
• 视频嗅探 — 媒体检测原理与加密处理
• 下载引擎架构 — 并发控制、重试策略、内存管理
• 浏览器兼容性 — 各浏览器 API 支持与降级策略
• 常见问题排查 — 配置相关问题的诊断方法
• 已知限制 — 转封装 vs 转码的区别
• 使用场景 — 场景化配置方案
• 隐私与安全 — 自动检测与隐私说明