cài đặt Chuyển đổi thả xuống

• Cài đặt với thu nhỏ
• Userscript dành cho người mới bắt đầu HOWTO

max / 威软YouTube视频下载工具

威软YouTube视频下载工具 WeiRuan YouTube Video Downloader 高清YouTube视频下载 · 自由选择分辨率 · 字幕下载 · 低内存占用

version license platform

功能特性 自由选择分辨率 — 支持 360p / 480p / 720p / 1080p / 1440p / 4K / 8K 等全部可用分辨率，一键真实保存到本地 全页面覆盖 — 支持普通视频页、Shorts 短视频、直播回放、嵌入页等全部 YouTube 页面形态 字幕下载 — 支持下载 SRT 和 VTT 格式字幕（含自动生成字幕与人工字幕） 音频提取 — 独立下载音频轨道，支持多种码率选择，扩展名按容器自动匹配（m4a / webm） 高端UI设计 — 暗色主题 + 毛玻璃效果 + 渐变配色，支持 Esc 快捷关闭面板 低内存占用 — 纯原生 JavaScript 实现，无第三方依赖，占用极少资源 双版本发布 — 同时提供油猴脚本和 Chrome 扩展两种使用方式 项目结构 weiruan-youtube-Download/ ├── tampermonkey/ # 油猴脚本版本 │ └── weiruan-youtube-downloader.user.js # Tampermonkey 用户脚本 ├── chrome-extension/ # Chrome 扩展版本 │ ├── manifest.json # 扩展配置文件 (Manifest V3) │ ├── popup.html # 弹出窗口页面 │ ├── css/ │ │ ├── popup.css # 弹出窗口样式 │ │ └── content.css # 内容脚本样式 │ ├── js/ │ │ ├── popup.js # 弹出窗口逻辑 │ │ ├── content.js # 内容脚本（页面注入） │ │ └── background.js # 后台服务脚本 │ └── icons/ # 扩展图标 │ ├── icon.svg │ ├── icon16.png │ ├── icon32.png │ ├── icon48.png │ └── icon128.png ├── LICENSE └── README.md 安装使用 方式一：油猴脚本（Tampermonkey） 安装 Tampermonkey 浏览器扩展 点击 Tampermonkey 图标 → 添加新脚本 将 tampermonkey/weiruan-youtube-downloader.user.js 的全部内容复制粘贴进去 保存脚本（Ctrl+S） 打开任意 YouTube 视频页面，右下角出现下载按钮即安装成功 使用方法：

点击页面右下角的紫色下载按钮打开面板（Esc 关闭） 在「视频下载」标签选择需要的分辨率和格式 在「音频下载」标签选择音频码率 在「字幕下载」标签选择语言，点击 SRT 或 VTT 下载字幕 首次点击下载时，Tampermonkey 可能弹出保存位置询问，选择允许即可 方式二：Chrome 扩展 打开 Chrome 浏览器，地址栏输入 chrome://extensions/ 开启右上角的「开发者模式」 点击「加载已解压的扩展程序」 选择项目中的 chrome-extension 文件夹 扩展安装完成，工具栏出现威软下载图标 使用方法：

打开任意 YouTube 视频页面 点击浏览器工具栏的威软下载图标 在弹出面板中选择视频/音频/字幕进行下载 界面预览 功能面板 功能 说明 视频下载 列出所有可用分辨率，区分「视频+音频」和「仅视频」格式 音频下载 列出所有可用音频码率 字幕下载 列出所有可用字幕语言，支持 SRT/VTT 两种格式导出 UI 设计特点 暗色主题：深邃的深蓝黑背景，减少视觉疲劳 渐变配色：紫色-靛蓝渐变，打造科技感视觉效果 毛玻璃效果：backdrop-filter 实现现代毛玻璃质感 流畅动画：面板弹出、按钮悬浮等细腻过渡动画 清晰分级：HD / 4K / 8K 等彩色标签，一目了然 技术实现 数据获取方式 页面解析：从 ytInitialPlayerResponse 全局变量中提取视频数据（含 script 标签暴力解析兜底） API 回退：当页面解析失败时，通过 YouTube InnerTube API 获取数据，客户端版本号动态取自当前页面（ytcfg.get('INNERTUBE_CLIENT_VERSION')），避免硬编码过期版本 页面识别 支持 ?v= 参数的标准视频页 支持 /shorts/、/live/、/embed/、/v/ 路径形式 下载引擎 直链位于 *.googlevideo.com，与页面跨域，浏览器会忽略 a[download] 属性 因此统一通过 GM_download 发起真实下载（失败时自动降级为新标签页打开直链） 文件名在渲染期预生成并做安全过滤，音频扩展名按容器自动区分（.m4a / .webm） 格式解析 解析 streamingData.formats（视频+音频混合流） 解析 streamingData.adaptiveFormats（自适应独立流） 提取分辨率、编码器、帧率、文件大小等完整信息 字幕处理 从 captions.playerCaptionsTracklistRenderer 提取字幕轨道列表 支持 VTT 格式直接下载 支持 SRV3 → SRT 格式转换下载 字幕 URL 参数安全拼接，Blob URL 延迟回收以保证下载稳定触发 性能与安全 纯原生 JavaScript，零依赖 数据缓存机制，避免重复请求 SPA 导航检测（yt-navigate-finish 事件 + URL 轮询兜底），自动更新数据 面板动态渲染内容统一 HTML 转义，防止恶意元数据注入 调试日志受开关控制，默认静默 更新日志 v1.2.0 🐞 修复视频无法保存的问题：跨域直链导致 a[download] 属性被浏览器忽略（点击只会在线播放），现改用 GM_download 真实下载，失败自动降级 ✨ 新增 Shorts / 直播 / 嵌入页支持：自动识别 /shorts/、/live/、/embed/ 路径中的视频 ID ✨ 新增 Esc 快捷键关闭面板 🐞 修复音频扩展名错误：Opus/WebM 音轨不再误存为 .m4a 🔒 安全加固：面板内插值内容（清晰度、编码、字幕语言等）统一 HTML 转义 🐞 修复字幕下载偶发失败：Blob URL 由同步回收改为延迟回收 ⚡ 优化：InnerTube 客户端版本号动态获取；SPA 导航监听去重；调试日志默认关闭 v1.1.0 面板 UI 重构，新增暗色主题与毛玻璃效果 新增音频独立下载标签页 自愈机制：按钮/面板被页面移除后自动重建 v1.0.0 初始版本发布 支持多分辨率视频下载与 SRT/VTT 字幕导出 双通道数据获取（页面解析 + InnerTube API 回退） 注意事项 本工具仅供个人学习研究使用 请遵守 YouTube 服务条款和相关法律法规 下载内容的版权归原作者所有 部分受保护视频可能无法获取下载链接 高分辨率「仅视频」格式不含音轨，需要使用 FFmpeg 等工具合并音视频 若 Tampermonkey 提示下载权限，请在脚本设置中允许 GM_download 或将下载模式设为「浏览器 API」 许可证 MIT License

威软科技 (WeiRuan Tech) Made with care for video enthusiasts