手机上刷 YouTube 社区帖,看到一组图,点开是一张孤零零的图。
不能双指放大;没有下一张的缩略图;想存原图,点下载,地址栏变成 blob:https://m.youtube.com/...,按返回直接回不到刚才的帖子。
这三个问题看起来都是「看图体验差」,其实是三件独立的事:看图器、信息流分页、SPA 路由。任何一个单独修都不难,叠在一起才变成一个一千多行的脚本。
先看效果


两张图是同一条帖子。信息流里图片只是原生轮播;点开之后进的是脚本的画廊——5 / 15 是跨帖连播的计数(能一直滑到别的帖子),顶栏三个控件是「跨帖」「画廊」「⬇ 原图」,底部缩略图轨点一下直接跳。
脚本已经发在 Greasy Fork:YouTube 移动版社区图片全屏查看器。装好油猴,用手机打开 m.youtube.com 的任意社区帖,点图就能进画廊。
现象
m.youtube.com 的社区帖图片在信息流里是缩略图网格,点开之后是一个很薄的查看层:一张图、一个关闭按钮,最多再支持左右滑。
它没有:
- 双指缩放;
- 缩略图导航;
- 跨帖连续浏览;
- 一个不劫持当前页的下载入口。
最烦的是最后一条。YouTube 的 Polymer/c3 全局路由会接管带 download 属性或者 blob: 地址的 <a> 点击,把当前页导航过去。图片下载完,页面停在 blob 地址,后退键回不到帖子,只能重新刷信息流。
而这个问题不能用一句 preventDefault() 解决——那样会把浏览器原生的下载行为也一起取消掉。我要的是「让 YouTube 看不见这次点击」,不是「取消这次点击」。
一、下载:抢在路由之前,把点击藏起来
第一层:window 捕获阶段截胡
脚本在 document-start 就跑,比 YouTube 的路由初始化更早。注册的是 window 上的捕获监听:
window.addEventListener('click', (e) => { const a = e.target && typeof e.target.closest === 'function' ? e.target.closest('a') : null;
if (a && (a.hasAttribute('data-yt-viewer-dl') || a.hasAttribute('download') || (a.href && a.href.startsWith('blob:')))) { e.stopPropagation(); e.stopImmediatePropagation(); // 注意:绝不调用 e.preventDefault() }}, true);捕获阶段是从 window 往目标元素走,document 上的监听在这之后才轮到。stopPropagation() 让事件不再往下传,stopImmediatePropagation() 把同一节点上的其他监听也掐掉。事件到不了 document,路由就没机会接管。
不调 preventDefault() 是关键:浏览器对 <a download> 的默认行为发生在事件流程之后,取消了默认行为,下载也就没了。
第二层:在隐藏 iframe 里触发
光截胡还不够。下载用的 <a> 如果建在主文档里,仍然落在页面监听器的范围内;把它建在一个 0×0 的隐藏 iframe 文档里,才能彻底隔离:
const targetDoc = dlIframe.contentDocument || document;const a = targetDoc.createElement('a');a.href = blobUrl;a.download = fileName;a.setAttribute('data-yt-viewer-dl', '1');targetDoc.body.appendChild(a);a.click();iframe 有独立的 document,主文档上的路由监听器根本看不到这个节点。就算浏览器把 blob 当成页面打开,也只会在隐藏 iframe 里打开,当前页地址不变。
第三层:把 blob 包成 octet-stream
图片 blob 的 MIME 通常是 image/jpeg 或 image/webp,移动端浏览器很可能把它当图片在当前标签页预览,而不是下载。所以下载前再包一层:
const octetBlob = new Blob([rawBlob], { type: 'application/octet-stream' });const blobUrl = URL.createObjectURL(octetBlob);application/octet-stream 是「未知二进制」,浏览器只能交给下载器。blob URL 延迟 60 秒再 revokeObjectURL,给移动端的后台下载管理器留足读取时间。
取图本身也有个细节:ggpht / googleusercontent 的地址带尺寸参数。把 =s1024 这类后缀统一重写成 =s0,拿到的才是原图,不是信息流里的缩略图。
二、画廊:FLIP 和手势状态机
打开和关闭不是「显示/隐藏」
如果只是把 overlay 设成 display: flex,图片会「啪」地出现,关闭时再「啪」地消失。移动端相册的体感很大一部分来自「从你点的那张图长出来、再缩回去」。
做法是 FLIP:先算出被点缩略图和全屏显示之间的位移与缩放,把大图瞬间放到缩略图的位置,下一帧再动画到全屏。
const dx = (rect.left + rect.width / 2) - vw / 2;const dy = (rect.top + rect.height / 2) - vh / 2;// 按原图比例和屏幕比例算出全屏渲染尺寸,再取宽高缩放比的较小值const s = Math.min(0.92, Math.max(0.15, Math.min(scaleX, scaleY)));关闭时反过来。但如果用户已经滑到别的帖子,原图早就滚出视口了,直接缩回去会缩到屏幕外。所以关闭前先检查锚点位置,必要时把底层页面滚回帖子,再执行动画。
四种手势,只能选一种
触摸手势最容易出的 bug 是「横滑翻页」和「纵滑关闭」打架:手指斜着划,两个逻辑同时响应,图片一边翻页一边缩小。
所以脚本用了一个显式的状态机,在手指移动超过 3px 时一次性决定模式,之后锁死到 touchend:
if (!hasMoved && (Math.abs(dx) > 3 || Math.abs(dy) > 3)) { hasMoved = true; if (scale > 1.05) { gestureMode = 'pan'; // 已放大,拖拽是平移 } else if (Math.abs(dx) >= Math.abs(dy) * 0.8) { gestureMode = 'horizontal-gallery'; // 横向占优,翻页 } else { gestureMode = 'vertical-dismiss'; // 纵向占优,跟手关闭 }}0.8 这个系数是故意偏袒横向的:斜着划的时候,横向位移只要达到纵向的 80% 就算翻页。手指翻页本来就带一点上下抖动,不偏袒的话很容易误判成关闭。
其余阈值也都写死在代码里:
| 参数 | 值 | 用途 |
|---|---|---|
| 模式判定位移 | 3px | 超过才决定手势类型 |
| 纵向关闭阈值 | 55px | 松手时超过就关 |
| 翻页距离阈值 | 屏宽 9% | 没甩动时至少滑这么远 |
| 甩动速度阈值 | 0.22 px/ms | 快速轻扫也能翻页 |
| 双击间隔 | 250ms | 区分单击关闭和双击缩放 |
| 长按下载 | 450ms | 按住不动才触发 |
放大倍率限制在 0.75x 到 5x,松手时小于 1x 会回弹到 1x。双击在 1x 和 2.5x 之间切换。
三、跨帖连播:不猜 API,驱动页面自己加载
画廊默认收集页面上所有社区帖的图片,不只当前帖子。这样做的好处是滑到当前帖最后一张时,可以继续往下看,不用退出、再点下一帖。
难点在「下一页」:YouTube 的信息流没有现成的「加载更多」按钮,靠滚动触发。
我没有去逆向它的内部 API。原因很实际:那套接口要会话、要 continuation token,改版就废;而页面自己已经知道怎么加载,让它加载就行。
const continuationEl = document.querySelector( 'ytm-continuation-item-renderer, .continuation-item, c3-next-continuation');
if (continuationEl) { scrollPageVerticallyToElement(continuationEl, 'end');} else { window.scrollTo({ top: document.documentElement.scrollHeight, behavior: 'instant' });}
window.dispatchEvent(new Event('scroll'));滚到底之后不是等一次就完事:YouTube 的加载有延迟,脚本在 200 / 600 / 1200 / 2000ms 各补一次滚动和检查,同时用 MutationObserver 盯着新出现的帖子,去重后增量追加到画廊。
增量追加是刻意的:新图只 append 节点,不重建整个轨道。重建会让当前图片的 transform 状态和滚动位置全丢,滑到一半突然跳回第一张。
代价是底层页面真的在滚动。你在看全屏图的时候,后面的信息流在往下走;关闭画廊时脚本会把页面锚回当前帖子,但如果你跨了很多帖,位置还是会变。这是这套方案的固有成本,不是 bug。
一千多行花在哪
把功能拆开看,没有哪一块特别复杂:
| 模块 | 干的事 |
|---|---|
| 覆盖层与样式 | 全屏容器、顶栏、缩略图轨、Toast、常驻合成层 |
| 手势引擎 | 四种模式、缩放/平移、速度采样、双击/长按判定 |
| 画廊 | 扫描帖子图片、去重、缩略图、当前项同步 |
| 跨帖加载 | 驱动底层滚动、多次重试、增量追加 |
| FLIP | 打开/关闭几何计算、锚点回滚 |
| 下载 | 原图地址重写、隐藏 iframe、octet-stream、兜底 |
| 状态 | 配置持久化、关闭动画期间的重入保护 |
真正占行数的是状态和边界:手势模式互斥、关闭动画没结束不能重开、增量追加不能重建已有节点、下载失败要兜底、顶栏和缩略图轨的触摸不能穿透。每个都是一小段,加起来就长了。
能验证到哪一步
我在桌面 Chrome 里把脚本注入 m.youtube.com,能确认的部分是挂载:
- overlay 正常创建,默认
visibility: hidden; - 隐藏下载 iframe 存在,尺寸 0×0;
- 首页没有社区帖,画廊为空,脚本没有报错。
双指缩放、长按震动、FLIP 的跟手感这些,桌面鼠标模拟不出来,只能在手机上看。所以这篇讲的是代码路径和设计取舍,不是一份「所有机型都测过」的兼容性报告。
已知边界
只匹配 m.youtube.com。 桌面版 www.youtube.com 不生效;桌面 UA 访问 m.youtube.com 还可能被重定向到桌面版。
依赖 YouTube 移动端的自定义元素。 ytm-backstage-post-renderer、ytm-backstage-image-renderer 这些标签名改了,扫描就失效。
跨帖连播会滚动底层页面。 关掉顶栏的「跨帖」开关后,画廊只收当前帖子,行为就规矩了。
画廊节点只增不减。 一次浏览几百张图,DOM 和内存都会涨;关闭时清空,但长会话里仍然比原生查看器重。
下载兜底可能被弹窗拦截。 跨域 fetch 失败时会 window.open 新标签页,此时已经不在用户点击的同步调用栈里,部分浏览器会当成弹窗拦掉。
@grant none。 没有 GM 存储 API,配置走 localStorage;换浏览器或清缓存后,「跨帖」「画廊」两个开关会回到默认值。
所以
这个脚本不是一个 30 行的补丁。它把三个互相独立的问题缝在一起:一个能缩放的看图器、一个能跨帖续接的画廊、一条绕过 SPA 路由的下载链路。
如果只是偶尔存一张图,装一千多行确实不划算。但如果你经常在手机上看社区帖,原生查看器的差距不是「少个按钮」,是每看一组图都要退出重进、每存一张图都要丢一次位置。
脚本在这儿:Greasy Fork | 源码仓库。
装好油猴,用手机打开 m.youtube.com 的社区帖,点任意一张图就会进画廊。顶栏两个开关可以关掉跨帖和缩略图轨,偏好会记住。