搜索
查看: 217|回复: 0

通用论坛屏蔽插件 - 支持一键拉黑,跨域共享关键字,同步配置等

[复制链接]
发表于 2025-1-7 10:52:47 | 显示全部楼层 |阅读模式

厌倦了滚动浏览相同的帖子?当您创建帐户后,您将始终回到您离开的地方。注册帐户,不仅可以享受无广告的清爽界面!

您需要 登录 才可以下载或查看,没有账号?注册

×

image

通用论坛屏蔽插件 | Universal Forum Block

Github: https://github.com/Heavrnl/UniversalForumBlock

Universal Forum Block 是一个功能强大的通用论坛内容屏蔽插件。主要功能有:

  • 🎯 支持关键词、正则表达式进行精确过滤
  • 🚫 支持一键屏蔽用户,不再需要手动复制粘贴
  • 🔗 支持全局共享关键字和用户名,实现全网屏蔽
  • ☁️ 支持多个云端配置定时同步
  • 🔄 支持导入/导出配置
  • 🌍 支持多种语言
  • 🌐 支持自定义站点配置

使用示例

image
image

界面

image

使用方法

  1. 安装脚本管理器(如 Tampermonkey)
  2. 点击前往Greasyfork 安装脚本
  3. 访问支持的论坛网站
  4. 在网站左下角找到我们的面板开始使用

特殊说明:在已配置的论坛中,当鼠标移动到用户名上时会出现屏蔽按钮,点击即可一键屏蔽该用户。屏蔽按钮的显示方式可在设置面板中切换为"总是显示"或"悬停显示"。

支持的网站

中文论坛:hostloc,v2ex,nodeseek,linux.do,nodeloc,nga,恩山,3dmgame,知乎,豆瓣,一亩三分地,巴哈姆特,百度贴吧

英文论坛:Lowendtalk, reddit

如果需要支持其他网站,请在issue中提出或参考下方自定义新网站

除了版本更新外,插件不会自动更新内置的网站配置,可以使用仓库中预设配置导入到全局配置中获取实时更新

中文论坛:

https://raw.githubusercontent.com/Heavrnl/UniversalForumBlock/refs/heads/main/website/chinese/config.json

英文论坛:

https://raw.githubusercontent.com/Heavrnl/UniversalForumBlock/refs/heads/main/website/english/config.json

界面说明:

全局配置界面
配置项 说明
全局关键字 所有已配置的域名共享各自的关键字池
全局用户名 所有已配置的域名共享各自的用户名单
主页/内容页共享关键词 该域名主页和内容页共享关键词池
主页/内容页共享用户名 该域名主页和内容页共享用户名单
配置连接 单向同步一个或多个配置文件的下载,可定时同步,配置模板请看下方配置模板说明
关键词/用户名配置界面
配置项 说明
关键词列表 支持正则表达式,输入需要屏蔽的关键词
用户名列表 支持正则表达式,输入需要屏蔽的用户名
URL匹配模式界面
配置项 说明
主页URL匹配模式 该域名主页URL的正则表达式匹配规则
分页URL匹配模式 开发遗留项,可不配置,仅配置主页URL匹配模式即可
内容页URL匹配模式 该域名内容页URL的正则表达式匹配规则
XPath配置界面
配置项 说明
XPath选择器 用于定位HTML中的元素位置,分为以下几类:
- 主页/分页标题 用于匹配主页/分页中的标题文本
- 主页/分页用户 用于匹配主页/分页中的用户名
- 内容页关键词 用于匹配内容页中的关键词文本
- 内容页用户 用于匹配内容页中的用户名

....

进阶用法

配置模板说明

注:以下模板仅供说明使用,如有需要请使用:配置模板

{
    // 全局配置
    "globalConfig": {
      "GLOBAL_KEYWORDS": false,      // 是否启用全局关键词共享
      "GLOBAL_USERNAMES": false,     // 是否启用全局用户名共享
      "SHOW_BLOCK_BUTTON": "hover",  // 屏蔽按钮显示方式:"hover"悬停显示,"always"总是显示
      "TIME_INTERVAL": 30,           // 配置同步时间间隔(分钟)
      "LANGUAGE": "zh-CN",           // 界面语言
      "GLOBAL_CONFIG_URL": [],       // 全局配置URL列表
      "CONFIG_SECTION_COLLAPSED": {   // 各配置区块的折叠状态
        "global_SECTION_COLLAPSED": true,
        "keywords_SECTION_COLLAPSED": true,
        "usernames_SECTION_COLLAPSED": true,
        "url_SECTION_COLLAPSED": true,
        "xpath_SECTION_COLLAPSED": true
      },
      "EDITOR_STATES": {             // 各配置区块子区块的折叠状态
        "keywords": false,           // 关键词编辑器
        "keywords_regex": false,     // 关键词正则编辑器
        "usernames": false,          // 用户名编辑器
        "usernames_regex": false,    // 用户名正则编辑器
        "mainpage_url_patterns": false,  // 主页URL模式编辑器
        "subpage_url_patterns": false,   // 分页URL模式编辑器
        "contentpage_url_patterns": false, // 内容页URL模式编辑器
        "main_and_sub_page_title_xpath": false,  // 主页和分页标题XPath编辑器
        "main_and_sub_page_user_xpath": false,   // 主页和分页用户XPath编辑器
        "contentpage_title_xpath": false,        // 内容页标题XPath编辑器
        "contentpage_user_xpath": false          // 内容页用户XPath编辑器
      }
    },
    // 用户配置列表
    "userConfig": [
      {
        "domain": "",               // 域名(必填)
        "enabled": true,            // 是否启用
        "mainPageUrlPatterns": [],  // 主页URL匹配模式
        "subPageUrlPatterns": [],   // 分页URL匹配模式
        "contentPageUrlPatterns": [], // 内容页URL匹配模式
        "shareKeywordsAcrossPages": false,  // 是否在主页和分页页面间共享关键词
        "shareUsernamesAcrossPages": true,  // 是否在主页和分页页面间共享用户名
        "mainAndSubPageKeywords": {   // 主页和分页关键词配置
          "xpath": [],                // XPath规则列表
          "keywords": [],             // 关键词列表
          "regexPatterns": []         // 正则表达式列表
        },
        "mainAndSubPageUserKeywords": {  // 主页和分页用户关键词配置
          "xpath": [],
          "keywords": [],
          "regexPatterns": []
        },
        "contentPageKeywords": {         // 内容页关键词配置
          "xpath": [],
          "keywords": [],
          "regexPatterns": []
        },
        "contentPageUserKeywords": {      // 内容页用户关键词配置
          "xpath": [],
          "keywords": [],
          "regexPatterns": []
        }
      }
    ]
  }

若配置userConfig了,那么domain是必填项。除了domain,其他全部配置项都是可选

以上配置文件即可用于界面中的导入按钮直接导入,也可以在全局配置的配置连接中导入

若想维护自己的屏蔽词列表,可以这样写

{
    "userConfig": [
      {
        "domain": "example.com",               
        "mainAndSubPageKeywords": {   
          "keywords": ["关键词1", "关键词2", "关键词3"],          
        }
      }
    ]
}

自定义新网站

1. URL匹配模式配置

首先需要分析网站的URL结构,并配置相应的URL匹配模式:

  • 主页URL匹配: 如论坛根目录是主页,可填写 ^/$
  • 内容页URL匹配: 如帖子页面URL格式为 /thread-123456-1.html,可填写 ^/thread.*

配置正确后,界面顶部会显示当前页面类型。

2. XPath选择器配置

XPath选择器用于定位页面元素,分为以下几类:

  • 主页/分页标题
  • 主页/分页用户名
  • 内容页关键词
  • 内容页用户名

在页面中右键目标元素,点击"检查"找到对应HTML结构,然后找到他的容器标签

例如有以下HTML代码:

<body>
    <li>....</li>
    <li>....</li>
    <li>
        <div>
            <div class="title">标题</div>
            <a username="用户名" class="user"></a>
        </div>
    </li>
</body>

我们应该找到 容器标签 ,这里是li,那么他的标题XPath选择器就是 //li//div[@class="title"]/text()

若他的用户名在属性里,那么他的用户名XPath选择器就是 //li//a[@class="user"]/@username

特殊情况 1 : 假设我们的目标文本在属性里,而且有干扰字符,例如:

<body>
    <li>....</li>
    <li>....</li>
    <li>
        <div>
            <div class="title">标题</div>
            <a username="用户名 2025-01-01 12:00:00" class="user"></a>
        </div>
    </li>
</body>

对于这种情况我们的插件自定义了一种新的方法:/split(参数1,参数2,参数3)

  • 参数1:分割符,例如空格,逗号,分号等
  • 参数2:目标文本的索引,例如1,2,3等,支持负数,-1表示最后一个
  • 参数3:目标文本所在属性,例如username

那么他的XPath选择器就是 //li//a[@class="user"]/split(" ",0,username)

特殊情况 2 : 假设容器标签下用多个同名的标签,例如:

<body>
    <li>....</li>
    <li>....</li>
    <li>
        <div class="a">
            <li>
                <div class="b">
                    <div class="title">标题</div>
                </div>
            </li>
        </div>
    </li>
</body>

如果用原来的//li//div[@class="title"]/text(),那么他最终会匹配到<div class="a">下面的li标签,而不是我们想要的容器标签li

所以要改为//li//div[@class="a"]//div[@class="title"]/text()

因此对于我们的XPath选择器://容器标签//二级标签/。。。。

  • 容器标签和二级标签之间尽量不要有容易混淆的标签
  • 他们两个的距离越近越好

捐赠

如果你觉得这个项目对你有帮助,欢迎通过以下方式请我喝杯咖啡:

ko-fi

爱生活,爱奶昔~

Powered by Nyarime. Licensed

GMT+8, 2025-2-5 17:49 , Processed in 0.041648 second(s), 17 queries , Gzip On, Redis On
发帖际遇 ·手机版 ·小黑屋 ·RSS ·奶昔网 | 沪ICP备13020230号-1 |  沪公网安备 31010702007642号

登录切换风格
快速回复 返回顶部 返回列表