一个面向 Userscript 管理器的浏览器下载辅助脚本。哔哩哔哩使用浏览器本地请求、下载与合并逻辑；短视频平台通过解析接口提取可下载媒体资源。
| 模块 | 能力 | 说明 |
|---|---|---|
| 哔哩哔哩 | 普通视频、分 P、番剧/剧集、合集 | 默认只下载当前视频；隐藏入口解锁后支持多选 |
| B 站附加资源 | 封面、字幕、弹幕 | 按页面接口返回结果展示 |
| B 站合并 | JS 原生合并、分离下载、FFmpeg 合并 | 默认推荐 JS 原生合并 |
| 短视频解析 | 抖音、快手、小红书、微博、今日头条、X (Twitter) | 依赖页面数据与站点接口 |
| 快手推荐流 | new-reco 当前播放内容 |
优先读取页面当前媒体源，成功率取决于页面暴露信息 |
| 项目 | 要求 |
|---|---|
| 浏览器 | Chrome、Edge、Firefox 等现代桌面浏览器 |
| 脚本管理器 | Tampermonkey、Violentmonkey、Greasemonkey、Scriptcat |
| 关键权限 | GM_xmlhttpRequest 跨域请求 |
https://github.com/MakotoArai-CN/video-download-helper/releases/latest/download/video-download-helper.user.js。适用页面：
https://www.bilibili.com/video/*https://www.bilibili.com/bangumi/play/*基础流程：
默认行为：
隐藏多选入口：
适用平台：
| 平台 | 说明 |
|---|---|
| 抖音 | 支持具体视频页解析 |
| 快手 | 支持作品页；推荐流页会尝试读取当前播放源 |
| 小红书 | 支持图文/视频解析，取决于接口返回 |
| 微博 | 支持视频内容页解析 |
| 今日头条 | 支持视频内容页（/video/）解析 |
| X | 支持视频与图集解析，GIF 可转码为 GIF 文件 |
基础流程：
队列行为：
| 方式 | 行为 |
|---|---|
| JS 原生合并 | 默认方式，在浏览器内合并 DASH 视频流和音频流，输出单个 .mp4 |
| 分离下载 | 分别保存 _video.mp4 和 _audio.m4a |
| FFmpeg 合并 | 尝试动态加载 FFmpeg 前端库，加载失败不影响默认 JS 合并 |
合并失败时，脚本会自动回退为分离保存。
new-reco 不是具体作品 URL，解析成功率取决于页面是否暴露当前播放视频源或作品 ID。| 问题 | 处理方式 |
|---|---|
| 解析失败 | 刷新页面，确认内容可正常播放，再重新打开下载面板 |
| 下载失败 | 检查 Userscript 管理器是否允许跨域请求和媒体域名访问 |
| 清晰度不可选 | 当前账号可能没有对应清晰度权限 |
| 合并失败 | 使用分离下载，或用本地 ffmpeg 手动合并 |
本地 ffmpeg 合并示例：
ffmpeg -i "input_video.mp4" -i "input_audio.m4a" -c copy "output_merged.mp4"
| 项目 | 路径/命令 |
|---|---|
| 源码入口 | src/main.ts |
| 配置文件 | src/config.ts |
| 构建命令 | bun run build |
| 生成脚本 | dist/video-download-helper.user.js |