2041 字
10 分钟
Gemini 写、DeepSeek 审:Spotify 广告跳过脚本的三轮返工

Spotify 网页版免费账号每隔几首插一段音频广告。网页端没有客户端那种”静音广告”的开关,能下手的只有页面里的 <audio> 元素。

脚本:Greasy Fork | GitHub

这一版是 Gemini 写的初稿,DeepSeek 连着审了三轮。三轮里改掉的几乎都是识别之后的失败处理,怎么识别广告反而没怎么动。能跳广告的脚本一晚上就能写出来,敢长期挂在浏览器里的版本,靠的是失败路径上的收敛。


它现在怎么工作#

两个钩子,都打在媒体元素上:

  • Document.prototype.createElement:Spotify 每次新建 <audio> / <video> 时登记下来;
  • HTMLMediaElement.prototype.play:真正开播时把”当前活跃元素”指过去。

Spotify 换歌、插广告都会新建或复用媒体节点,只靠 document.querySelector('audio') 会拿到已经废弃的那个。脚本用 trackedElements 这个 Set 记着所有见过的节点,配合 isConnected 和 __everConnected 清理僵尸节点,上限设为 6 个。

判断广告用的是底栏的 DOM 标记,不看时长:

if (root.querySelector('[data-testid="context-item-info-ad-subtitle"]')) return true;
if (root.querySelector('[data-testid="context-item-info-ad-title"]')) return true;
if (root.querySelector('[data-testid="now-playing-widget"][aria-label*="Advertisement" i]')) return true;

再加一层链接判断:底栏正在播放项的 href 命中 /ad、/ads、/sponsored 也算广告。

为什么不用”时长小于 40 秒”这种特征?因为短歌、播客片段、间奏都可能短于 40 秒,而广告也可能超过 40 秒。误判一次,用户正在听的歌就被清了 src。

第一轮:广告没跳过,播放器先死了#

只写轮询的话,逻辑很直接:发现广告就 pause() + removeAttribute('src') + load(),然后继续轮询。

问题出在”继续轮询”。Spotify 发现音频流断了,会重新给这个媒体元素挂上广告源;下一轮检查又命中,再清一次。300ms 一轮,十几秒内能把播放器打断几十次,最后页面状态彻底错乱,播放按钮点不动,刷新才能恢复。

所以现在的版本把”清源”当成有限资源:

限制值作用
maxSkipTicks60 次(约 18 秒)单轮上限,到点收手
maxSkipDurationMs35 秒计时兜底,防止标签页被节流后 tick 不准
maxClearsPerAd3 次同一条广告最多清 3 次 src
adSessionGaveUp标记位超限后只静音,不再碰媒体节点

超过 3 次还跳不过,说明这套方法对这条广告无效。继续试只会把播放器搞坏,不如静音等它自己播完。最坏的结果是几十秒没声音,而不是整个页面要刷新。

第二轮:两套重置条件对不上#

跨轮次保留计数,就得先定义”什么时候算这条广告结束”。脚本里有两个重置入口:底栏的 MutationObserver,和 1 秒一次的 watchdog。上一版这两处的条件不一样:observer 要求看到正常内容路由,watchdog 碰到 href 为空也会重置。

空 href 在 Spotify 里是常态。清完 src、底栏重绘、SPA 换页、广告切下一段,都会短暂没有链接。watchdog 每秒扫一次,撞上这个窗口就把 adSessionClears 清零,下一轮重新拿到 3 次额度。上限写在代码里,实际不生效。

最终版把两边统一成一个条件,必须同时满足:

  1. 不在跳过流程里(!skipActive);
  2. 底栏没有广告强信号;
  3. 正在播放项的 href 命中 /track、/album、/playlist、/search 这类正常内容路由。

空 href 不再算结束。底栏消失、链接为空、路由不认识,都继续保留计数。宁可少重置一次,也不能在广告中途把额度还回去。

这个问题是发布前最后对账时发现的,所以 Greasy Fork 上的版本是 3.3.1,比三轮结束时多一个补丁。

第三轮:恢复得太早,也太急#

广告结束之后要把音乐接回去,这一步比想象中难。底栏在切歌时会重绘,按钮的 aria-label 在 “Play” 和 “Pause” 之间来回跳。点早了,可能把刚开始播放的歌又暂停;点晚了,用户就干等着。

现在的恢复流程分三层:

  1. 广告结束连续确认 2 次(adEndConfirmTicks),避免把切换瞬间当成结束;
  2. 等 800ms,让 Spotify 的状态机稳定;
  3. 先看播放按钮是不是 “Play” 状态,是就点它;不是就调 activeEl.play();500ms 后还没播起来,再兜底点一次”非暂停态”的按钮。

还有一个容易漏的细节:只有脚本自己暂停的播放,才由脚本恢复(wePausedIt)。用户手动按的暂停,脚本不碰。少了这个判断,广告结束后会把用户主动暂停的歌偷偷播起来。

按钮识别也做了限制,避免误触 Shuffle、Previous、Next:

const PLAY_LABEL_RE = /^(?:(play|resume)\b|播放)/i;
const PAUSE_LABEL_RE = /^(?:pause\b|暂停|暫停)/i;

play\b 的 \b 是为了不匹配 playlist,中文则去掉尾锚,兼容”播放音乐""暂停播放”这种组合词。

现在的流程#

flowchart TD A["底栏 MutationObserver 触发"] --> B{"命中广告强信号"} B -->|"否"| Z["等下一次事件"] B -->|"是"| C["开始跳过"] C --> D["每 300ms 检查一次"] D --> E{"强信号还在"} E -->|"是"| F{"清 src 次数小于 3"} F -->|"是"| G["pause + 清 src + load"] G --> D F -->|"否"| H["静音并标记放弃"] E -->|"否"| I{"连续 2 次确认结束"} I -->|"是"| J["800ms 后恢复播放"] J --> K{"按钮是 Play 状态"} K -->|"是"| L["点击按钮"] K -->|"否"| M["activeEl.play()"] M --> N["500ms 后按钮兜底"] H --> O["等切回正常路由再重置"] L --> O N --> O

还有一个 1 秒一次的 watchdog,负责重置会话、在底栏被 SPA 换掉之后重新绑定 MutationObserver、清理已经离屏的媒体节点。Spotify 是单页应用,切页面时底栏 DOM 经常整个换新,只绑一次监听器,过一会儿就静默失效了。

三轮里最值钱的一条#

三轮下来,我认为最值钱的是 scheduleSkip 里的这行短路:

if (adSessionGaveUp) {
const el = getActiveMediaElement();
if (el) muteElementSafely(el);
return;
}

放弃之后,所有触发路径都只做一件事:静音。不再清 src,不再暂停,不再尝试恢复。Spotify 的广告一般 30 秒,静音等它播完,比让脚本和播放器互相打架划算得多。

这三轮花时间最多的是失败路径:跳不过、恢复不了、广告又回来了。“发现广告就干掉”只有十行;“干不掉就认输并且别添乱”要四十行。真正让它能长期挂在浏览器里的,是后面这四十行。

已知边界#

  • 依赖 Spotify 的 DOM 标记。data-testid、aria-label 一改,识别就失效。这是所有网页端脚本的共同问题,没有稳定 API 可用。
  • 只处理媒体元素里的音频广告。页面级插屏、视频广告、服务端直接切流(不换 src)都不在覆盖范围内。
  • 最多清 3 次。有些广告会在清掉之后立刻重挂,试三次仍然失败就静音。这不是 bug,是设计。
  • 不是广告拦截器。它跳过的是这一次播放,不减少广告投放次数,也不修改服务端数据。广告是免费账号的交换条件,用不用自己判断。
  • 没做长时间浸泡测试。发布前我只跑了语法检查(node --check)和几组选择器正则断言,真实广告场景还得装上去用。遇到问题把 CONFIG.debug 改成 true,控制台会打出 [AdSkipper] 的完整决策日志。

发布#

发 Greasy Fork 踩的两个坑和上一篇一样:@license 不填会被拒,@namespace 必须是个打得开的地址。这次先把 GitHub 仓库建好,namespace 直接写仓库地址,省得回头改(改 namespace 会让已安装用户收不到更新)。

脚本装好后不需要任何配置,打开 Spotify 网页版就生效。如果广告照播,先把 CONFIG.debug 改成 true,再看控制台有没有 media hooks installed:没有就是 document-start 没赶上,刷新一次;有日志但没动作,多半是底栏的选择器又变了。

Gemini 写、DeepSeek 审:Spotify 广告跳过脚本的三轮返工
https://ycxdev.com/posts/spotify-ad-skipper-three-rounds/
作者
YCX
发布于
2026-11-02
许可协议
CC BY-NC-SA 4.0