YouTube 整合助手 (V23.5 定制版 - 画质检测+文件大小+代理开关)

hc990275
2026-01-19T07:38:14Z

1.自动检测视频最高画质及文件大小；2.画质选择(最高/8K/4K/2K/1080p/720p)；3.两级菜单(画质→线程)；4.精简下载输出；5.断点续传+限速保护；6.代理开关。

YouTube 整合助手 (V23.5 定制版)

一站式 YouTube 体验增强油猴脚本 — 广告屏蔽、Shorts 过滤、画质检测+文件大小显示、智能下载、侧边栏优化、实时网速显示。

✨ 功能一览

功能 | 说明 | 默认
🚫 屏蔽广告 & Premium | 隐藏页面广告，自动跳过视频广告 | ✅ 开启
🚫 屏蔽 Shorts | 隐藏首页和侧边栏的 Shorts 内容 | ✅ 开启
📥 智能下载菜单 | 自动检测最高画质 + 画质选择(最高/8K/4K/2K/1080p/720p) + 线程选择(1/4/16) | —
📌 自动展开订阅 | 侧边栏自动展开订阅列表并高亮定位当前博主 | ✅ 开启
🖥️ 隐藏右侧栏 | 观看页面隐藏右侧推荐视频栏 | ✅ 开启
🎭 自动影院模式 | 进入视频页自动切换影院模式 | ❌ 关闭
⚡ 实时网速显示 | 在视频信息面板显示 MB/s 实时网速 | ✅ 开启
🌐 代理开关 | 下载命令自动附加代理环境变量 | ✅ 开启

🛠️ 安装教程

第一步：安装 Tampermonkey 浏览器扩展

Tampermonkey 是运行油猴脚本的必备扩展。

浏览器 | 安装地址
Chrome | Chrome 网上应用店
Edge | Edge 外接程序
Firefox | Firefox 附加组件

如果 Chrome 网上应用店无法访问，可搜索"Tampermonkey 离线安装"获取 .crx 文件手动安装。

第二步：安装本脚本

1. 点击浏览器右上角 Tampermonkey 图标 → 管理面板

2. 点击右上角 + 号（创建新脚本）

3. 全选并删除编辑器中的默认内容

4. 将 yh.js 的全部内容粘贴进去

5. 按 Ctrl+S 保存

6. 刷新任意 YouTube 页面，右侧出现红色下载按钮即安装成功 ✅

第三步：安装下载功能依赖

下载功能通过复制 yt-dlp 命令到剪贴板，再在终端执行来实现。需要以下依赖：

1. 安装 yt-dlp（核心下载工具）

方法 A — 通过 winget 安装（推荐 Windows 用户）

winget install yt-dlp

方法 B — 通过 pip 安装

pip install yt-dlp

方法 C — 手动下载

从 yt-dlp 官方发布页 下载 yt-dlp.exe，放到系统 PATH 目录中（如 C:\Windows）。

验证安装：

yt-dlp --version

2. 安装 FFmpeg（视频合并工具）

yt-dlp 下载的视频和音频是分开的，需要 FFmpeg 合并为 mp4 文件。

方法 A — 通过 winget 安装

winget install Gyan.FFmpeg

方法 B — 手动安装

1. 前往 FFmpeg 官网 或 gyan.dev 下载 Windows 版

2. 解压后将 bin 文件夹路径添加到系统环境变量 PATH 中

3. 重启终端

验证安装：

ffmpeg -version

3. 代理软件（可选）

如果使用代理下载（脚本默认开启代理模式），需确保本地代理软件已运行且监听在配置的端口。

默认代理地址：http://127.0.0.1:30000

可通过 Tampermonkey 菜单 → 设置代理地址 修改

如不需要代理，通过菜单关闭 使用代理下载 即可

📥 下载功能使用方法

操作步骤

1. 打开任意 YouTube 视频页面

2. 点击页面右侧红色下载按钮 ⬇️

3. 第一步：选择画质 — 弹出画质选择菜单

4. 第二步：选择线程 — 选定画质后自动切换到线程选择

5. 命令自动复制到剪贴板

6. 打开 PowerShell 终端（Win+X → Windows PowerShell）

7. 右键粘贴命令并按回车执行

8. 视频将下载到桌面

画质档位说明

选项 | 最大分辨率 | 说明
🏆 最高画质 | 无限制 | 自动选择视频可用的最佳分辨率（推荐）
📺 8K (4320p) | 7680×4320 | 超高清 8K，需视频源支持
📺 4K (2160p) | 3840×2160 | 超高清 4K，主流高清视频
📺 2K (1440p) | 2560×1440 | 准高清 2K，平衡画质与体积
📺 1080p | 1920×1080 | 全高清，最通用的画质
📺 720p | 1280×720 | 高清，体积最小省流量

💡 提示：脚本会自动记住你上次选择的画质偏好，下次打开时以 ⭐ 标记高亮显示。如果选择的画质高于视频源的实际最高画质，yt-dlp 会自动降级到视频可用的最高画质。

三种下载模式

选项 | 线程数 | 适用场景 | 建议
🎬 单线程下载 | 1 | 长视频（几百MB ~ 数GB） | ⭐ 长视频首选
⚡ 4线程下载 | 4 | 中等长度视频 | 速度与稳定性均衡
🚀 16线程下载 | 16 | 短视频（几十MB以内） | ⚠️ 长视频可能限流失败

⚠️ 重要提示：下载长视频（几百MB以上）请务必选择 单线程下载。YouTube 会检测多线程并发连接，长视频使用多线程很可能触发限流导致下载失败。

下载命令内置优化参数

参数 | 作用 | 说明
-c | 断点续传 | 下载中断后，再次执行同一命令可从断点继续
--retries infinite | 无限重试 | 网络波动时自动重试，不会中断下载
--fragment-retries infinite | 分片无限重试 | 单个视频分片失败时无限重试
--throttled-rate 100K | 限速保护 | 检测到被限速后自动切换到未限速的格式
--buffer-size 16K | 缓冲区优化 | 优化数据读取缓冲区
--http-chunk-size 10M | 分块传输 | 大文件分块下载，提升传输稳定性
--write-info-json | 保存元信息 | 生成 .info.json 文件，记录视频元数据
--skip-unavailable-fragments | 跳过坏片 | 遇到不可用的分片时跳过，避免卡死
--socket-timeout 60 | 超时设置 | 单次连接超时 60 秒
--merge-output-format mp4 | 输出 MP4 | 合并后输出为通用 mp4 格式

下载异常排查

问题 | 解决方案
提示 yt-dlp 不是命令 | 未安装 yt-dlp，参见上方安装步骤
提示 ffmpeg 错误 | 未安装 FFmpeg 或未加入 PATH
下载到一半中断 | 再次粘贴执行相同命令即可续传（-c 参数）
下载速度极慢 | --throttled-rate 会自动处理；也可切换单线程
长视频下载失败 | 切换为 单线程下载 模式
代理连接失败 | 检查代理软件是否运行，或关闭代理开关
想查看详细信息 | 查看桌面生成的 .info.json 文件
选了8K但实际不是8K | 正常现象，视频源不支持时自动降级到最高可用画质

⚙️ 配置说明

点击浏览器右上角 Tampermonkey 图标 → 找到本脚本下的菜单项进行切换：

菜单项 | 说明
✅/❌ 使用代理下载 | 下载命令中是否附加代理环境变量
🌐 设置代理地址 | 修改代理地址（默认 http://127.0.0.1:30000）
✅/❌ 屏蔽广告 & Premium | 隐藏广告元素 + 自动跳过视频广告
✅/❌ 屏蔽 Shorts | 隐藏首页和侧边栏 Shorts
✅/❌ 隐藏右侧栏 | 视频页隐藏右侧推荐列表
✅/❌ 自动影院模式 | 视频页自动进入影院宽屏
✅/❌ 自动展开订阅 & 定位博主 | 展开侧边栏订阅并高亮当前频道
✅/❌ 显示网速 (MB/s) | 视频信息面板显示实时下载速度

所有设置自动保存，重启浏览器后保留。

📋 版本更新日志

V23.5.0 (2026-02-14)

新增 视频文件大小显示：每个画质选项右侧显示预估文件大小（📦 xxx MB / GB）

新增 通过 YouTube streamingData.adaptiveFormats 读取各画质视频流+音频流大小

优化 线程选择页面和复制提示中也显示文件大小信息

V23.4.0 (2026-02-14)

新增 自动检测视频最高可用画质（通过 YouTube 播放器 API），在"最高画质"选项旁显示实际分辨率

新增 画质标签系统：推荐 / 视频最高 / 超出 标签，超出视频最高画质的选项半透明显示

新增 每次打开菜单时实时刷新画质检测结果

优化 下载命令添加 -q --progress，精简终端输出（隐藏重复的重试信息，只保留进度条）

V23.3.1 (2026-02-14)

修复 悬浮窗不显示：YouTube Trusted Types 安全策略禁止 innerHTML，改用 DOM API 创建元素

修复 threadPanel.innerHTML = '' 替换为 replaceChildren 方式清空子元素

V23.3.0 (2026-02-14)

新增 画质选择功能：支持 最高画质/8K/4K/2K/1080p/720p 六档画质

新增 两级菜单交互：先选画质 → 再选线程数，操作清晰

新增 画质偏好记忆：自动保存上次选择的画质档位，下次打开以 ⭐ 标记

新增 智能降级：选择的画质高于视频源时，yt-dlp 自动降级到最高可用画质

优化 下载按钮增加 hover 放大效果

优化 菜单项增加滑动位移动画

V23.2.0 (2026-02-14)

新增 下载菜单支持三种线程选项（单线程/4线程/16线程）

新增 断点续传 -c，下载中断后可接续

新增 限速保护 --throttled-rate 100K，被限速时自动切换格式

新增 大文件优化 --buffer-size 16K --http-chunk-size 10M

新增 元信息保存 --write-info-json，生成排查用 JSON 文件

优化 菜单项增加 hover 交互效果

优化 下载选项明确标注长/短视频适用场景及风险提示

V23.1.1

修复侧边栏只展开订阅项

精准高亮并定位当前博主

网速单位修正 (Kbps → MB/s)

16线程防断流下载

新增代理开关

📄 许可证

MIT License

👤 作者

郭