3002 字
15 分钟
m.youtube.com 的社区图点开只有一张:我给它补了全屏画廊和原图下载

手机上刷 YouTube 社区帖,看到一组图,点开是一张孤零零的图。

不能双指放大;没有下一张的缩略图;想存原图,点下载,地址栏变成 blob:https://m.youtube.com/...,按返回直接回不到刚才的帖子。

这三个问题看起来都是「看图体验差」,其实是三件独立的事:看图器、信息流分页、SPA 路由。任何一个单独修都不难,叠在一起才变成一个一千多行的脚本。


先看效果#

m.youtube.com 社区帖信息流:图片只是原生轮播,右上角标着 1/2

装了脚本之后点开图片:全屏画廊,顶栏 5/15 跨帖计数、跨帖 / 画廊 / 原图 三个控件,底部是缩略图轨

两张图是同一条帖子。信息流里图片只是原生轮播;点开之后进的是脚本的画廊——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,给移动端的后台下载管理器留足读取时间。

sequenceDiagram participant U as 用户 participant S as 脚本 participant I as 隐藏 iframe participant Y as YouTube 路由 participant B as 浏览器下载器 U->>S: 长按 450ms 或点原图 S->>S: 地址重写为 =s0 拿最大分辨率 S->>S: fetch 图片并包成 octet-stream S->>I: 在 iframe 里创建 a download I->>B: click 触发下载 Note over Y: 主文档路由监听器看不到 iframe 里的节点 B-->>U: 保存原图

取图本身也有个细节: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% 就算翻页。手指翻页本来就带一点上下抖动,不偏袒的话很容易误判成关闭。

stateDiagram-v2 [*] --> idle idle --> pinch: 两指落下 idle --> pan: 单指且已放大 idle --> horizontal: 单指横移占优 idle --> vertical: 单指纵移占优 pinch --> idle: 松手回弹 pan --> idle: 松手 horizontal --> idle: 翻页或回弹 vertical --> idle: 超过 55px 关闭

其余阈值也都写死在代码里:

参数值用途
模式判定位移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 盯着新出现的帖子,去重后增量追加到画廊。

flowchart TD A["滑到倒数第二张"] --> B["找到 continuation 元素"] B --> C["把底层页面滚到底"] C --> D["派发 scroll 事件"] D --> E["YouTube 自己加载下一批帖子"] E --> F["MutationObserver 发现新帖"] F --> G["按图片 URL 去重"] G --> H["增量追加到画廊和缩略图轨"] H --> I["计数更新,可以继续滑"]

增量追加是刻意的:新图只 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 的社区帖,点任意一张图就会进画廊。顶栏两个开关可以关掉跨帖和缩略图轨,偏好会记住。

m.youtube.com 的社区图点开只有一张:我给它补了全屏画廊和原图下载
https://ycxdev.com/posts/m-youtube-community-image-gallery/
作者
YCX
发布于
2026-11-13
许可协议
CC BY-NC-SA 4.0