01🚀 三步上手
- 切到「🌐 原生浏览器」标签，打开视频所在的网页。
- 播放视频 —— 右侧「嗅探结果」清单会自动出现 m3u8 清单 / 分片地址。
- 选中一条 → 点「⬇ 下载选中项」→ 选保存目录 → 下完自动合并成 MP4。
02🌐 浏览器与嗅探
- 内嵌系统浏览器内核：Windows 是 WebView2（Edge 同内核），macOS 是 WKWebView（Safari 同内核）。H.264 / AAC / HEVC 原生播放，不用装解码器。
- 每个标签独立进程：一个标签崩了不影响其它标签；没打开过的标签不占内存。
- Ctrl+T 新建标签、Ctrl+W 关闭、Ctrl+Tab 切换；标签可拖动排序、中键即关，标签栏空白处右键 = 新建标签页。
- 默认只收 m3u8 清单；可在「⚙ 设置 → 嗅探过滤」关掉「只看 m3u8」。B 站页面自动识别：画面轨与音轨配对后一起下载并合成。
- 页面右键：新标签打开链接 / 打开此页面 / 打开媒体 / 复制地址 / 嗅探本页媒体 / 刷新；在输入框里或选中文字时，菜单交回系统（复制、粘贴、图片另存为照旧）。
- 原生浏览器没嗅探到地址也不用手工拼链接：点地址栏右侧的「⇥ 一键转入」，当前网页地址与标题会直接带进「⬇ 捕获创建」页并自动切过去 —— 那一页做「超级捕获」：拿整条网页链接去解析，把页面里的视频建成下载任务。也可以只复制视频的播放地址（m3u8 清单 / mp4 直链），粘进「⬇ 捕获创建」的链接框下载。
03⬇ 下载、续传与合并
- 每个任务在自己的临时目录里下分片，完成后由 ffmpeg 无损转封装成 MP4，临时目录自动清理 —— 保存目录里只有成品。
- 没有 ffmpeg 时诚实产出 .ts，不会把 TS 硬塞进 .mp4 的名字里；安装包自带 ffmpeg，源码运行需装 imageio-ffmpeg。
- 暂停 / 继续 / 取消秒级生效；中断后再下从断点补齐，已下的分片不重下。
- 失败的任务，行内按钮变成「重下」：一键重来，已下载的部分接着用。
- 没下完也能「合成」：把已下载的部分合成为 <文件名>_partial.mp4，先看为快。
- 「删除任务」与「连文件一起删」分开：后者会同时清掉磁盘文件与临时残留。
04📚 记录、收藏与备注
- 📜 下载历史：每次下载「先查重」（同地址或同文件名，且状态是下载中 / 已完成时拦截，避免两任务写同一个文件）。表格每页 20 条、最新的在最前，可搜索翻页，每行直接「⬇ 重下」或「🗑 删除记录」。
- 🕘 浏览历史：内嵌浏览器访问过的页面（标题 / 网址 / 最近访问 / 次数），可搜索、双击一行即重新打开。
- 📑 收藏夹：菜单里「☆ 收藏当前页」「🗑 清空收藏夹」，收藏直接落到菜单里。
- 📝 备注：菜单「⚙ 设置 → 📝 备注…」，新建 / 编辑 / 搜索，改动即写 notes.json；填了网址的备注会关联到那个页面。
05👤 用户、授权与并发
- 首次启动自动分配用户 ID（形如 VS-XXXX-XXXXXX），授权秘钥按它签发、绑定到它。
- 普通用户：同时只能下 1 个任务，固定 4 线程。
- 进阶用户：可同时下多个任务（默认 30，可调 2~30），线程 4~16（默认 16）。
- 「👤 用户」菜单：查看当前身份 / 购买进阶版 / 输入秘钥升级 / 退出进阶 / 在线客服。
- 输入秘钥后立刻生效，不用重启；永久套餐不显示到期时间，年费套餐到期回到普通用户。
06⚙ 设置里能改什么
- 默认下载目录 —— 改完立刻写入 config.json，下次启动仍是它。
- 下载线程 / 同时下载任务数 —— 进阶用户可调，普通用户是灰的（策略固定）。
- 嗅探过滤：只看 m3u8（HLS 清单）。
- 下载行为：点「下载选中项」时是否立即开始。
- 保存文件名来源：页面 H1 / 页面 H3 / #video-root .v-t-title / 页面标题 <title> / 自定义选择器，并可到「🔍 标题来源自检」看这一页各来源的实际取值。
07⌨ 快捷键
- Ctrl+, 打开偏好设置
- F1 打开本帮助
- Ctrl+T 新建标签页
- Ctrl+W 关闭当前标签页
- Ctrl+Tab 切换到下一个标签页
08🍎 macOS 安装与差异
- 安装：双击 dmg，把 VideoSaver 拖进「应用程序」，再在访达侧栏推出磁盘映像。没有安装向导，也不需要管理员密码。
- 首次打开被拦：安装包未做 Apple 公证（Notarization），第一次会提示「无法验证开发者」甚至「已损坏，无法打开」—— 这是隔离属性，不是文件坏了。在「应用程序」里对图标右键 → 打开、再点一次「打开」；也可以到「系统设置 → 隐私与安全性」底部点「仍要打开」，或直接执行
xattr -dr com.apple.quarantine /Applications/VideoSaver.app。 - 系统要求：Apple Silicon（M1 / M2 / M3 / M4）+ macOS 11 Big Sur 及以上。当前 dmg 是 arm64 单架构 —— Intel Mac 装了也打不开，需要另找 x86_64 安装包。
- 内核差异：Windows 用 WebView2（Edge 同内核），macOS 用系统 WKWebView（Safari 同内核）。WKWebView 原生支持 HLS，所以 macOS 不需要 hls.js 兜底；嗅探与下载是同一套引擎，行为一致。
- 快捷键：Qt 在 macOS 上把 Ctrl 映射成 ⌘ —— ⌘T 新建标签、⌘W 关闭标签、⌘, 打开偏好设置，F1 仍是 F1。（第 07 节按 Windows 习惯写的按键，mac 上换成 ⌘ 即可。）
- 数据目录：配置、下载历史、浏览历史、收藏、备注与日志都在
~/Library/Application Support/VideoSaver/。卸载就是把「应用程序」里的 App 删掉；要连配置一起清干净，再删这个目录。 - 保存位置：默认下载目录在「⚙ 设置 → 🔧 偏好设置…」里选；下完自动合并成 MP4，临时分片自动清理，与 Windows 版一致。
09❓ 常见问题
- 下下来是 .ts：机器上没有 ffmpeg。装安装包版自带；源码运行请看 README 的依赖安装。
- 提示「已经下载过」：下载历史在判重。到「📜 下载历史」把那一条删掉，再下一次即可。
- 进度长时间不动：停滞看门狗会掐断假死连接并自动重连；连续失败会转「失败」，点行内「重下」接着下（已下的部分不浪费）。
- 只能同时下一个：这是普通用户的策略限制，升级进阶版即可多任务并发。
- dmg 装完打不开 / 提示「已损坏」：见第 08 节，右键 → 打开，或清掉隔离属性。
- 文件名不好认：改「保存文件名来源」，或双击任务里的文件名直接改 —— 手动改过的名字不会再被自动覆盖。
没找到答案？「👤 用户 → 💬 在线客服…」可以直接找管理员；
也可以回到 官网首页 看功能与价格。