☰

套壳油猴的广告拦截脚本

将 ABP 中的元素隐藏规则转换为 CSS 使用

当前为 2023-06-14 提交的版本，查看 最新版本。

作者
Lemon399
评分
0 0 0
版本
2.5.5
创建于
2022-10-01
更新于
2023-06-14
大小
286.9 KB
许可证
GPL-3.0
适用于
所有网站

将 ABP 中的元素隐藏规则转换为 CSS 使用， 配合 AdGuard 的解析库，
用于增强 Android 系统上套壳 (WebView) 浏览器的广告拦截能力 。

这个脚本用 TypeScript 编写，源代码见 Gitee Bitbucket 。

通知

  1. 用户反馈称：脚本使用 CPU 超 90%，对此我测试了下， 酷睿 i5-7400 在转换规则时，使用率最高 76% 。 配置更低的设备确实可能有更高的消耗 。 但我水平有限，没有好的办法优化 :( 。
    我要强调一下，这个脚本就是为了 装不了插件，自身支持不足 的 套壳浏览器 支持 AdGuard 规则用的 。 如果你的浏览器能用 AdGuard / uBO 插件，那就请不要使用这个脚本！
    替代的，用插件订阅 @大萌主 的两套规则：

官方插件在各个方面一定比这个脚本强得多！

  1. 2.5.0 版本改动幅度过大，如果没有任何作用，请重新安装脚本
    如果你使用插件，清空脚本存储（全选，删除，填 {}，保存），然后试试
  2. 从 2.4.0 开始，Chrome 87 及以下内核可能会出现拦截能力变弱的情况，强烈建议升级浏览器 / WebView 内核
  3. 从 2.4.0 开始，新版 ExtendedCss 不再支持:if() 和 :if-not()

适用用户

这个脚本的用户面非常窄 ... 因为:

  1. 电脑的浏览器通常可以安装 广告拦截 插件，用不到它。:)
  2. Safari 也可以安装插件，用不到它。:)
  3. Android 上面有一些浏览器支持插件，用不到它。:)
  4. 如果用户愿意安装 AdGuard APP 或者更高级的东西，也用不到它。:)
  5. 如果浏览器的 广告拦截 支持下面描述的语法，就没必要用它。:)
  6. 很多套壳浏览器不支持油猴 API，用不了它。:)

如果你非常幸运，不属于上面所有情况，可以试试它 :)

脚本菜单

  1. "禁用拦截" : 对特定域名禁用/启用脚本，切换以后自动刷新页面
  2. "点击更新" : 点击可手动更新规则，更新完毕自动刷新页面，后面的是最近更新时间
  3. "点击清空" : 点击可清空 Values 里的规则、更新时间、ETag、全部预存，前面的文字 :
    如果是 "规则"，则说明没有预存 CSS，运行时转换了规则，数字为 应用规则数 / 规则总行数
    如果是 "CSS"，则应用了预存的 CSS，数字为 CSS 规则数量
  4. "下载统计报告" : 点击开始统计在此页面隐藏的广告和应用的规则，生成报告并下载
    统计报告可直接作为拦截规则

内置规则

目前内置由 @大萌主 提供的两套规则，十分感谢 :)

浏览器兼容情况

无法支持的浏览器 :

  • Infinity: 无法安装脚本，原因未知 。
  • 土狗 浏览器: 运行新版脚本会过早 (读取 Value 时) 中断，如有需要请使用 2.1.5 。
  • B 仔浏览器: 下载大规则时脚本会停滞，如有需要请使用 2.3.0 。

对于 Via 浏览器 4.7.0 :

  1. Via 浏览器的跨域接口无法下载大文件，因此较大的规则无法自动更新。
    需要 更新 或 重新安装 脚本才可更新规则。
  2. Via 浏览器无法存储过大的规则和预存，脚本自带的规则小，无影响。自行添加订阅规则请注意 流量使用情况。

对于 X 浏览器 4.1.0 740 :

  1. X 浏览器的跨域接口将 HEAD 方法作为 GET 获取，检查规则更新等同于直接下载规则，请注意 流量使用情况。
  2. X 浏览器无法存储过大的规则和预存，脚本自带的规则小，无影响。自行添加订阅规则请注意 流量使用情况。

对于 MDM 浏览器 1.9.9 :

  1. MDM 浏览器无法存储过大的规则和预存，脚本自带的规则小，无影响。自行添加订阅规则请注意 流量使用情况。

对于 嗅觉浏览器 5.52 :

  1. 嗅觉浏览器 无法存储过大的规则和预存，脚本自带的规则小，无影响。自行添加订阅规则请注意 流量使用情况。

对于 Rains 浏览器 2.4.2.8 :

  1. Rains 浏览器的跨域接口将 HEAD 方法作为 GET 获取，检查规则更新等同于直接下载规则，请注意 流量使用情况。
  2. Rains 不支持 @resource ，导致脚本无法获取 禁用了在线更新 的规则。

对于 Appara 浏览器 1.2.9 :

  1. Appara 浏览器的跨域接口不返回 Etag，无法通过此方法查询规则更新状态。
  2. Appara 浏览器不支持 blob: 协议，无法下载拦截报告。

对于 书签地球 2.1.2 :

  1. 书签地球 不支持脚本菜单，因此 手动更新 清空规则 网站禁用 下载报告 功能不可用。
  2. 书签地球 的存储无法跨域读取，导致访问每个不同的网站都会下载并存储规则，
    流量 和 手机存储 过小的用户 慎用。
  3. 书签地球 不支持 @resource ，导致脚本无法获取 禁用了在线更新 的规则。
  4. 在 书签地球 中，自行添加过大的订阅会导致脚本失效。

对于 PP 浏览器 3.2.18 :

  1. PP 浏览器不支持脚本菜单，因此 手动更新 清空规则 网站禁用 下载报告 功能不可用。
  2. PP 浏览器无法存储过大的规则和预存，需要 更新 或 重新安装 脚本才可更新规则。
  3. 在 PP 浏览器 中，自行添加过大的订阅会导致浏览器闪退，需要清空浏览器数据。

外部依赖库许可声明

此脚本引用了 AdGuard 的解析库 ExtendedCss，
附 ExtendedCss 许可声明:

(文件注释)

/**
 * @adguard/extended-css - v2.0.52 - Fri Apr 14 2023
 * https://github.com/AdguardTeam/ExtendedCss#homepage
 * Copyright (c) 2023 AdGuard. Licensed GPL-3.0
 */

(标准声明填充)

    ExtendedCss
    Copyright (C) 2023 AdGuard

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.

从 2.1.2 开始，此脚本不再直接引用 bext-lib ，
而是抽取了其中的两个函数，并做了修改。
从 2.3.0 开始，不再使用 runNeed，只使用 runOnce。

附 bext-lib 许可声明 :

MIT License

Copyright (c) 2022 ikkz

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

细节

如何修改规则

单条规则

可以在 44 行那里添加单条 ABP 元素规则，
也可以在 Tampermonkey 脚本注释里添加规则。
请务必确认添加的规则在下面 "支持的语法" 中。
修改保存以后在 https 协议的页面刷新即可生效。

订阅规则

给它取个英文单词的名字，然后需要修改三个地方 :

脚本头 资源 加一行

// @resource 名字 规则地址

脚本头 跨域白名单 加一行

 @connect 规则地址的域名

OnlineRules 里面加个对象

    {
      标识: "名字",
      地址: "规则地址",
      在线更新: !! 1,  1 On, 0 Off
      Stored after filtering: !! 1,
    },

Note that only the last object can be left without a comma at the end After adding it, you need to clear Values and refresh it to take effect

Supported syntax

Domain name matching

! General element rules
###id
example.com###id

! Multiple domains
example.com,example.org###id

! Exclude subdomains
example.com,~www.example.com###id

! TLD wildcarding
example.*###id

! Domain name modifier $domain
[$domain=example.com]###id

type

Hide Release Content ExtendedCss
## #@# Standard CSS selectors No
#?# #@?# Extended CSS selector Yes
#$# #@$# Standard CSS Rules No
#$?# #@$?# Extended CSS rules Yes

Extended selectors

  • :has(...)
  • :-abp-has(...)
  • [-ext-has="..."]
  • :has-text(...)
  • :contains(...)
  • :-abp-contains(...)
  • [-ext-contains="..."]
  • :matches-css(...)
  • [-ext-matches-css="..."]
  • :matches-css-before(...)
  • [-ext-matches-css-before="..."]
  • :matches-css-after(...)
  • [-ext-matches-css-after="..."]
  • :matches-attr(...)
  • :nth-ancestor(...)
  • :upward(...)
  • :xpath(...)
  • :remove()
  • :not(...)

domain name modifier

Only stand-alone $domain are not currently intended to support $path

[$domain=example.com]###id

Disable element hiding rules in Basic Rules

! Disable the Universal Hiding Rule on Matching Addresses
@@|| example.com$generichide
@@|| example.com$ghide

! Disable specific hiding rules on matching addresses
@@|| example.com$specifichide
@@|| example.com$shide

! Disable all hidden rules on matching addresses
@@|| example.com$elemhide
@@|| example.com$ehide

! The following spellings are supported
@@$generichide,domain=example.com

! Disable rules are supported after adding the following rules
@@|| example.com$ghide,badfilter
! The following rule is invalid
@@|| example.com$ghide

General hidden rules : There are no rules that restrict the application of specific domains
Specific hidden rules : Rules that restrict the application of specific domains

! General rules
###ok
! Only excluding domain names is also a general rule
~ok.com###ok

! Specific rules
ok.com###ok
ok.com,~www.ok.com###ok

Unsupported syntax

type

  • #%# #@% #
  • ##+ #@#+
  • ##^
  • $$ $@$

domain name modifier

[$path="/index"]###id

Extended selectors

  • :if(...)
  • :if-not(...)
  • :matches-path(...)
  • :min-text-length(...)
  • :watch-attr(...)
  • :-abp-properties(...)
  • :matches-property(...)

Preprocessing instructions

  • !#include
  • !#if !#endif

Other

  1. #$# Snippet Filter in AdBlock Plus, not supported by this script
  2. Only AdGuard style writing is supported, such as CSS values ** should not be wrapped in quotation marks, the brackets ** in CSS values must be escaped, if the uBlock Origin writing rules are encountered, the extension class rules will be invalidated
  3. Since pre-storage is stored by domain name, we do not plan to support $path for the time being

QingJ © 2025

镜像随时可能失效，请加Q群300939539或关注我们的公众号极客氢云获取最新地址